From 6ee7780972d2c37ccbf0279e5b7c21471afdba97 Mon Sep 17 00:00:00 2001
From: skacmazbelhaine <sherine.kacmaz.belhaine@gmail.com>
Date: Tue, 6 Jun 2023 15:51:20 +0200
Subject: [PATCH 001/366] Update local settings

---
 website/docs/admin_settings_local.md          |  27 +++++++++++++++++-
 .../assets/settings/settings_local_02.png     | Bin 0 -> 11181 bytes
 2 files changed, 26 insertions(+), 1 deletion(-)
 create mode 100644 website/docs/assets/settings/settings_local_02.png

diff --git a/website/docs/admin_settings_local.md b/website/docs/admin_settings_local.md
index b254beb53b..214615f442 100644
--- a/website/docs/admin_settings_local.md
+++ b/website/docs/admin_settings_local.md
@@ -11,18 +11,43 @@ OpenPype stores some of it's settings and configuration in local file system. Th
 
 **Local Settings** GUI can be started from the tray menu.
 
-![Local Settings](assets/settings/settings_local.png)
+![Local Settings](assets/settings/settings_local_02.png)
 
 ## Categories
 
+
+
 ### OpenPype Mongo URL
+The **Mongo URL** is the database URL given by your Studio. More details [here](https://openpype.io/docs/artist_getting_started#mongodb).
+
+<br>
 
 ### General
+**OpenPype Username** : enter your username (it can also take by default the computer session username). It signs your actions on **OpenPype**.
+
+<br>
+
+**Admin permissions** : on checked, no need to enter a password (if defined) to access to the **Admin** section.
+
+<br>
 
 ### Experimental tools
+Futur version of existing tools or new ones.
+
+<br>
+
+### Environments 
+**Environments** data of each software and there extra in-house needed to be loaded correctly. More details [here](https://openpype.io/docs/pype2/admin_config/#environments).
+
+<br>
 
 ### Applications
+Location of the softwares and there versions. More details [here](https://openpype.io/docs/admin_settings_system/#applications).
+
+<br>
 
 ### Project Settings
+The **Project Settings** allows to determine the root folder. More details [here](https://openpype.io/docs/module_site_sync/#project-settings).
+
 
 
diff --git a/website/docs/assets/settings/settings_local_02.png b/website/docs/assets/settings/settings_local_02.png
new file mode 100644
index 0000000000000000000000000000000000000000..725c3327472cae5dc6271586aa4a1de2495104ca
GIT binary patch
literal 11181
zcma)i1yodR8!d{6A|W9iI&?P-ImXb9gmkCG&^@RqAtfLkBOoB%ozgubBF#`kNOufz
zkDved-@oo!m$l9r=AAQV&N=V%>}T)&ykY99as+tPcvx6i1Pby{O)RV%GQcKu=O!>B
zWLx6|yxfJ!>$zcJ-6Q?I-M~soqXY(V-4#@1a93~N#upa|n=<kPhUo0HUbsJVc679I
zatGdGVLfxTGIO`GeCTE8Zu?M9K}Fq?#|jq<>mil`^of@D)Yh!e3xm~k-d)tl&8PBr
z6neQx9v;(GT98|i_Jk!)*u{ZW(u9;G>~^Y7R1x)V5^5{;$iZc6@q?M<L+NzYIJ;Ck
z#FR>kWy(<GQYX_~+be$4!IqudcOTu|x@RkPLL~O~hIx>#atorhb3tlHuXQy5g)JU3
z+2Fx>qb;}XD-YJ=j2osM3uY8p4)-5r%@;qoySE+_8>$WxpxGq7tV}1c;K5u_zcl58
z-=4S=>t<d+<Vb*LJlDxH=!a|?=l`Csr^Gz-<qO-U;;Tmb72FJt<vks$YgeDN&uK~Z
zdW{M;9j9l;@fjKL<=&XZ#YF<`F*?TkcRaUe>R*oYynb93Gah%=uHso)2%PuFLh=ds
zWxUOt5)}VgBmFcr3AKNC4^omIxp4#^i}q4>aM+AflTQBdVcuPw*QDiQ&TprFcAKV9
zF-P-qnHBN~lwhU8GTIl%3c+kvrW!UsPVb3k2)w>LaWQMS5fc+5;kkK-fWS)cc>Zfp
zb#=9Px>HAqqlbrwzrQ3gRb+Rx^!eIt`w9J+vWcOqq3biDW<IA?Mlq<CS5f2YVkgnn
z&NFBy(F$7U3ol#*HZZk1Gc%KifQyTYCiX0GU+xj^NXN(@E{5~o#=&VmT?{X6z4F!8
z9;-x3`^9<CL*N(hD2$VmlED6_WluBf<SZV>$VbtNRRmsNSs^eO48m`_J|Q8&&zzHl
zl=NhKmWG;|+V=A4vuD8nsYyw7{4_Qoalhlu&dyuJedv9fLb-I}`qTO{@tj(p#lc28
z8`Q>{6E(8%+_hsVk*pDCt8xGh%6jwWO;Qpi2oJvrn{?-Mdwcu0Z{Jc<sKdL=%U_5~
zNDTD%N6||a=oFgx?{z(<YBs*!FuC@1cR$?gVc_NDT-x(4E-r4pzTA1PsYyPNq@1g3
z65s)c!^=y{>q1*k!&^hc!!di&fwUwf`{5=Ri=APl&CSi@#WSl10ch>G4xfv?o`Hb@
zA4y|f-SLrZIU}BN#%Rfk0L=03?(W>&oY$PsDmu}G1=KieY+`afEU{BmWI2$)4Y^n#
z(&l)OI3NYwF^zLmxdYDC_RdvQC?TD=``Wih(LI%?XNj#BXvFmyqV;&{rAVsd<cgZA
zDtyNeHGo7CIb5L!5>ar>R*sUG@8Mc{D+jTLpP!$xF+Fi)WF#{a(~N&L5^{Y}!QP6Q
z-Ek5aJV6Cs=ReQ88B<bF(6A7$nxtHJT5su<g6c6Amw-Zjv=z`8fz}zp{ci@ztC^XP
zLOL|GwI9e=OmCGG7LM8qd7XOWmb_t!v)gN80wpVxpO)9u9M5{8E>m02QdbdyExEbY
z$P6jS^%>Gbd=_%G1W{E}11^|E!^mjXZ>RaBpR;sxt{Jlw4PnW`#wC<I{Pv6`Zhfm3
z^>gDWPc{8~qxEVdA_6~Os~_zO#KvdMbq~%~S-Iwl3RmE~r7h>cEC!sR6N_~=PESu?
zW8=<wFGUL443}{!L6K4?v>kkCG@7?*x4pn|y~c6+qar%hxkZeR@6(8FK|w)6aoYfI
z>%{@$`U1FUDVN2!P>|k5T1G}oRYp!K3WYK;G`#p#SW1l_+=e!t)ZF&Z9tY-ce0<fj
z5!*-FYuoVo^U*~suV)(hTCe3RxeRo5y*iG{lpvLswZ@K&Th<gCHdMo7U(fWr*EVP%
zFNIPpdZM;w>IKWPoxOkf3P#8>664&gIsIxW@b29^Vhs}$#H<qo4Nc*fFQLGEWiec?
z$%WI^KhE&;^)1pVoOL3)dslDMnU`+k`1shqdWufM^Ukd|3kzoHsuVB!t2tYbUm-#p
z8XISwYWpnThlk&@tjo`5-+d$^a*Vv%L}q1Y2fcX{DxayIG_+zBkB^UkdU@40pH*Hy
zvH;^UcpXl`TVjRFGkft^m$S@VHO~#LX&iWYB;oI`mtf>+JR3W@$zrhd657zvaK1TN
z`T8C@QrlcuoYB1fCIZ=v;)mH4Sb9+t3kOQK5v|OgOpLX%rA9^>q^-6MOL_eIVN_2*
z{%vZ?ckNpyE`vV|2IJ%4;1Ct9&Cj<hpGIV4%#DrZ=oAW555;rphOXs7F71F=c_{Ka
zp?~MZ#EU&o4RQ6ewxx@25SYUHL)krHj@IDE3q?g-k+O{OiU2m!)>V8=NXU@#OR$>k
z@9zf!BGK5FU0C>NccFuJnBzqF_U+s7!)yj15hTx+<LvD00?$Vg3B`|12iZx&LfK%i
zZXy!(8qQvmg9QcMoSanI$Vv?HoQ91W?P3PddwYA~F)jQ{mknK#(MRk3$JS(<$}AwB
z=utTQaKOB|!2q$^<%V{00n?T??e~+aN$w%9FOWQmg)J>tKzJElYz?PNcx}(*k8hX&
zj}^e?wY4=0WA8_NOnw{1wKv)I!_Uvpd+7ZlIu?XPMN7-~tuD8Kq@V@EUWH1Z&Id(9
zu3qG5N}bHONz#`V7jI3JTks@uii@8wgfPHYl5Kqb{D6GE%*x6F?t7iOu*z#^&N*Pi
zfNLOSXoU!JQP$D|N8?r1)JX5PVV?k(bOL}}7ZQS*M79(R2L}fi6%{dD%;SdF5+!h>
zdFJf#+&e`omU^ObOFrXw7@nlS34q#IZ!)uZHH?xj12>!6xIUbKR?Q!KibNO%wmPO<
z6Dg^w1@3iGnD}i~8@Muxg2AUbiN+~ONvC6_aE}2_)T<M_ctteo`Vxfzo&{0hX-9B_
zpTD43eFzh}ThhC3x9}=rs6y+&dPBbUxTXr3YCLcKeQ<CPh?uf<(c|72MyO@&H1HQq
zCsE^~v-vW1`BjXn3c*N8PtCsWRcqd~-^%Q9_1om#>uD?+IeA-{(>rl#DS?Y$C;YTa
z0S&{!{Izao#p%?`RHmbC*Us1vkyx)Jv9b2?vBrB2T%MLwV11MR>us+f7Vz1hJ*>89
z|FWR-ZBko^-4?Cq{kCA?*2O+<Tf~iTsM}b}R9GKuev^tndn}*7hyHv}C+LL1IK9nm
z-*@cd@3#egx37wf<R;8J2!8pzaLIF4R|e{Ia&g*eX<>1o(()jusEA3B(ZkfVt|c=p
z^s{CkBTDiy6qqTAjOpE}=BldY{`Zc77fbx9v%_dtgx_)B&z}Qy=~B_s`|94_b;woW
zWG)pI?gqVQrb>|0U5mKBh*2^pB}`gM3Kx0!PvL=pG41}OwW#6k;i&Dkq_y<1c+uAH
z+}w_g9og%4?Ck7eq9&=R9bNWPcn+6NPLn~Y%J&TdiWL2zH$k48MV&r(y|Mzx!#Xi1
z57JJTNmGYf684FS_j|dChlUax8Ze=~8wc?TWc`+!IRfGmoEG->;!o%x#UmMoj=N|6
z{39AxR?L~8g$Ny8zZQOFCUKalny#0#zG6ksMse}Wq~v4*Ek7$o3xVWO!SA0J7Eq_%
z@K)r>$X?vV!>iE{q9gZ{5G7_>!jOTb{?7}uQUQs)Uc?$Yp0ZA!EQtej)bx%{EmcBQ
zvP*_gDAe0KY0@DwQhRv#7b9csed5Fc?rEJO)zG7}i>)oAfPkR)ch35?HQAOWymVaa
zXGUW7($WS+=Ps7o+n?%K`#PzzKtdq`0`SayD{kjBPjEUmcE`=vpT6)#Gj#Uk-}N%T
z;35e>-kGlL))80cV#(5LezcqY#Mv;7jV$<u<8k-BA$t!)&DfNlB^_O7#Ms75d({wy
z_Whcb`@|i5#I9$nc`w5<FD_=f?1O@WNJy9J4Wovf80e^?LqqT1xz)dBOBf<3F8u^L
zG7^)XF7>P<`^=}_%*_1V)0X1TW!c$<+x`|h*7^=b_Unqi&C=N;Uo^XK;p_poYAd9R
zN=c7T&PYjd&#!iKH7{^5C^zIW@QAN*<Xm*A1JDCF=WD75??WA@-*>Z?7&iQfNk~Xb
zj%mnc{0e(2)1H*XmN<$&@`l;Bchf)w$A2{*9}#eIc`GX3V_bHP>*KnAi?v{BY|llK
zUY8~Q)|?WA5Bzy_=$8$Frrzmd1m;BQF|<LiV}8Eu@k2I_{^$ATS=pd1&ycUCOrXk1
ze{_G<ko7>na`cCRr(Ky)trtlQNk%LLh_t4Cs}JC`b-Q9sswMXZ2a(1xdjjR?s3;-I
zmGg7lH$iVkN1vO2)DWbet<W~7l;w##IX)yJigu;6#vBWP-bcM>%34VnkVc3K3oGPD
ztZ%QkZkN0df8N!V-$cK&F6d#BCz{i4G*mfjZQ>U=ZC*}1LN4=GHIEha?x`wNCsl=(
z1q9*=QCePrQLcoayfCq~AF=m<E+1i_PahF;b9sk`T7_luqC5gxuG%+?M$F60xL(#u
zSRZx2&{kef;I>#IHGzISk-3DL44&?V#TiFOhptd0GzY|`|Fo^F9F?L+F2}Fuh?)3m
z?_)}X9nc(S?CSIOc_|A5&`v&wPf{jRlNnyT_hTM1O<337d-gQccCTc5aBy?^hn9<3
ziyxeRm3byia(b(#Iz)_5C_R0QV%ZtJ=iRC9<oPqg$<t~0vz9EWhK5E<$HE;#yq_Bc
zER|hbo_U{{^c+1kzI@xtKwSSC)h`uI88VqWqNAfjPN&e3fGDp)NRlwHgoH&n=#7<L
z^H<YKTv82R->Hc;Z|GYG|NZ{<z{o1qypzh$Iz8z{VsxQY#42hp!{6@<d>^%}fF)Sj
zR0+~rpY6W2nyjy{?|kbWH1{DPfi~$&az^G&4jzuO7mf=Hv0uL~bnRDG`j++>=<7=g
zNapJFRB%a11sqAuZu@xY+LS6%Rc03~PLxMulWG@G+IfSCRg_iF{o!e)FwP!iP*BH9
zBDc0=w^d<%M<-PsC(i`gLMg8rIR9O!gQx1s@^XC42!Cmh-?=*-0*R`$(baIdG7oPi
zx3E~c`J}94J#CBz`?)eprMR@}gF=Uw8&#8=zRl&Cd*%)fgBi^yc{$9bO+i~Hm}>p>
z@zv3FYYNum!$SgsNV3G`o`R1621dw^7AUoPm&a31>F7In)wR^kQ1Tc%sK`g~_9E#h
zDYrKm47oPl>s1l?O9yp1IXGGB3-wdJ;av??HNoB1E=gZL@$v3jD7ZZF@UZgmU`9ks
zSe6CfaPowoRVaAP`@9kpOJ?rEk&9|VAE4fdgqS6<BD~$*9h&m<<3s5ujOe)Th{Ky!
z2zUBt(gw4#F0$oNEzC4HFe6R`Zf|2D1?kGlhC18w-Cw64?th)1UrT&I>c(o}P$`k7
zYGbb1p4Jz^*U{__amZFsQqf@TG`6)*Pi>S?qaeg1ESX5@TH0S(Q9dFV0_V)X97o-L
zH9dmrKH<j_Ap$DdKdaim7P?mkX7Sf2v~;7UtyrG|{;qp<!>3fJ(wlXx^B8TcHRt~-
zr~fFpKy3xeF0h~BuD!g}_Lpw0V>2m^x`#(tp;x?$G)WuVaPE0SM!X+{d-BuY)7l;n
zX@RxuL!kLQu6iojqxoh-L4l++Pfehysnakm-2=PI$+FQKBG3#O(B4%54y*K;Wn@f(
zBJ;1)iQ$rrgoFX;4-|wfDI-2TCN;ee?HUp+mzv5e(`$uGxVipoTSZCX*t@yfgFsNQ
z5~N`}cI+zicE-GVOjL*pzZ=(6H+3)p7WRUT4DNohJe(fSVI@RNKp17{(DK&eZrS!;
zr99VEt25#Sm%h@%?k)@jke)?XFc5Z+?+>E)$?(o<V%wvlN*WF#^^)z%%Q-;ilq^qq
zt}ooV`9C5MO3(-B9DnJZ(Ueio#sEJnyHD+DoA~t6C=_I{Vzak*Vtv#jeYSaWlFGH7
ztcPU&I0}Kiqiu6})yd=mTq(%j$?jg$%jPmZh`KBQqn_enwx%%oywouy_2&v0=>7Zm
zmf*o4qM07F04<@Y`ow~JMv+)o1sNIH$JjJVs`_^w3-@Ex+1wjvz-g}}OQZjSM+rWC
z9S4nwXqB`gvF6pUM&YgJr=1F=J#x^4d-r1b`2WVkN5N*4AV9gVZ?5U-XAZ2J>w&T&
z4#}#;w>vCYLzA5077Rg*cgyCkYG$1b{F1`to%wzdbZ2EXeXRQ2#d98^BL`hyx690I
zKlRpD=L<wfa1GeoST8PWEog>macFR4CzgsPK7#_2VlB%N1!{|2_JP5?jYMn1)&?iV
zX9pdwer|q`1udoZSqf|%bq9BcmzVSV9nT>W5(aNm&pe=}=B18w8ylN0^!ym|_D;g3
zr>*S|hZ-I2g!&ntkkK&gyN{vDf2E)|{lhk?8%XS1j{|A`LF$0O2O|D|g#Wyg9vXwp
zw(!oN$C~<!{{aWR+K5E#Nn*e9yP08w_3BFGH;4Qa?*BLF{|x=vx6QUU7FXZ9^;L~d
zy6SW(Cfga~-;!GNoP-6wmMH~D;IScUCpbZlW|%Sy4HcEaQSBduP}0Rrp>;K(y+rgg
z1_zVL`RtO+H$`4#JpU^<j#_T|!fY*l6_udy)}58{iFJ36lViQ2V}puIJ3DqW^S!Bq
z`ni298c`%D#{0VE4JpFEqD0<cP$yDn<D~M@n-4wo5?~Q&JrmU7?$>5R`jd%rQZ)v+
zzq<oSTs(GQ=_kUuK|q+B<eiQquP(HgTgM>aS=?7se^amOK8L%Bq3@oWSy;GfJjod0
z6Wz&xz)YPD4E%I-8vNib#l?coFB4ucZLe*w+wQPr6>Ub$Y%234N(f0#&G@rRNH7Wu
z_t_?ehd)mqN<gZO%Q|UTT7TxpKbYN-47l))oL!&rKzSx>)$l=3Grm4nwqw8Qa?p`(
zZdTLp$L^L(BU+oA3rn3p44`>Z_t7Qy2#Q-uHF@I1j7qw@t%b(R9(5x@<+j%?0p{hl
zTa{!Ks}PUVZ(p(f(s*>I(Ze5?KgTZKtT*&rcv^^DWzG5`FXL#GJ!W3W#%o2H3q&k(
zH9+5O%Bj}5l&g8_XlQtT@AUGrL+Pb8<y3`?%gUxt3}012MNv+Uk%Zv$q}KS31vavM
zN9K2QbVeSlG?fCQ<`&veGM*T4T8UeABtV=Ge=JYxHFueht{*Z49ImHLF1t3|J`Vw?
zBJvjj+KQP|)Kc%PXz=jIkIzcQ>2ajbf%`<ePWH2hAF$*wv4KFU=>=PBYc)y5;Dh-&
z8VK&;F`=@u@t#jJ^vCEZA|>`?dOE+jc;<*LHV#XkkofH8+Jv`{Uf4r0n1dsBfsaTU
z#*jDw1J69B3K{jOSRosT1wC!4+Rt3jDAutlpPF$x`B5dyMc&iZbsHB~Mn;ZA!^{l+
zDM^`n`v4RArLl1w?TSPq@4b7P2k=E-a&q#++l<70mK8sKFoi+e(XOZd($PqR$uSds
zX>sxIrb!zc3;;6$jG!<LSs6KQgh2KP&I*82VM+V@vBSgkjUBHAi2xMe62UZJrgaKs
z1xZh7L-B}laB;cG=Uu_jPBUPGi9v;gguYLXR92BBj&@ZPYHjcRCTEw@h{Vtr`zDTc
zVWDeFq^!;K48%jcT%U88Nk`hBe!3{Q43*4OKi&50(R?1Os1#0l>>EHcOwmje%nWKp
z7>QYxm&s;dj>@s(;q7y9C{hKFjzeC>5pBB$PCL~Wiw;7W5(h{~e}vt&56*0An)z`5
z$+IOHK<V&5g1Z=|#KtBiBskPcq!H$MTC?z|KH!O$&mqYXIPVs5kS%1)Iy|iUrf%ln
z#KD%-YF~~M&1%S@pd3LF_Ozasho31<F)o&*rC=%totIZlOk5FhSe4c8{};F7%;OrS
zq$wl|gVNE>8b|9g5q2fxdO?0uq74E;;+$M2ZCza*UETiA-#3dQwll7-t}@r{92M-$
zJ{5~lM&S4u;M{y-VIfE?EMzQ1y;@LMtGmTUbeDK$B6$5j5VNANwkDt%`^m+p_xqY=
zp=FhYA;_hj2@QS`kv;7(9&Xg=sHl*TreQ2Yp(a2e_^DNXUmP1gu@kDr5jBSaQZb;}
zHf^ECwBleOQKg{+iS2(ptp*UOsv6_&uUIb<3C<<kcx4;0V7QoRtg@KB?Q?3{fF(NG
z+gMe9q2)g@^EWy8LlJ->*g*0AwHbi7WQ6~Yw>!HB_*nDZ4&PR(u&~ajf8*`{KEodf
z-W7)Vp}ZLH-};^Si_vmXEn5d?B@()>nonI^zA~VsY7*LOgS0qe`Yah4Ex-^{!BsI~
zVZFk1y&cX^xFNE+c~#KmlTvnsZ%}z--j36|<k0WmHQPJQm#IX2{)KxO#Q-@;UHo&$
zMlS)NZUC*sdGts??{v8{eyX86gkf&gvtI3I+RC1f8iVwY*-;1tVxnpIZCc_(a&m4|
zbhE2WTw>x;NG%G`Nc}YrLf(bBi$8NT3L0J4*E4u)=sDju2e_?8MeZjT{ssm%b3eJt
z<!44_M@Qy{(5?dm@5g?f;vm~|l;}D-vVo$JpRXX>VQ84v?@;3pZxC?}2MIDpnkDVP
zSJ#(%US?&HiHYeM((4u`pI!VAOXDxg|9{}*O-OfFzOUbTW8-;jED5NVO;)ZuJDc(B
ziGRF6@Blh0DvCE<H&dO7nfdUL@V?TCwr>5*_W3!BUESxbCd;v@&`>km0rIZo%2k>6
zZw37o2??HCgUV)CI)ou{$?*vvzDNf&c-q1~SD2?he)up87S_4oo?hq}5&9u7j|DmW
zi<>-EHSc;YTTO-B?a7l2SqZma2W}QiabTnQmr`)TwJo}&q^89K-%^orosG4LIxUVq
zB$7BdI3g;N;sLs=z+6i)r_VAuRggV?B>X@CKLGx#Xw3dO8|c=X`I3^ke0G($AdnQd
z&)AfMjs!6QL9~6fc=*_gXJcNjuz5L{hereqW@F)a--F(sstz&>9YD)7Ek0(Roo(hx
z^n=5V*~rAxc}mAC%gR29QijQwiZXp!dePdt<;to`G2!4-GrhU7?QBp?Jv6u&oq<C{
zTn-0;%&8h@`3pr0J}Sm@<d!;{qBntu5eiP@Z6v{uLG_gAPmhJs1BVu&Ru4#sm97fM
zZ-e6c{C{aVeo7ie1BK@a^xkX532mJ#%c1qdh#yTen`=p5yynhc8CBnJYo0*WOgsLD
zi9U2i=PeKOHz{U1ynN!~C7QCo>5xZFq5$Q}$|{Act3X`bk6&-Sw+06Z9Ex=$0ADq}
z-?se4$F$g8?b;b~$qZON6F<K+m-5Ht_*{f=M5M~wJGUfxC~WW@G9-xz2}=Qh{FoA}
zWn`phWYo7%lo3*1?(!tG&6H2SsHU`_bM+uY>^TJona)S&)Ko!XL)-e-#arv^I~xpK
zT!YiijlSVe_q4mteR1EMJ^={v)7N~=>@KLeS-?h7Qc7J7e}vuE-D$a+$ea3h^~TK^
z(p|~NSckR$!p{Eb#r=b@{ZTF33EC~!lH$2v;Wr**{*oNO@g#ju5FlwVwKf1g{y%)Y
zi9w$^4ecv{h8SrYmX*{4IUTUuMh`0Z!ZsUlJuEyNACtjC7JNU3N%`W(!m}6y5G>+`
zkFk-xeFY#2#<}o2ItxCkh6ozd`B@Z#`CY7Rz1_K)ao)^VRAi}Veh5ud1$;0>mwgX^
za4FGTgJL*z@e+fl>c8JNh5AKL_kfD)j#JY&Lt`CKd~mAr3gA=$NS~j-e#_&cO4hHW
z<_QY{#2e<U>t$l^n$@v>df{F?yYiywkszbW!#ng02(oZ!e0+`p8QypkrV=^K<=xb{
zJ<Su>PrkC6YQP&E5wSJv2I=6#CE89;`B`Q3i;bgKka{IIS4b~;y<RLCu-|%nPv7N|
zx1z2$YY~*R^pVfmgWjAuI;KlCUn*L;`}in)Q3rxWTEb)4%xiJ^)es6r9wvi1*)s6s
zq+=*`t)B&|6@97hr3@+ezxiY0d>UMMQXaX0;Z9DzT&%C{Bco6!)Rb9n2Q!_pu53&z
zd408zk}_K9`^-o0E|8Ov_ca`iEJoiYbk&pnw}Vw@UcE|V<9@!lcr)0{)ve-1g0z&6
zJ<NM>{c+NbrPZ;{t{%Xqdh+$_?Pd+SYpcXYAmh9(2hpB#z3A8M&pIpw1;rzEYQa{?
zUwV5N7Rnc5_Ku^R5J=v5MSxy=ZcSxs$>QSd`S@py*)xK|C(X;J5<KsReyK;hsyVmz
zS?X|<N*6EmFCPv@IQ@DLVB(!yU&YgnNmzJzIQXbkxWY-XTj+lS!OI<IIcTp;W~Pfv
zL5G?oH60y$Tpx7tTU%)zEf28^7{7y0xADr5kk~~mjhBUsAw)3kdOv(|@gD?cYDzpb
z^z8k80mI->%3uPm#S;wnD23!bXlE=$-ESHlHJbM_=*=n6OpI0RaItP%VSoU>kq1G>
zm`gd=K!%v#+{RJx+dBm{i9J0%IB;#Pk2^3h;IJL}J~LI+(GibEhHJ>GMW~e&y|>Z>
z{G7BjQ-S2JtZ$hy8h}HF-}m|Z=g)5oiH&yeYrGMchEguNHryl?9u?Gj+$DoUUdSzJ
zC;$dG{VK@K%K^+#fRk*+PeU^y3-igqf&z-)YXLG@;;2}09rllZ>$xp6mMrh;e$zA>
z21HuQcYK1#DaWX{r*)6PVH2BagMEFRjM)~i+jUa2Ki7S8s;sT{DA6}~W>Gl`^nln@
zlr=E{SHmUr($TFJa$OS>&`)hebDu_rEv@tNm{@s+bH-`@)2OL-1&mb8Rr<8zy%4$X
zTw(n*Dj2W%AJQ_5#0Gwmi=7ATy3CEDFfx&OdolmDSy<R6H+PRM@KyDcJQCYbOwk(l
z3TxXG5Q_kSyc(JXx&eRS=zmDYiBO%hmgP0d7P1?!j{j~M%=<3c__yNCXS~|cz457)
z;2#Z#|D-SgT>agNfYm~Kcv6|--(xd4c#f<5<N=5bW-t!ttiFCSS!2YYN>Dty$8Ae5
zHjaeeAEs-9dN@!qUJPNB8d`Vvm7Mb^9{XNzuC4g`@jMJ1wl*S11goE!)WcT2SI2tV
zG?!|R0Ajq$e8e|V94z$RH(yHJUdct{%H!S!LHBlsGy++h5H6#qr}0I-Zcb_Ndp%zG
zK8W$bYh<%jkbW_t&E1(s?+p%alCYB<PVinI>xOS(;|O?sTH-!U;m2U5(6vcth|7Yx
zlB(y=`26*`IUpvi49JK*Lz*))ePl&xDDpVid4L-JFl)cUyjmRowGy_j*|WRLmN>x4
z%NeCx*sG>OVc_aoK^ZLO4cqxqm7BYwY^wJk@UxX-qSH4gb;3JrRsI4kkZ;Js%{3_D
zx?CK)crkZ%Bim&gxD0-<Bz2zVZJdMYDRDnv3{`Oc7d8d;!n{17%*%@wIy*T{YiQF`
z6z-q<&o&3pZOwv{f9tF8&a6w!adBb%ii;01v1`4deWgh=-p9oFUq`_Jd64nRXW}Yq
z*~{{SFSHnG8*V3V{5P%X9adCQP-vL>Ip$g4VJbxQuYmS%fCVclvRpR|3d#nw+;rf@
zX`j^wEkkL66bhU@N<l%vho2o0rmCbuMNb8kQyFM)n0#iays}oUhr5W7(7MN3R)^Gt
zG%9Iv(I4arP6wd+H9J6+03jM?dvYm(@x_&u?e;g`DKV0;6j)z0<k!%U<nbCWp~HV>
z$Rh_LmXnd8j_l5uyL$YZ&xMUxZ;(8EtOlH@num-I1591pmm8*&+8pKjj^S>5K9ays
zq{%Mrvx*ufr)4CMD0FlznaAIJ0)xJd2-Vl;@o8?UIwS*CyeM)y@i%r-HMusGW2LsK
z6FqRKogAM=ZEw+0Qqv134~A!(=Z!vr;&;HngJVzep8+05;Ccj0+}V%(slv)SL!cMw
zrRSI^v9hv)hgY*bS-An&OgcJQ5n=iR;=JDEp`pxyrn4`CfsSqnPg$%}EvADAGCZ3S
zpBhKSLY^+>N6$(+V{z%&I9oHvM;g;*FH9N1=?q|E;m9BpO97z4Dg;K2R1+s1j4uA2
z1kE3u;rnJA@*w+%dwb=9#u5+E5MX;k$3T&%pT;T0ZS{3&YkS>>QkIOmp&~ZN%_qRP
z6~#bG7oV2qy%qj$gij8NgHyl0&TbwP8rt5`p<R#^6XVkS6^4Cs=f*Z1BMAokzobBY
zgSqrX?E`4ZMZN*><V5S1ygY~&69?BIur>uKPM}|#+wt<u?{Ey7>79*?mi`91a8{YP
zxaY6y$?$ya?1%@>|Dal=Y-3TZm7B-Op_Nr`-{*zw?4|J+$aTA+`ET;F`oB8k^UuzF
zK#Q(o!1-_<-E171gJn|LkT~4>V~Kg40Iqa>GPBHIt~91JU?*~E(k5ebd%e*;pU#G8
z<}dGgT783pBJX{)Hqasw(NAKIE$i&`F80)+f3&n$cRPp}c;W|_Thqm#Obg|i9PAvY
zZ5zXmDiy-+8q}_E4f48s9w{pue$B@Q+~PLJP3I*HB~~i#KK{R%W`7V67-}mn>%aDk
zin1#+`Cr}IKVSN{uL5uWO%nbSPyhF^4myQRt?$j)w8-c|_zSSQTDyFp35j+W+q6#T
zdh|+VLquksdQXoTnVGe#9<z3Qj0c`+18s^3Mu|J<)Uqp%hax#Hx9*$urcdg>Ru6qf
zm^$GY`MqFop(y1_qO#hMP<E#*dG;q;F*O4do++u(ld^kQA_Q~P=lE&YC%h2;;bbvd
zYAUM0)#x3-4m{#v5oWe?@NZw*Gmq{VC-2~k_CGMyu@(>Mu-n-b_uO1+{9psBm~w!e
z<pnOlz(~nUsDi@6yL&?$MuR|VN7Dw}^9e4kjEK;xS3V}XKEx|`sDrwCO|8lRnPqD!
z^pu4W<l%n-m|#AVbGyC0ay<|g6$RhZd3Y<L`bBZ;+13bO`DvK56g7x!itZR#rv$02
z6d?VvcfI9@^zuB)kai>NdC-y@WI#B+aZmw=5GM~>gMhA^)c#NiRdA8W^bY)F#pDus
zy~ofhWiFxzEYLE(*l4{73G`)_7V)(ER?>K9J7I0YDh|3>W|jUnU4jES_Vd8I3D*lX
zJ~mo7PLttxoNscy;<dU#Q&_;E;^sD8tD6SaIItU9HJWXPw_cC*(3cb!L-gD@3`r6`
zMU^_&eMn5i?6jV5&41giuoBzUp|zeUN|5QZP2=QbA4X2w*St_+Atj#NipmY=rr;5>
zvC5sM8wOHA2HM%#X{qX&i`?1S*f1d%s+@G)IxWio-SmcBnLuKda%}98US21F*8+6C
zdHq+ZKzMhF6`5j{iW3pui|PRZ7H&$M#LTQLy*Zko#l15i<G>|Y(B*@(tIP4$zTv^s
z?hXv*99Q~mxiTr~3!Qd+5ki|I{;Ams`Zx+8g2o2Ah}6{CZxc)eL?+}_2BW|ATj|B&
zs?57HK*sBq3c0zpdT$-&Sjn=oY)_Y8wqEaIAeiy-(4_0rEsa_~`jGpk><LzlzP=dT
zkgMas>(fy+NZ{3Ep7G@gYH(;s>b&;}2+(||{_r}jEY0qSs3@h54&B>Z;zsAy6wN<=
z(m$Yjz(Da*AT=lmXV0Y^%5?wM!P$kn*_V!OFnrMxrvBj}*xTE^%HM#Un4dO^O-mkn
z?;d>^6MhJ3%P<qkT?CR9RQ^H|()t+s=+PsQ)O5g0Wo5<fukv!IpQx=3H2q*T8ULhF
zc<W#>2d&lv@mWsAy*fg{&sI`*B#+lbz5QE|t3H>IsO=fO<dn3*3I{(qKwV#*$|0oB
zIxTW?WZ(%`hk4N$+}kv~LIEcd$f|0itHWh>THRA$MfDy!$vWhY#q2@J^~Dk{z;&g(
zu1c@=L#)F+fMrMOE3SU4&oCz!(}k^gOip^=fYp}O6kq?6m1I=K4HgDpMpYO1I;=e!
zv#SK8Pp|o24PpD-p7`N&j0y0vo|JB7z{L_NpQg^yUaC~gFj5@{(!6#w?4N0_hrX)m
zaAE<yR`<rVAT|#$v#K_xPq0$Q9N&KzUaaiDbi|sFT>86Z@Q?K)fN~XSx+W^gru>GB
T+AsLMj#fcN6<YGt^v(YP0Y61g

literal 0
HcmV?d00001


From ce56b4efe0d16505450474e78ed36cb3e849dfc9 Mon Sep 17 00:00:00 2001
From: skacmazbelhaine <sherine.kacmaz.belhaine@gmail.com>
Date: Tue, 6 Jun 2023 15:51:32 +0200
Subject: [PATCH 002/366] Update local settings

---
 website/docs/admin_settings_local.md | 5 +----
 1 file changed, 1 insertion(+), 4 deletions(-)

diff --git a/website/docs/admin_settings_local.md b/website/docs/admin_settings_local.md
index 214615f442..222ee41515 100644
--- a/website/docs/admin_settings_local.md
+++ b/website/docs/admin_settings_local.md
@@ -36,7 +36,7 @@ Futur version of existing tools or new ones.
 
 <br>
 
-### Environments 
+### Environments
 **Environments** data of each software and there extra in-house needed to be loaded correctly. More details [here](https://openpype.io/docs/pype2/admin_config/#environments).
 
 <br>
@@ -48,6 +48,3 @@ Location of the softwares and there versions. More details [here](https://openpy
 
 ### Project Settings
 The **Project Settings** allows to determine the root folder. More details [here](https://openpype.io/docs/module_site_sync/#project-settings).
-
-
-

From ead57a2cafe2d451e99189d7d1aa94678a032033 Mon Sep 17 00:00:00 2001
From: skacmazbelhaine <sherine.kacmaz.belhaine@gmail.com>
Date: Tue, 6 Jun 2023 16:30:11 +0200
Subject: [PATCH 003/366] Update local settings

---
 website/docs/admin_settings_local.md          |   2 +-
 .../docs/assets/settings/settings_local.png   | Bin 7212 -> 11181 bytes
 .../assets/settings/settings_local_02.png     | Bin 11181 -> 0 bytes
 3 files changed, 1 insertion(+), 1 deletion(-)
 delete mode 100644 website/docs/assets/settings/settings_local_02.png

diff --git a/website/docs/admin_settings_local.md b/website/docs/admin_settings_local.md
index 222ee41515..177c32451b 100644
--- a/website/docs/admin_settings_local.md
+++ b/website/docs/admin_settings_local.md
@@ -11,7 +11,7 @@ OpenPype stores some of it's settings and configuration in local file system. Th
 
 **Local Settings** GUI can be started from the tray menu.
 
-![Local Settings](assets/settings/settings_local_02.png)
+![Local Settings](assets/settings/settings_local.png)
 
 ## Categories
 
diff --git a/website/docs/assets/settings/settings_local.png b/website/docs/assets/settings/settings_local.png
index d2cf1c920d07e98bb53570f6b76ef039e642e741..725c3327472cae5dc6271586aa4a1de2495104ca 100644
GIT binary patch
literal 11181
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
T+AsLMj#fcN6<YGt^v(YP0Y61g

literal 7212
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
Tu$%%u=7ApE)zK(Xvkdw#D_=3L

diff --git a/website/docs/assets/settings/settings_local_02.png b/website/docs/assets/settings/settings_local_02.png
deleted file mode 100644
index 725c3327472cae5dc6271586aa4a1de2495104ca..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 11181
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
T+AsLMj#fcN6<YGt^v(YP0Y61g


From fa133239f6d32c8e3a8f2be0e5bce994bbd4b4af Mon Sep 17 00:00:00 2001
From: skacmazbelhaine <sherine.kacmaz.belhaine@gmail.com>
Date: Wed, 7 Jun 2023 10:57:27 +0200
Subject: [PATCH 004/366] update after comments - local settings

---
 website/docs/admin_settings_local.md | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/website/docs/admin_settings_local.md b/website/docs/admin_settings_local.md
index 177c32451b..99e27731d0 100644
--- a/website/docs/admin_settings_local.md
+++ b/website/docs/admin_settings_local.md
@@ -18,7 +18,7 @@ OpenPype stores some of it's settings and configuration in local file system. Th
 
 
 ### OpenPype Mongo URL
-The **Mongo URL** is the database URL given by your Studio. More details [here](https://openpype.io/docs/artist_getting_started#mongodb).
+The **Mongo URL** is the database URL given by your Studio. More details [here](artist_getting_started#mongodb).
 
 <br>
 
@@ -37,14 +37,14 @@ Futur version of existing tools or new ones.
 <br>
 
 ### Environments
-**Environments** data of each software and there extra in-house needed to be loaded correctly. More details [here](https://openpype.io/docs/pype2/admin_config/#environments).
+Local replacement of the environment data of each software and additional internal data necessary to be loaded correctly.
 
 <br>
 
 ### Applications
-Location of the softwares and there versions. More details [here](https://openpype.io/docs/admin_settings_system/#applications).
+Local override of software paths and their versions. More details [here](admin_settings_system/#applications).
 
 <br>
 
 ### Project Settings
-The **Project Settings** allows to determine the root folder. More details [here](https://openpype.io/docs/module_site_sync/#project-settings).
+The **Project Settings** allows to determine the root folder. More details [here](module_site_sync/#local-settings).

From 85af2013726edb61a76faff9122a28cd1f1749dc Mon Sep 17 00:00:00 2001
From: skacmazbelhaine <sherine.kacmaz.belhaine@gmail.com>
Date: Thu, 8 Jun 2023 10:16:04 +0200
Subject: [PATCH 005/366] fix link path

---
 website/docs/admin_settings_local.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/website/docs/admin_settings_local.md b/website/docs/admin_settings_local.md
index 99e27731d0..33e0e374ce 100644
--- a/website/docs/admin_settings_local.md
+++ b/website/docs/admin_settings_local.md
@@ -18,7 +18,7 @@ OpenPype stores some of it's settings and configuration in local file system. Th
 
 
 ### OpenPype Mongo URL
-The **Mongo URL** is the database URL given by your Studio. More details [here](artist_getting_started#mongodb).
+The **Mongo URL** is the database URL given by your Studio. More details [here](artist_getting_started.md#mongodb).
 
 <br>
 
@@ -42,9 +42,9 @@ Local replacement of the environment data of each software and additional intern
 <br>
 
 ### Applications
-Local override of software paths and their versions. More details [here](admin_settings_system/#applications).
+Local override of software paths and their versions. More details [here](admin_settings_system.md#applications).
 
 <br>
 
 ### Project Settings
-The **Project Settings** allows to determine the root folder. More details [here](module_site_sync/#local-settings).
+The **Project Settings** allows to determine the root folder. More details [here](module_site_sync.md#local-settings).

From 54bdd152f6b3d67e240d487b264f1a674a75f876 Mon Sep 17 00:00:00 2001
From: skacmazbelhaine <sherine.kacmaz.belhaine@gmail.com>
Date: Thu, 8 Jun 2023 11:03:19 +0200
Subject: [PATCH 006/366] Correction of line breaks

---
 website/docs/admin_settings_local.md | 14 --------------
 1 file changed, 14 deletions(-)

diff --git a/website/docs/admin_settings_local.md b/website/docs/admin_settings_local.md
index 33e0e374ce..142238f14f 100644
--- a/website/docs/admin_settings_local.md
+++ b/website/docs/admin_settings_local.md
@@ -15,36 +15,22 @@ OpenPype stores some of it's settings and configuration in local file system. Th
 
 ## Categories
 
-
-
 ### OpenPype Mongo URL
 The **Mongo URL** is the database URL given by your Studio. More details [here](artist_getting_started.md#mongodb).
 
-<br>
-
 ### General
 **OpenPype Username** : enter your username (it can also take by default the computer session username). It signs your actions on **OpenPype**.
 
-<br>
-
 **Admin permissions** : on checked, no need to enter a password (if defined) to access to the **Admin** section.
 
-<br>
-
 ### Experimental tools
 Futur version of existing tools or new ones.
 
-<br>
-
 ### Environments
 Local replacement of the environment data of each software and additional internal data necessary to be loaded correctly.
 
-<br>
-
 ### Applications
 Local override of software paths and their versions. More details [here](admin_settings_system.md#applications).
 
-<br>
-
 ### Project Settings
 The **Project Settings** allows to determine the root folder. More details [here](module_site_sync.md#local-settings).

From aea1adab65ed3707a8963543313e0e6976082046 Mon Sep 17 00:00:00 2001
From: skacmazbelhaine <sherine.kacmaz.belhaine@gmail.com>
Date: Tue, 13 Jun 2023 17:03:51 +0200
Subject: [PATCH 007/366] update local settings for global settings PR

---
 website/docs/admin_settings_local.md | 10 ++++------
 1 file changed, 4 insertions(+), 6 deletions(-)

diff --git a/website/docs/admin_settings_local.md b/website/docs/admin_settings_local.md
index 142238f14f..8935b29fb5 100644
--- a/website/docs/admin_settings_local.md
+++ b/website/docs/admin_settings_local.md
@@ -19,18 +19,16 @@ OpenPype stores some of it's settings and configuration in local file system. Th
 The **Mongo URL** is the database URL given by your Studio. More details [here](artist_getting_started.md#mongodb).
 
 ### General
-**OpenPype Username** : enter your username (it can also take by default the computer session username). It signs your actions on **OpenPype**.
-
-**Admin permissions** : on checked, no need to enter a password (if defined) to access to the **Admin** section.
+**OpenPype Username** : enter your username (if not provided, it uses computer session username by default). This username is used to sign your actions on **OpenPype**, for example the "author" on a publish.
 
+**Admin permissions** : When enabled you do not need to enter a password (if defined in Studio Settings) to access to the **Admin** section.
 ### Experimental tools
-Futur version of existing tools or new ones.
-
+Future version of existing tools or new ones.
 ### Environments
 Local replacement of the environment data of each software and additional internal data necessary to be loaded correctly.
 
 ### Applications
-Local override of software paths and their versions. More details [here](admin_settings_system.md#applications).
+Local override of software executable paths for each version. More details [here](admin_settings_system.md#applications).
 
 ### Project Settings
 The **Project Settings** allows to determine the root folder. More details [here](module_site_sync.md#local-settings).

From 8dea1724f9d13c1bb11f6840fb73228eb95b7086 Mon Sep 17 00:00:00 2001
From: Toke Stuart Jepsen <tokejepsen@gmail.com>
Date: Fri, 23 Jun 2023 16:01:24 +0100
Subject: [PATCH 008/366] Check custom staging dir for Maya images folder.

---
 .../publish/validate_render_image_rule.py     | 25 ++++++++++++++++---
 1 file changed, 21 insertions(+), 4 deletions(-)

diff --git a/openpype/hosts/maya/plugins/publish/validate_render_image_rule.py b/openpype/hosts/maya/plugins/publish/validate_render_image_rule.py
index 78bb022785..96a57ee5d2 100644
--- a/openpype/hosts/maya/plugins/publish/validate_render_image_rule.py
+++ b/openpype/hosts/maya/plugins/publish/validate_render_image_rule.py
@@ -1,3 +1,5 @@
+import os
+
 from maya import cmds
 
 import pyblish.api
@@ -24,8 +26,12 @@ class ValidateRenderImageRule(pyblish.api.InstancePlugin):
 
     def process(self, instance):
 
-        required_images_rule = self.get_default_render_image_folder(instance)
-        current_images_rule = cmds.workspace(fileRuleEntry="images")
+        required_images_rule = os.path.normpath(
+            self.get_default_render_image_folder(self, instance)
+        )
+        current_images_rule = os.path.normpath(
+            cmds.workspace(fileRuleEntry="images")
+        )
 
         assert current_images_rule == required_images_rule, (
             "Invalid workspace `images` file rule value: '{}'. "
@@ -37,7 +43,9 @@ class ValidateRenderImageRule(pyblish.api.InstancePlugin):
     @classmethod
     def repair(cls, instance):
 
-        required_images_rule = cls.get_default_render_image_folder(instance)
+        required_images_rule = cls.get_default_render_image_folder(
+            cls, instance
+        )
         current_images_rule = cmds.workspace(fileRuleEntry="images")
 
         if current_images_rule != required_images_rule:
@@ -45,7 +53,16 @@ class ValidateRenderImageRule(pyblish.api.InstancePlugin):
             cmds.workspace(saveWorkspace=True)
 
     @staticmethod
-    def get_default_render_image_folder(instance):
+    def get_default_render_image_folder(cls, instance):
+        staging_dir = instance.data.get("stagingDir")
+        if staging_dir:
+            cls.log.debug(
+                "Staging dir found: \"{}\". Ignoring setting from "
+                "`project_settings/maya/RenderSettings/"
+                "default_render_image_folder`.".format(staging_dir)
+            )
+            return staging_dir
+
         return instance.context.data.get('project_settings')\
             .get('maya') \
             .get('RenderSettings') \

From 7dba2378844a2268ed1f8dc7f3cc6a8a3d47d02e Mon Sep 17 00:00:00 2001
From: Toke Stuart Jepsen <tokejepsen@gmail.com>
Date: Fri, 23 Jun 2023 16:21:45 +0100
Subject: [PATCH 009/366] Docs and setting note.

---
 .../schemas/schema_maya_render_settings.json       |  2 +-
 .../project_settings/settings_project_global.md    | 14 +++++++++-----
 2 files changed, 10 insertions(+), 6 deletions(-)

diff --git a/openpype/settings/entities/schemas/projects_schema/schemas/schema_maya_render_settings.json b/openpype/settings/entities/schemas/projects_schema/schemas/schema_maya_render_settings.json
index 636dfa114c..fc4e750e3b 100644
--- a/openpype/settings/entities/schemas/projects_schema/schemas/schema_maya_render_settings.json
+++ b/openpype/settings/entities/schemas/projects_schema/schemas/schema_maya_render_settings.json
@@ -12,7 +12,7 @@
         {
             "type": "text",
             "key": "default_render_image_folder",
-            "label": "Default render image folder"
+            "label": "Default render image folder. This setting can be\noverwritten by custom staging directory profile;\n\"project_settings/global/tools/publish\n/custom_staging_dir_profiles\"."
         },
         {
           "type": "boolean",
diff --git a/website/docs/project_settings/settings_project_global.md b/website/docs/project_settings/settings_project_global.md
index 5ddf247d98..e0481a8717 100644
--- a/website/docs/project_settings/settings_project_global.md
+++ b/website/docs/project_settings/settings_project_global.md
@@ -192,7 +192,7 @@ A profile may generate multiple outputs from a single input. Each output must de
         - Nuke extractor settings path: `project_settings/nuke/publish/ExtractReviewDataMov/outputs/baking/add_custom_tags`
     - Filtering by input length. Input may be video, sequence or single image. It is possible that `.mp4` should be created only when input is video or sequence and to create review `.png` when input is single frame. In some cases the output should be created even if it's single frame or multi frame input.
 
-    
+
 ### Extract Burnin
 
 Plugin is responsible for adding burnins into review representations.
@@ -226,13 +226,13 @@ A burnin profile may set multiple burnin outputs from one input. The burnin's na
 | **Bottom Centered** | Bottom center content. | str | "{username}" |
 | **Bottom Right** | Bottom right corner content. | str | "{frame_start}-{current_frame}-{frame_end}" |
 
-Each burnin profile can be configured with additional family filtering and can 
-add additional tags to the burnin representation, these can be configured under 
+Each burnin profile can be configured with additional family filtering and can
+add additional tags to the burnin representation, these can be configured under
 the profile's **Additional filtering** section.
 
 :::note Filename suffix
-The filename suffix is appended to filename of the source representation. For 
-example, if the source representation has suffix **"h264"** and the burnin 
+The filename suffix is appended to filename of the source representation. For
+example, if the source representation has suffix **"h264"** and the burnin
 suffix is **"client"** then the final suffix is **"h264_client"**.
 :::
 
@@ -343,6 +343,10 @@ One of the key advantages of this feature is that it allows users to choose the
 
 In some cases, these DCCs (Nuke, Houdini, Maya) automatically add a rendering path during the creation stage, which is then used in publishing. Creators and extractors of such DCCs need to use these profiles to fill paths in DCC's nodes to use this functionality.
 
+:::note
+Maya's setting `project_settings/maya/RenderSettings/default_render_image_folder` is be overwritten by the custom staging dir.
+:::
+
 The custom staging folder uses a path template configured in `project_anatomy/templates/others` with `transient` being a default example path that could be used. The template requires a 'folder' key for it to be usable as custom staging folder.
 
 ##### Known issues

From 49dc54c64767c62c7c71718cf047a489886f84ab Mon Sep 17 00:00:00 2001
From: Toke Stuart Jepsen <tokejepsen@gmail.com>
Date: Sun, 25 Jun 2023 15:37:52 +0100
Subject: [PATCH 010/366] Fix getting render paths.

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

diff --git a/openpype/hosts/maya/plugins/publish/collect_render.py b/openpype/hosts/maya/plugins/publish/collect_render.py
index babd494758..ac318dfbf7 100644
--- a/openpype/hosts/maya/plugins/publish/collect_render.py
+++ b/openpype/hosts/maya/plugins/publish/collect_render.py
@@ -201,10 +201,10 @@ class CollectMayaRender(pyblish.api.ContextPlugin):
 
             # append full path
             aov_dict = {}
-            default_render_file = context.data.get('project_settings')\
-                .get('maya')\
-                .get('RenderSettings')\
-                .get('default_render_image_folder') or ""
+            image_directory = os.path.join(
+                cmds.workspace(query=True, rootDirectory=True),
+                cmds.workspace(fileRuleEntry="images")
+            )
             # replace relative paths with absolute. Render products are
             # returned as list of dictionaries.
             publish_meta_path = None
@@ -212,8 +212,7 @@ class CollectMayaRender(pyblish.api.ContextPlugin):
                 full_paths = []
                 aov_first_key = list(aov.keys())[0]
                 for file in aov[aov_first_key]:
-                    full_path = os.path.join(workspace, default_render_file,
-                                             file)
+                    full_path = os.path.join(image_directory, file)
                     full_path = full_path.replace("\\", "/")
                     full_paths.append(full_path)
                     publish_meta_path = os.path.dirname(full_path)

From 96d796c4f5bdb51bd0461ad0f9a984019e48664c Mon Sep 17 00:00:00 2001
From: Toke Stuart Jepsen <tokejepsen@gmail.com>
Date: Sun, 25 Jun 2023 15:38:26 +0100
Subject: [PATCH 011/366] Account for custom staging directory persistentcy.

---
 .../hosts/maya/plugins/publish/extract_pointcache.py  |  3 ++-
 .../hosts/maya/plugins/publish/extract_proxy_abc.py   |  3 ++-
 .../hosts/maya/plugins/publish/extract_thumbnail.py   |  3 ++-
 .../deadline/plugins/publish/submit_publish_job.py    |  7 +++++--
 openpype/plugins/publish/collect_rendered_files.py    | 11 ++++++++---
 5 files changed, 19 insertions(+), 8 deletions(-)

diff --git a/openpype/hosts/maya/plugins/publish/extract_pointcache.py b/openpype/hosts/maya/plugins/publish/extract_pointcache.py
index f44c13767c..f0d914fd7a 100644
--- a/openpype/hosts/maya/plugins/publish/extract_pointcache.py
+++ b/openpype/hosts/maya/plugins/publish/extract_pointcache.py
@@ -108,7 +108,8 @@ class ExtractAlembic(publish.Extractor):
         }
         instance.data["representations"].append(representation)
 
-        instance.context.data["cleanupFullPaths"].append(path)
+        if not instance.data.get("stagingDir_persistent", False):
+            instance.context.data["cleanupFullPaths"].append(path)
 
         self.log.info("Extracted {} to {}".format(instance, dirname))
 
diff --git a/openpype/hosts/maya/plugins/publish/extract_proxy_abc.py b/openpype/hosts/maya/plugins/publish/extract_proxy_abc.py
index cf6351fdca..5894907795 100644
--- a/openpype/hosts/maya/plugins/publish/extract_proxy_abc.py
+++ b/openpype/hosts/maya/plugins/publish/extract_proxy_abc.py
@@ -80,7 +80,8 @@ class ExtractProxyAlembic(publish.Extractor):
         }
         instance.data["representations"].append(representation)
 
-        instance.context.data["cleanupFullPaths"].append(path)
+        if not instance.data.get("stagingDir_persistent", False):
+            instance.context.data["cleanupFullPaths"].append(path)
 
         self.log.info("Extracted {} to {}".format(instance, dirname))
         # remove the bounding box
diff --git a/openpype/hosts/maya/plugins/publish/extract_thumbnail.py b/openpype/hosts/maya/plugins/publish/extract_thumbnail.py
index 4160ac4cb2..3c7277121c 100644
--- a/openpype/hosts/maya/plugins/publish/extract_thumbnail.py
+++ b/openpype/hosts/maya/plugins/publish/extract_thumbnail.py
@@ -92,7 +92,8 @@ class ExtractThumbnail(publish.Extractor):
             "Create temp directory {} for thumbnail".format(dst_staging)
         )
         # Store new staging to cleanup paths
-        instance.context.data["cleanupFullPaths"].append(dst_staging)
+        if not instance.data.get("stagingDir_persistent", False):
+            instance.context.data["cleanupFullPaths"].append(dst_staging)
         filename = "{0}".format(instance.name)
         path = os.path.join(dst_staging, filename)
 
diff --git a/openpype/modules/deadline/plugins/publish/submit_publish_job.py b/openpype/modules/deadline/plugins/publish/submit_publish_job.py
index 69e9fb6449..7c29a68dc7 100644
--- a/openpype/modules/deadline/plugins/publish/submit_publish_job.py
+++ b/openpype/modules/deadline/plugins/publish/submit_publish_job.py
@@ -844,7 +844,7 @@ class ProcessSubmittedJobOnFarm(pyblish.api.InstancePlugin,
         do_not_add_review = False
         if data.get("review"):
             families.append("review")
-        elif data.get("review") == False:
+        elif data.get("review") is False:
             self.log.debug("Instance has review explicitly disabled.")
             do_not_add_review = True
 
@@ -872,7 +872,10 @@ class ProcessSubmittedJobOnFarm(pyblish.api.InstancePlugin,
             "useSequenceForReview": data.get("useSequenceForReview", True),
             # map inputVersions `ObjectId` -> `str` so json supports it
             "inputVersions": list(map(str, data.get("inputVersions", []))),
-            "colorspace": instance.data.get("colorspace")
+            "colorspace": instance.data.get("colorspace"),
+            "stagingDir_persistent": instance.data.get(
+                "stagingDir_persistent", False
+            )
         }
 
         # skip locking version if we are creating v01
diff --git a/openpype/plugins/publish/collect_rendered_files.py b/openpype/plugins/publish/collect_rendered_files.py
index 6c8d1e9ca5..4b95d8ac44 100644
--- a/openpype/plugins/publish/collect_rendered_files.py
+++ b/openpype/plugins/publish/collect_rendered_files.py
@@ -124,6 +124,8 @@ class CollectRenderedFiles(pyblish.api.ContextPlugin):
                 self.log.info(
                     f"Adding audio to instance: {instance.data['audio']}")
 
+            return instance.data.get("stagingDir_persistent", False)
+
     def process(self, context):
         self._context = context
 
@@ -160,9 +162,12 @@ class CollectRenderedFiles(pyblish.api.ContextPlugin):
                     legacy_io.Session.update(session_data)
                     os.environ.update(session_data)
                     session_is_set = True
-                self._process_path(data, anatomy)
-                context.data["cleanupFullPaths"].append(path)
-                context.data["cleanupEmptyDirs"].append(os.path.dirname(path))
+                staging_dir_persistent = self._process_path(data, anatomy)
+                if not staging_dir_persistent:
+                    context.data["cleanupFullPaths"].append(path)
+                    context.data["cleanupEmptyDirs"].append(
+                        os.path.dirname(path)
+                    )
         except Exception as e:
             self.log.error(e, exc_info=True)
             raise Exception("Error") from e

From 1f6934afbfc18816c53e64d9484405c34ac6c97f Mon Sep 17 00:00:00 2001
From: Toke Stuart Jepsen <tokejepsen@gmail.com>
Date: Mon, 26 Jun 2023 16:38:29 +0100
Subject: [PATCH 012/366] staticmethod > classmethod

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

diff --git a/openpype/hosts/maya/plugins/publish/validate_render_image_rule.py b/openpype/hosts/maya/plugins/publish/validate_render_image_rule.py
index 96a57ee5d2..fdb069ae43 100644
--- a/openpype/hosts/maya/plugins/publish/validate_render_image_rule.py
+++ b/openpype/hosts/maya/plugins/publish/validate_render_image_rule.py
@@ -52,7 +52,7 @@ class ValidateRenderImageRule(pyblish.api.InstancePlugin):
             cmds.workspace(fileRule=("images", required_images_rule))
             cmds.workspace(saveWorkspace=True)
 
-    @staticmethod
+    @classmethod
     def get_default_render_image_folder(cls, instance):
         staging_dir = instance.data.get("stagingDir")
         if staging_dir:

From 8492491f8382acc9372017f8ae316117e11cb6ca Mon Sep 17 00:00:00 2001
From: Toke Stuart Jepsen <tokejepsen@gmail.com>
Date: Tue, 27 Jun 2023 10:40:51 +0100
Subject: [PATCH 013/366] Fix get_default_render_image_folder arguments.

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

diff --git a/openpype/hosts/maya/plugins/publish/validate_render_image_rule.py b/openpype/hosts/maya/plugins/publish/validate_render_image_rule.py
index fdb069ae43..f8c848e08b 100644
--- a/openpype/hosts/maya/plugins/publish/validate_render_image_rule.py
+++ b/openpype/hosts/maya/plugins/publish/validate_render_image_rule.py
@@ -27,7 +27,7 @@ class ValidateRenderImageRule(pyblish.api.InstancePlugin):
     def process(self, instance):
 
         required_images_rule = os.path.normpath(
-            self.get_default_render_image_folder(self, instance)
+            self.get_default_render_image_folder(instance)
         )
         current_images_rule = os.path.normpath(
             cmds.workspace(fileRuleEntry="images")
@@ -43,9 +43,7 @@ class ValidateRenderImageRule(pyblish.api.InstancePlugin):
     @classmethod
     def repair(cls, instance):
 
-        required_images_rule = cls.get_default_render_image_folder(
-            cls, instance
-        )
+        required_images_rule = cls.get_default_render_image_folder(instance)
         current_images_rule = cmds.workspace(fileRuleEntry="images")
 
         if current_images_rule != required_images_rule:

From a6727800a36be1d8abb25f4ffe19858f552c0d94 Mon Sep 17 00:00:00 2001
From: Toke Stuart Jepsen <tokejepsen@gmail.com>
Date: Mon, 3 Jul 2023 12:10:39 +0100
Subject: [PATCH 014/366] Dont change thumbnail extraction

---
 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 3c7277121c..a4e5d4f8df 100644
--- a/openpype/hosts/maya/plugins/publish/extract_thumbnail.py
+++ b/openpype/hosts/maya/plugins/publish/extract_thumbnail.py
@@ -92,8 +92,6 @@ class ExtractThumbnail(publish.Extractor):
             "Create temp directory {} for thumbnail".format(dst_staging)
         )
         # Store new staging to cleanup paths
-        if not instance.data.get("stagingDir_persistent", False):
-            instance.context.data["cleanupFullPaths"].append(dst_staging)
         filename = "{0}".format(instance.name)
         path = os.path.join(dst_staging, filename)
 

From 5c44f12b37374b48c8f905834ff55e1bec99dee4 Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Thu, 6 Jul 2023 00:51:48 +0200
Subject: [PATCH 015/366] Cleanup code

- Refactor `get_file_node_files` because popping from `paths` by index should have been done in reversed order anyway. It's now changed to not need popping at all.
- Removed unused `RENDERER_NODE_TYPES` and if-branch which collected `node_attrs` list which was unused + collected members which was also done outside of the if branch and thus generated no extra data.
- Collected all materials from look set attributes at once instead of multiple queries
- Collected all file nodes in history from a single query instead of per type
- Restructured assignment of `instance.data["resources"]` to be more readable
- Cached `PXR_NODES` only ones (Note: plugin load is checked on discovery of the collect look plugin) instead of querying plugin load and its nodes per file node per attribute
- Removed some debug logs or combined some messages
---
 .../maya/plugins/publish/collect_look.py      | 192 ++++++------------
 1 file changed, 64 insertions(+), 128 deletions(-)

diff --git a/openpype/hosts/maya/plugins/publish/collect_look.py b/openpype/hosts/maya/plugins/publish/collect_look.py
index 287ddc228b..6832411190 100644
--- a/openpype/hosts/maya/plugins/publish/collect_look.py
+++ b/openpype/hosts/maya/plugins/publish/collect_look.py
@@ -17,11 +17,6 @@ SHAPE_ATTRS = ["castsShadows",
                "visibleInRefractions",
                "doubleSided",
                "opposite"]
-
-RENDERER_NODE_TYPES = [
-    # redshift
-    "RedshiftMeshParameters"
-]
 SHAPE_ATTRS = set(SHAPE_ATTRS)
 
 
@@ -36,12 +31,13 @@ def get_pxr_multitexture_file_attrs(node):
 
 
 FILE_NODES = {
+    # maya
     "file": "fileTextureName",
-
+    # arnold (mtoa)
     "aiImage": "filename",
-
+    # redshift
     "RedshiftNormalMap": "tex0",
-
+    # renderman
     "PxrBump": "filename",
     "PxrNormalMap": "filename",
     "PxrMultiTexture": get_pxr_multitexture_file_attrs,
@@ -49,6 +45,15 @@ FILE_NODES = {
     "PxrTexture": "filename"
 }
 
+# Cache pixar dependency node types so we can perform a type lookup against it
+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)
+    )
+
 
 def get_attributes(dictionary, attr, node=None):
     # type: (dict, str, str) -> list
@@ -232,20 +237,17 @@ def get_file_node_files(node):
 
     """
     paths = get_file_node_paths(node)
-    sequences = []
-    replaces = []
+
+    # For sequences get all files and filter to only existing files
+    result = []
     for index, path in enumerate(paths):
         if node_uses_image_sequence(node, path):
             glob_pattern = seq_to_glob(path)
-            sequences.extend(glob.glob(glob_pattern))
-            replaces.append(index)
+            result.extend(glob.glob(glob_pattern))
+        elif os.path.exists(path):
+            result.append(path)
 
-    for index in replaces:
-        paths.pop(index)
-
-    paths.extend(sequences)
-
-    return [p for p in paths if os.path.exists(p)]
+    return result
 
 
 class CollectLook(pyblish.api.InstancePlugin):
@@ -260,7 +262,7 @@ class CollectLook(pyblish.api.InstancePlugin):
     membership relations.
 
     Collects:
-        lookAttribtutes (list): Nodes in instance with their altered attributes
+        lookAttributes (list): Nodes in instance with their altered attributes
         lookSetRelations (list): Sets and their memberships
         lookSets (list): List of set names included in the look
 
@@ -285,76 +287,31 @@ class CollectLook(pyblish.api.InstancePlugin):
             instance: Instance to collect.
 
         """
-        self.log.info("Looking for look associations "
-                      "for %s" % instance.data['name'])
-
-        # Discover related object sets
-        self.log.info("Gathering sets ...")
-        sets = self.collect_sets(instance)
+        self.log.debug("Looking for look associations "
+                       "for %s" % instance.data['name'])
 
         # Lookup set (optimization)
         instance_lookup = set(cmds.ls(instance, long=True))
 
-        self.log.info("Gathering set relations ...")
-        # Ensure iteration happen in a list so we can remove keys from the
+        # Discover related object sets
+        self.log.debug("Gathering sets ...")
+        sets = self.collect_sets(instance)
+
+        # Ensure iteration happen in a list to allow removing keys from the
         # dict within the loop
-
-        # skipped types of attribute on render specific nodes
-        disabled_types = ["message", "TdataCompound"]
-
+        self.log.info("Gathering set relations ...")
         for obj_set in list(sets):
             self.log.debug("From {}".format(obj_set))
-
-            # if node is specified as renderer node type, it will be
-            # serialized with its attributes.
-            if cmds.nodeType(obj_set) in RENDERER_NODE_TYPES:
-                self.log.info("- {} is {}".format(
-                    obj_set, cmds.nodeType(obj_set)))
-
-                node_attrs = []
-
-                # serialize its attributes so they can be recreated on look
-                # load.
-                for attr in cmds.listAttr(obj_set):
-                    # skip publishedNodeInfo attributes as they break
-                    # getAttr() and we don't need them anyway
-                    if attr.startswith("publishedNodeInfo"):
-                        continue
-
-                    # skip attributes types defined in 'disabled_type' list
-                    if cmds.getAttr("{}.{}".format(obj_set, attr), type=True) in disabled_types:  # noqa
-                        continue
-
-                    node_attrs.append((
-                        attr,
-                        cmds.getAttr("{}.{}".format(obj_set, attr)),
-                        cmds.getAttr(
-                            "{}.{}".format(obj_set, attr), type=True)
-                    ))
-
-                for member in cmds.ls(
-                        cmds.sets(obj_set, query=True), long=True):
-                    member_data = self.collect_member_data(member,
-                                                           instance_lookup)
-                    if not member_data:
-                        continue
-
-                    # Add information of the node to the members list
-                    sets[obj_set]["members"].append(member_data)
-
             # Get all nodes of the current objectSet (shadingEngine)
             for member in cmds.ls(cmds.sets(obj_set, query=True), long=True):
                 member_data = self.collect_member_data(member,
                                                        instance_lookup)
-                if not member_data:
-                    continue
-
-                # Add information of the node to the members list
-                sets[obj_set]["members"].append(member_data)
+                if member_data:
+                    # Add information of the node to the members list
+                    sets[obj_set]["members"].append(member_data)
 
             # Remove sets that didn't have any members assigned in the end
             # Thus the data will be limited to only what we need.
-            self.log.info("obj_set {}".format(sets[obj_set]))
             if not sets[obj_set]["members"]:
                 self.log.info(
                     "Removing redundant set information: {}".format(obj_set))
@@ -382,35 +339,26 @@ class CollectLook(pyblish.api.InstancePlugin):
             "rman__displacement"
         ]
         if look_sets:
-            materials = []
+            self.log.debug("Found look sets:\n{}".format(look_sets))
 
+            # Get all material attrs for all look sets to retrieve their inputs
+            existing_attrs = []
             for look in look_sets:
-                for at in shader_attrs:
-                    try:
-                        con = cmds.listConnections("{}.{}".format(look, at))
-                    except ValueError:
-                        # skip attributes that are invalid in current
-                        # context. For example in the case where
-                        # Arnold is not enabled.
-                        continue
-                    if con:
-                        materials.extend(con)
+                for attr in shader_attrs:
+                    if cmds.attributeQuery(attr, node=look_sets, exists=True):
+                        existing_attrs.append("{}.{}".format(look, attr))
+            materials = cmds.listConnections(existing_attrs,
+                                             source=True,
+                                             destination=False) or []
+            self.log.debug("Found materials:\n{}".format(materials))
 
-            self.log.info("Found materials:\n{}".format(materials))
-
-            self.log.info("Found the following sets:\n{}".format(look_sets))
             # Get the entire node chain of the look sets
-            # history = cmds.listHistory(look_sets)
-            history = []
-            for material in materials:
-                history.extend(cmds.listHistory(material, ac=True))
-
-            # handle VrayPluginNodeMtl node - see #1397
-            vray_plugin_nodes = cmds.ls(
-                history, type="VRayPluginNodeMtl", long=True)
-            for vray_node in vray_plugin_nodes:
-                history.extend(cmds.listHistory(vray_node, ac=True))
+            # history = cmds.listHistory(look_sets, allConnections=True)
+            history = cmds.listHistory(materials, allConnections=True)
 
+            # Since we retrieved history only of the connected materials
+            # connected to the look sets above we now add direct history
+            # for some of the look sets directly
             # handling render attribute sets
             render_set_types = [
                 "VRayDisplacement",
@@ -428,20 +376,17 @@ class CollectLook(pyblish.api.InstancePlugin):
                     or []
                 )
 
-            all_supported_nodes = FILE_NODES.keys()
-            files = []
-            for node_type in all_supported_nodes:
-                files.extend(cmds.ls(history, type=node_type, long=True))
+            files = cmds.ls(history,
+                            type=list(FILE_NODES.keys()),
+                            long=True)
 
-        self.log.info("Collected file nodes:\n{}".format(files))
+        self.log.info("Collected file nodes:{}".format(files))
         # Collect textures if any file nodes are found
-        instance.data["resources"] = []
-        for n in files:
-            for res in self.collect_resources(n):
-                instance.data["resources"].append(res)
-
-        self.log.info("Collected resources: {}".format(
-            instance.data["resources"]))
+        resources = []
+        for node in files:
+            resources.extend(self.collect_resources(node))
+        instance.data["resources"] = resources
+        self.log.debug("Collected resources: {}".format(resources))
 
         # Log warning when no relevant sets were retrieved for the look.
         if (
@@ -456,7 +401,7 @@ class CollectLook(pyblish.api.InstancePlugin):
         instance.extend(shader for shader in look_sets if shader
                         not in instance_lookup)
 
-        self.log.info("Collected look for %s" % instance)
+        self.log.debug("Collected look for %s" % instance)
 
     def collect_sets(self, instance):
         """Collect all objectSets which are of importance for publishing
@@ -536,14 +481,14 @@ class CollectLook(pyblish.api.InstancePlugin):
             # Collect changes to "custom" attributes
             node_attrs = get_look_attrs(node)
 
-            self.log.info(
-                "Node \"{0}\" attributes: {1}".format(node, node_attrs)
-            )
-
             # Only include if there are any properties we care about
             if not node_attrs:
                 continue
 
+            self.log.debug(
+                "Node \"{0}\" attributes: {1}".format(node, node_attrs)
+            )
+
             node_attributes = {}
             for attr in node_attrs:
                 if not cmds.attributeQuery(attr, node=node, exists=True):
@@ -574,14 +519,12 @@ class CollectLook(pyblish.api.InstancePlugin):
         Returns:
             dict
         """
-        self.log.debug("processing: {}".format(node))
-        all_supported_nodes = FILE_NODES.keys()
-        if cmds.nodeType(node) not in all_supported_nodes:
+        if cmds.nodeType(node) not in FILE_NODES:
             self.log.error(
                 "Unsupported file node: {}".format(cmds.nodeType(node)))
             raise AssertionError("Unsupported file node")
 
-        self.log.debug("  - got {}".format(cmds.nodeType(node)))
+        self.log.debug("processing: {} ({})".format(node, cmds.nodeType(node)))
 
         attributes = get_attributes(FILE_NODES, cmds.nodeType(node), node)
         for attribute in attributes:
@@ -613,14 +556,7 @@ class CollectLook(pyblish.api.InstancePlugin):
 
             # renderman allows nodes to have filename attribute empty while
             # you can have another incoming connection from different node.
-            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:
+            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 fab6c0d9c603e1edfcdd86cc007cd7d0776a7ef5 Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Thu, 6 Jul 2023 01:24:00 +0200
Subject: [PATCH 016/366] Fix 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 6832411190..e08bf88872 100644
--- a/openpype/hosts/maya/plugins/publish/collect_look.py
+++ b/openpype/hosts/maya/plugins/publish/collect_look.py
@@ -345,7 +345,7 @@ class CollectLook(pyblish.api.InstancePlugin):
             existing_attrs = []
             for look in look_sets:
                 for attr in shader_attrs:
-                    if cmds.attributeQuery(attr, node=look_sets, exists=True):
+                    if cmds.attributeQuery(attr, node=look, exists=True):
                         existing_attrs.append("{}.{}".format(look, attr))
             materials = cmds.listConnections(existing_attrs,
                                              source=True,

From 40dc747f9ae1ba867e8afc14735c1e0d3a40ea0e Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Thu, 6 Jul 2023 01:24:33 +0200
Subject: [PATCH 017/366] Fix file nodes filtering

---
 openpype/hosts/maya/plugins/publish/collect_look.py | 12 +++++++++++-
 1 file changed, 11 insertions(+), 1 deletion(-)

diff --git a/openpype/hosts/maya/plugins/publish/collect_look.py b/openpype/hosts/maya/plugins/publish/collect_look.py
index e08bf88872..21e3d83d13 100644
--- a/openpype/hosts/maya/plugins/publish/collect_look.py
+++ b/openpype/hosts/maya/plugins/publish/collect_look.py
@@ -45,6 +45,13 @@ FILE_NODES = {
     "PxrTexture": "filename"
 }
 
+# Keep only node types that actually exist
+all_node_types = set(cmds.allNodeTypes())
+for node_type in list(FILE_NODES.keys()):
+    if node_type not in all_node_types:
+        FILE_NODES.pop(node_type)
+del all_node_types
+
 # Cache pixar dependency node types so we can perform a type lookup against it
 PXR_NODES = set()
 if cmds.pluginInfo("RenderMan_for_Maya", query=True, loaded=True):
@@ -377,10 +384,13 @@ class CollectLook(pyblish.api.InstancePlugin):
                 )
 
             files = cmds.ls(history,
+                            # It's important only node types are passed that
+                            # exist (e.g. for loaded plugins) because otherwise
+                            # the result will turn back empty
                             type=list(FILE_NODES.keys()),
                             long=True)
 
-        self.log.info("Collected file nodes:{}".format(files))
+        self.log.info("Collected file nodes: {}".format(files))
         # Collect textures if any file nodes are found
         resources = []
         for node in files:

From 38ab207e06b63eec371e8ef1cf83c90b73d6630d Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Thu, 6 Jul 2023 01:30:09 +0200
Subject: [PATCH 018/366] Cosmetics: remove new line in log

---
 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 21e3d83d13..0104c4e1dd 100644
--- a/openpype/hosts/maya/plugins/publish/collect_look.py
+++ b/openpype/hosts/maya/plugins/publish/collect_look.py
@@ -357,7 +357,7 @@ class CollectLook(pyblish.api.InstancePlugin):
             materials = cmds.listConnections(existing_attrs,
                                              source=True,
                                              destination=False) or []
-            self.log.debug("Found materials:\n{}".format(materials))
+            self.log.debug("Found materials: {}".format(materials))
 
             # Get the entire node chain of the look sets
             # history = cmds.listHistory(look_sets, allConnections=True)

From ae3364a833efc39ce82d073a4402d95b2d78735d Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Thu, 6 Jul 2023 01:30:28 +0200
Subject: [PATCH 019/366] Cosmetics: remove new line in logs

---
 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 0104c4e1dd..f8c5ccf4ee 100644
--- a/openpype/hosts/maya/plugins/publish/collect_look.py
+++ b/openpype/hosts/maya/plugins/publish/collect_look.py
@@ -346,7 +346,7 @@ class CollectLook(pyblish.api.InstancePlugin):
             "rman__displacement"
         ]
         if look_sets:
-            self.log.debug("Found look sets:\n{}".format(look_sets))
+            self.log.debug("Found look sets: {}".format(look_sets))
 
             # Get all material attrs for all look sets to retrieve their inputs
             existing_attrs = []

From 58217d88c57700e7e645d5b7dbca2bc6e5f92bf3 Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Thu, 6 Jul 2023 11:11:59 +0200
Subject: [PATCH 020/366] Ensure file nodes are processed only once

---
 openpype/hosts/maya/plugins/publish/collect_look.py | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/openpype/hosts/maya/plugins/publish/collect_look.py b/openpype/hosts/maya/plugins/publish/collect_look.py
index f8c5ccf4ee..80c4b61de5 100644
--- a/openpype/hosts/maya/plugins/publish/collect_look.py
+++ b/openpype/hosts/maya/plugins/publish/collect_look.py
@@ -383,6 +383,9 @@ class CollectLook(pyblish.api.InstancePlugin):
                     or []
                 )
 
+            # Ensure unique entries only
+            history = list(set(history))
+
             files = cmds.ls(history,
                             # It's important only node types are passed that
                             # exist (e.g. for loaded plugins) because otherwise
@@ -390,10 +393,13 @@ class CollectLook(pyblish.api.InstancePlugin):
                             type=list(FILE_NODES.keys()),
                             long=True)
 
+            # Sort for log readability
+            files.sort()
+
         self.log.info("Collected file nodes: {}".format(files))
         # Collect textures if any file nodes are found
         resources = []
-        for node in files:
+        for node in files:  # sort for log readability
             resources.extend(self.collect_resources(node))
         instance.data["resources"] = resources
         self.log.debug("Collected resources: {}".format(resources))

From 95e763dee4d592d94180cf9047eb9210fae9246c Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Thu, 6 Jul 2023 11:12:46 +0200
Subject: [PATCH 021/366] Clarify that computed source is only used for logging
 by moving logic closer together

---
 .../maya/plugins/publish/collect_look.py      | 23 ++++++++++---------
 1 file changed, 12 insertions(+), 11 deletions(-)

diff --git a/openpype/hosts/maya/plugins/publish/collect_look.py b/openpype/hosts/maya/plugins/publish/collect_look.py
index 80c4b61de5..321df3e61c 100644
--- a/openpype/hosts/maya/plugins/publish/collect_look.py
+++ b/openpype/hosts/maya/plugins/publish/collect_look.py
@@ -548,27 +548,28 @@ class CollectLook(pyblish.api.InstancePlugin):
                 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_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))
+            # Only for file nodes with `fileTextureName` attribute
+            if attribute == "fileTextureName":
+                computed_source = cmds.getAttr(
+                    "{}.computedFileTextureNamePattern".format(node)
+                )
+                if source != computed_source:
+                    self.log.debug("Detected computed file pattern difference "
+                                   "from original pattern: {0} "
+                                   "({1} -> {2})".format(node,
+                                                         source,
+                                                         computed_source))
 
             # renderman allows nodes to have filename attribute empty while
             # you can have another incoming connection from different node.

From a54cddf0f378eb80bb4d2bd2c7386415ed69f034 Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Thu, 6 Jul 2023 11:13:12 +0200
Subject: [PATCH 022/366] Clarify in log that it's processing a resource

---
 openpype/hosts/maya/plugins/publish/collect_look.py | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/openpype/hosts/maya/plugins/publish/collect_look.py b/openpype/hosts/maya/plugins/publish/collect_look.py
index 321df3e61c..bbe25c559e 100644
--- a/openpype/hosts/maya/plugins/publish/collect_look.py
+++ b/openpype/hosts/maya/plugins/publish/collect_look.py
@@ -540,7 +540,9 @@ class CollectLook(pyblish.api.InstancePlugin):
                 "Unsupported file node: {}".format(cmds.nodeType(node)))
             raise AssertionError("Unsupported file node")
 
-        self.log.debug("processing: {} ({})".format(node, cmds.nodeType(node)))
+        self.log.debug(
+            "Collecting resource: {} ({})".format(node, cmds.nodeType(node))
+        )
 
         attributes = get_attributes(FILE_NODES, cmds.nodeType(node), node)
         for attribute in attributes:

From 8e281f4efef4917fbe965f7e49979577e4e6e226 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Mon, 10 Jul 2023 13:17:30 +0200
Subject: [PATCH 023/366] simplification of subprocess calls

---
 openpype/pipeline/colorspace.py | 65 +++++++++++++++++++++++++++++----
 1 file changed, 57 insertions(+), 8 deletions(-)

diff --git a/openpype/pipeline/colorspace.py b/openpype/pipeline/colorspace.py
index 3f2d4891c1..2ca78f3520 100644
--- a/openpype/pipeline/colorspace.py
+++ b/openpype/pipeline/colorspace.py
@@ -206,8 +206,9 @@ def validate_imageio_colorspace_in_config(config_path, colorspace_name):
     return True
 
 
+# TODO: remove this in future - backward compatibility
 def get_data_subprocess(config_path, data_type):
-    """Get data via subprocess
+    """[Deprecated] Get data via subprocess
 
     Wrapper for Python 2 hosts.
 
@@ -221,7 +222,6 @@ def get_data_subprocess(config_path, data_type):
             "config", data_type,
             "--in_path", config_path,
             "--out_path", tmp_json_path
-
         ]
         log.info("Executing: {}".format(" ".join(args)))
 
@@ -236,6 +236,45 @@ def get_data_subprocess(config_path, data_type):
         return json.loads(return_json_data)
 
 
+def get_wrapped_with_subprocess(command_group, command, **kwargs):
+    """Get data via subprocess
+
+    Wrapper for Python 2 hosts.
+
+    Args:
+        command_group (str): command group name
+        command (str): command name
+        **kwargs: command arguments
+
+    Returns:
+        Any[dict, None]: data
+    """
+    with _make_temp_json_file() as tmp_json_path:
+        # Prepare subprocess arguments
+        args = [
+            "run", get_ocio_config_script_path(),
+            command_group, command
+        ]
+
+        for key_, value_ in kwargs.items():
+            args.extend(("--{}".format(key_), value_))
+
+        args.append("--out_path")
+        args.append(tmp_json_path)
+
+        log.info("Executing: {}".format(" ".join(args)))
+
+        process_kwargs = {
+            "logger": log
+        }
+
+        run_openpype_process(*args, **process_kwargs)
+
+        # return all colorspaces
+        return_json_data = open(tmp_json_path).read()
+        return json.loads(return_json_data)
+
+
 def compatibility_check():
     """Making sure PyOpenColorIO is importable"""
     try:
@@ -260,15 +299,18 @@ def get_ocio_config_colorspaces(config_path):
     if not compatibility_check():
         # python environment is not compatible with PyOpenColorIO
         # needs to be run in subprocess
-        return get_colorspace_data_subprocess(config_path)
+        return get_wrapped_with_subprocess(
+            "config", "get_colorspace", in_path=config_path
+        )
 
     from openpype.scripts.ocio_wrapper import _get_colorspace_data
 
     return _get_colorspace_data(config_path)
 
 
+# TODO: remove this in future - backward compatibility
 def get_colorspace_data_subprocess(config_path):
-    """Get colorspace data via subprocess
+    """[Deprecated] Get colorspace data via subprocess
 
     Wrapper for Python 2 hosts.
 
@@ -278,7 +320,9 @@ def get_colorspace_data_subprocess(config_path):
     Returns:
         dict: colorspace and family in couple
     """
-    return get_data_subprocess(config_path, "get_colorspace")
+    return get_wrapped_with_subprocess(
+        "config", "get_colorspace", in_path=config_path
+    )
 
 
 def get_ocio_config_views(config_path):
@@ -296,15 +340,18 @@ def get_ocio_config_views(config_path):
     if not compatibility_check():
         # python environment is not compatible with PyOpenColorIO
         # needs to be run in subprocess
-        return get_views_data_subprocess(config_path)
+        return get_wrapped_with_subprocess(
+            "config", "get_views", in_path=config_path
+        )
 
     from openpype.scripts.ocio_wrapper import _get_views_data
 
     return _get_views_data(config_path)
 
 
+# TODO: remove this in future - backward compatibility
 def get_views_data_subprocess(config_path):
-    """Get viewers data via subprocess
+    """[Deprecated] Get viewers data via subprocess
 
     Wrapper for Python 2 hosts.
 
@@ -314,7 +361,9 @@ def get_views_data_subprocess(config_path):
     Returns:
         dict: `display/viewer` and viewer data
     """
-    return get_data_subprocess(config_path, "get_views")
+    return get_wrapped_with_subprocess(
+        "config", "get_views", in_path=config_path
+    )
 
 
 def get_imageio_config(

From 739c2e15bc58c447cf25ef9a9f9204a0aaf05344 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Mon, 10 Jul 2023 13:18:34 +0200
Subject: [PATCH 024/366] adding support for OCIO v2 file rules

---
 openpype/pipeline/colorspace.py  | 31 ++++++++++
 openpype/scripts/ocio_wrapper.py | 99 ++++++++++++++++++++++++++++----
 2 files changed, 119 insertions(+), 11 deletions(-)

diff --git a/openpype/pipeline/colorspace.py b/openpype/pipeline/colorspace.py
index 2ca78f3520..26e12871f8 100644
--- a/openpype/pipeline/colorspace.py
+++ b/openpype/pipeline/colorspace.py
@@ -132,6 +132,37 @@ def get_imageio_colorspace_from_filepath(
     return colorspace_name
 
 
+def get_colorspace_from_filepath(config_path, filepath):
+    """Get colorspace from file path wrapper.
+
+    Wrapper function for getting colorspace from file path.
+
+    Args:
+        config_path (str): path leading to config.ocio file
+        filepath (str): path leading to a file
+
+    Returns:
+        Any[str, None]: matching colorspace name
+    """
+    if not compatibility_check():
+        # python environment is not compatible with PyOpenColorIO
+        # needs to be run in subprocess
+        result_data = get_wrapped_with_subprocess(
+            "colorspace", "get_colorspace_from_filepath",
+            config_path=config_path,
+            filepath=filepath
+        )
+        if result_data:
+            return result_data[0]
+
+    from openpype.scripts.ocio_wrapper import _get_colorspace_from_filepath
+
+    result_data = _get_colorspace_from_filepath(config_path, filepath)
+
+    if result_data:
+        return result_data[0]
+
+
 def parse_colorspace_from_filepath(
     path, host_name, project_name,
     config_data=None,
diff --git a/openpype/scripts/ocio_wrapper.py b/openpype/scripts/ocio_wrapper.py
index 16558642c6..1c86216347 100644
--- a/openpype/scripts/ocio_wrapper.py
+++ b/openpype/scripts/ocio_wrapper.py
@@ -27,7 +27,7 @@ import PyOpenColorIO as ocio
 
 @click.group()
 def main():
-    pass
+    pass  # noqa: WPS100
 
 
 @main.group()
@@ -37,7 +37,17 @@ def config():
     Example of use:
     > pyton.exe ./ocio_wrapper.py config <command> *args
     """
-    pass
+    pass  # noqa: WPS100
+
+
+@main.group()
+def colorspace():
+    """Colorspace related commands group
+
+    Example of use:
+    > pyton.exe ./ocio_wrapper.py config <command> *args
+    """
+    pass  # noqa: WPS100
 
 
 @config.command(
@@ -70,8 +80,8 @@ def get_colorspace(in_path, out_path):
 
     out_data = _get_colorspace_data(in_path)
 
-    with open(json_path, "w") as f:
-        json.dump(out_data, f)
+    with open(json_path, "w") as f_:
+        json.dump(out_data, f_)
 
     print(f"Colorspace data are saved to '{json_path}'")
 
@@ -97,8 +107,8 @@ def _get_colorspace_data(config_path):
     config = ocio.Config().CreateFromFile(str(config_path))
 
     return {
-        c.getName(): c.getFamily()
-        for c in config.getColorSpaces()
+        c_.getName(): c_.getFamily()
+        for c_ in config.getColorSpaces()
     }
 
 
@@ -132,8 +142,8 @@ def get_views(in_path, out_path):
 
     out_data = _get_views_data(in_path)
 
-    with open(json_path, "w") as f:
-        json.dump(out_data, f)
+    with open(json_path, "w") as f_:
+        json.dump(out_data, f_)
 
     print(f"Viewer data are saved to '{json_path}'")
 
@@ -157,7 +167,7 @@ def _get_views_data(config_path):
 
     config = ocio.Config().CreateFromFile(str(config_path))
 
-    data = {}
+    data_ = {}
     for display in config.getDisplays():
         for view in config.getViews(display):
             colorspace = config.getDisplayViewColorSpaceName(display, view)
@@ -165,13 +175,80 @@ def _get_views_data(config_path):
             if colorspace == "<USE_DISPLAY_NAME>":
                 colorspace = display
 
-            data[f"{display}/{view}"] = {
+            data_[f"{display}/{view}"] = {
                 "display": display,
                 "view": view,
                 "colorspace": colorspace
             }
 
-    return data
+    return data_
+
+
+@colorspace.command(
+    name="get_colorspace_from_filepath",
+    help=(
+        "return colorspace from filepath "
+        "--config_path - ocio config file path (input arg is required) "
+        "--filepath - any file path (input arg is required) "
+        "--out_path - temp json file path (input arg is required)"
+    )
+)
+@click.option("--config_path", required=True,
+              help="path where to read ocio config file",
+              type=click.Path(exists=True))
+@click.option("--filepath", required=True,
+              help="path to file to get colorspace from",
+              type=click.Path(exists=True))
+@click.option("--out_path", required=True,
+              help="path where to write output json file",
+              type=click.Path())
+def get_colorspace_from_filepath(config_path, filepath, out_path):
+    """Get colorspace from file path wrapper.
+
+    Python 2 wrapped console command
+
+    Args:
+        config_path (str): config file path string
+        filepath (str): path string leading to file
+        out_path (str): temp json file path string
+
+    Example of use:
+    > pyton.exe ./ocio_wrapper.py colorspace get_colorspace_from_filepath \
+        --config_path=<path> --filepath=<path> --out_path=<path>
+    """
+    json_path = Path(out_path)
+
+    colorspace = _get_colorspace_from_filepath(config_path, filepath)
+
+    with open(json_path, "w") as f_:
+        json.dump(colorspace, f_)
+
+    print(f"Colorspace name is saved to '{json_path}'")
+
+
+def _get_colorspace_from_filepath(config_path, filepath):
+    """Return found colorspace data found in v2 file rules.
+
+    Args:
+        config_path (str): path string leading to config.ocio
+        filepath (str): path string leading to v2 file rules
+
+    Raises:
+        IOError: Input config does not exist.
+
+    Returns:
+        dict: aggregated available colorspaces
+    """
+    config_path = Path(config_path)
+
+    if not config_path.is_file():
+        raise IOError(
+            f"Input path `{config_path}` should be `config.ocio` file")
+
+    config = ocio.Config().CreateFromFile(str(config_path))
+    colorspace = config.getColorSpaceFromFilepath(str(filepath))
+
+    return colorspace
 
 
 if __name__ == '__main__':

From 0114993456108652b8995ac87531462e79e065b6 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Mon, 10 Jul 2023 13:57:20 +0200
Subject: [PATCH 025/366] compatibility to config version

---
 openpype/pipeline/colorspace.py | 30 ++++++++++++++++++++++++++++++
 1 file changed, 30 insertions(+)

diff --git a/openpype/pipeline/colorspace.py b/openpype/pipeline/colorspace.py
index 26e12871f8..0b23c2b4e3 100644
--- a/openpype/pipeline/colorspace.py
+++ b/openpype/pipeline/colorspace.py
@@ -124,6 +124,10 @@ def get_imageio_colorspace_from_filepath(
         ))
         return None
 
+    if compatibility_check_config_version(config_data["path"], major=2):
+        colorspace_name = get_colorspace_from_filepath(
+            config_data["path"], path)
+
     # validate matching colorspace with config
     if validate and config_data:
         validate_imageio_colorspace_in_config(
@@ -312,6 +316,32 @@ def compatibility_check():
         import PyOpenColorIO  # noqa: F401
     except ImportError:
         return False
+
+    # compatible
+    return True
+
+
+def compatibility_check_config_version(config_path, major=1, minor=None):
+    """Making sure PyOpenColorIO config version is compatible"""
+    try:
+        import PyOpenColorIO as ocio
+        config = ocio.Config().CreateFromFile(str(config_path))
+
+        config_version_major = config.getMajorVersion()
+        config_version_minor = config.getMinorVersion()
+        print(config_version_major, config_version_minor)
+
+        # check major version
+        if config_version_major != major:
+            return False
+        # check minor version
+        if minor and config_version_minor != minor:
+            return False
+
+    except ImportError:
+        return False
+
+    # compatible
     return True
 
 

From 9c18402ac70952a39247d681322777951b1fe97c Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Mon, 10 Jul 2023 16:42:52 +0200
Subject: [PATCH 026/366] updating config version validation

- cashing python version validation so it is overwritable by tests
- implementing python compatibility override into tests
- adding tests for ocio v2 filerules
---
 openpype/pipeline/colorspace.py               | 52 +++++++++------
 openpype/scripts/ocio_wrapper.py              | 64 +++++++++++++++++-
 .../unit/openpype/pipeline/test_colorspace.py | 65 +++++++++++++++++++
 3 files changed, 161 insertions(+), 20 deletions(-)

diff --git a/openpype/pipeline/colorspace.py b/openpype/pipeline/colorspace.py
index 0b23c2b4e3..72c140195e 100644
--- a/openpype/pipeline/colorspace.py
+++ b/openpype/pipeline/colorspace.py
@@ -19,6 +19,7 @@ log = Logger.get_logger(__name__)
 
 class CashedData:
     remapping = None
+    python3compatible = None
 
 
 @contextlib.contextmanager
@@ -118,16 +119,23 @@ def get_imageio_colorspace_from_filepath(
         if ext_match and file_match:
             colorspace_name = file_rule["colorspace"]
 
+    # if no file rule matched, try to get colorspace
+    # from filepath with OCIO v2 way
+    # QUESTION: should we override file rules from our settings and
+    #           in ocio v2 only focus on file rules set in config file?
+    if (
+        compatibility_check_config_version(config_data["path"], major=2)
+        and not colorspace_name
+    ):
+        colorspace_name = get_colorspace_from_filepath(
+            config_data["path"], path)
+
     if not colorspace_name:
         log.info("No imageio file rule matched input path: '{}'".format(
             path
         ))
         return None
 
-    if compatibility_check_config_version(config_data["path"], major=2):
-        colorspace_name = get_colorspace_from_filepath(
-            config_data["path"], path)
-
     # validate matching colorspace with config
     if validate and config_data:
         validate_imageio_colorspace_in_config(
@@ -312,33 +320,39 @@ def get_wrapped_with_subprocess(command_group, command, **kwargs):
 
 def compatibility_check():
     """Making sure PyOpenColorIO is importable"""
+    if CashedData.python3compatible is not None:
+        return CashedData.python3compatible
+
     try:
         import PyOpenColorIO  # noqa: F401
+        CashedData.python3compatible = True
     except ImportError:
-        return False
+        CashedData.python3compatible = False
 
     # compatible
-    return True
+    return CashedData.python3compatible
 
 
 def compatibility_check_config_version(config_path, major=1, minor=None):
     """Making sure PyOpenColorIO config version is compatible"""
-    try:
-        import PyOpenColorIO as ocio
-        config = ocio.Config().CreateFromFile(str(config_path))
 
-        config_version_major = config.getMajorVersion()
-        config_version_minor = config.getMinorVersion()
-        print(config_version_major, config_version_minor)
+    if not compatibility_check():
+        # python environment is not compatible with PyOpenColorIO
+        # needs to be run in subprocess
+        version_data = get_wrapped_with_subprocess(
+            "config", "get_version", config_path=config_path
+        )
 
-        # check major version
-        if config_version_major != major:
-            return False
-        # check minor version
-        if minor and config_version_minor != minor:
-            return False
+    from openpype.scripts.ocio_wrapper import _get_version_data
 
-    except ImportError:
+    version_data = _get_version_data(config_path)
+
+    # check major version
+    if version_data["major"] != major:
+        return False
+
+    # check minor version
+    if minor and version_data["minor"] != minor:
         return False
 
     # compatible
diff --git a/openpype/scripts/ocio_wrapper.py b/openpype/scripts/ocio_wrapper.py
index 1c86216347..4332ea5b01 100644
--- a/openpype/scripts/ocio_wrapper.py
+++ b/openpype/scripts/ocio_wrapper.py
@@ -184,6 +184,68 @@ def _get_views_data(config_path):
     return data_
 
 
+@config.command(
+    name="get_version",
+    help=(
+        "return major and minor version from config file "
+        "--config_path input arg is required"
+        "--out_path input arg is required"
+    )
+)
+@click.option("--config_path", required=True,
+              help="path where to read ocio config file",
+              type=click.Path(exists=True))
+@click.option("--out_path", required=True,
+              help="path where to write output json file",
+              type=click.Path())
+def get_version(config_path, out_path):
+    """Get version of config.
+
+    Python 2 wrapped console command
+
+    Args:
+        config_path (str): ocio config file path string
+        out_path (str): temp json file path string
+
+    Example of use:
+    > pyton.exe ./ocio_wrapper.py config get_version \
+        --config_path=<path> --out_path=<path>
+    """
+    json_path = Path(out_path)
+
+    out_data = _get_version_data(config_path)
+
+    with open(json_path, "w") as f_:
+        json.dump(out_data, f_)
+
+    print(f"Config version data are saved to '{json_path}'")
+
+
+def _get_version_data(config_path):
+    """Return major and minor version info.
+
+    Args:
+        config_path (str): path string leading to config.ocio
+
+    Raises:
+        IOError: Input config does not exist.
+
+    Returns:
+        dict: minor and major keys with values
+    """
+    config_path = Path(config_path)
+
+    if not config_path.is_file():
+        raise IOError("Input path should be `config.ocio` file")
+
+    config = ocio.Config().CreateFromFile(str(config_path))
+
+    return {
+        "major": config.getMajorVersion(),
+        "minor": config.getMinorVersion()
+    }
+
+
 @colorspace.command(
     name="get_colorspace_from_filepath",
     help=(
@@ -198,7 +260,7 @@ def _get_views_data(config_path):
               type=click.Path(exists=True))
 @click.option("--filepath", required=True,
               help="path to file to get colorspace from",
-              type=click.Path(exists=True))
+              type=click.Path())
 @click.option("--out_path", required=True,
               help="path where to write output json file",
               type=click.Path())
diff --git a/tests/unit/openpype/pipeline/test_colorspace.py b/tests/unit/openpype/pipeline/test_colorspace.py
index c22acee2d4..a6fcc68055 100644
--- a/tests/unit/openpype/pipeline/test_colorspace.py
+++ b/tests/unit/openpype/pipeline/test_colorspace.py
@@ -185,5 +185,70 @@ class TestPipelineColorspace(TestPipeline):
         assert expected_hiero == hiero_file_rules, (
             f"Not matching file rules {expected_hiero}")
 
+    def test_get_imageio_colorspace_from_filepath_p3(self, project_settings):
+        """Test Colorspace from filepath with python 3 compatibility mode
+
+        Also test ocio v2 file rules
+        """
+        nuke_filepath = "renderCompMain_baking_h264.mp4"
+        hiero_filepath = "prerenderCompMain.mp4"
+
+        expected_nuke = "Camera Rec.709"
+        expected_hiero = "Gamma 2.2 Rec.709 - Texture"
+
+        nuke_colorspace = colorspace.get_imageio_colorspace_from_filepath(
+            nuke_filepath,
+            "nuke",
+            "test_project",
+            project_settings=project_settings
+        )
+        assert expected_nuke == nuke_colorspace, (
+            f"Not matching colorspace {expected_nuke}")
+
+        hiero_colorspace = colorspace.get_imageio_colorspace_from_filepath(
+            hiero_filepath,
+            "hiero",
+            "test_project",
+            project_settings=project_settings
+        )
+        assert expected_hiero == hiero_colorspace, (
+            f"Not matching colorspace {expected_hiero}")
+
+    def test_get_imageio_colorspace_from_filepath_python2mode(
+            self, project_settings):
+        """Test Colorspace from filepath with python 2 compatibility mode
+
+        Also test ocio v2 file rules
+        """
+        nuke_filepath = "renderCompMain_baking_h264.mp4"
+        hiero_filepath = "prerenderCompMain.mp4"
+
+        expected_nuke = "Camera Rec.709"
+        expected_hiero = "Gamma 2.2 Rec.709 - Texture"
+
+        # switch to python 2 compatibility mode
+        colorspace.CashedData.python3compatible = False
+
+        nuke_colorspace = colorspace.get_imageio_colorspace_from_filepath(
+            nuke_filepath,
+            "nuke",
+            "test_project",
+            project_settings=project_settings
+        )
+        assert expected_nuke == nuke_colorspace, (
+            f"Not matching colorspace {expected_nuke}")
+
+        hiero_colorspace = colorspace.get_imageio_colorspace_from_filepath(
+            hiero_filepath,
+            "hiero",
+            "test_project",
+            project_settings=project_settings
+        )
+        assert expected_hiero == hiero_colorspace, (
+            f"Not matching colorspace {expected_hiero}")
+
+        # return to python 3 compatibility mode
+        colorspace.CashedData.python3compatible = None
+
 
 test_case = TestPipelineColorspace()

From edc260073b62afb56c2304e747bb739274665630 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Mon, 10 Jul 2023 16:49:22 +0200
Subject: [PATCH 027/366] updating testing package gdrive hash

---
 tests/unit/openpype/pipeline/test_colorspace.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/tests/unit/openpype/pipeline/test_colorspace.py b/tests/unit/openpype/pipeline/test_colorspace.py
index a6fcc68055..e63ca510f2 100644
--- a/tests/unit/openpype/pipeline/test_colorspace.py
+++ b/tests/unit/openpype/pipeline/test_colorspace.py
@@ -26,12 +26,12 @@ class TestPipelineColorspace(TestPipeline):
 
     Example:
         cd to OpenPype repo root dir
-        poetry run python ./start.py runtests ../tests/unit/openpype/pipeline
-    """
+        poetry run python ./start.py runtests <openpype_root>/tests/unit/openpype/pipeline/test_colorspace.py
+    """  # noqa: E501
 
     TEST_FILES = [
         (
-            "1Lf-mFxev7xiwZCWfImlRcw7Fj8XgNQMh",
+            "1csqimz8bbNcNgxtEXklLz6GRv91D3KgA",
             "test_pipeline_colorspace.zip",
             ""
         )

From 97477d2049f8b5493ef0c7f03aaceb6e3ea9a034 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Tue, 11 Jul 2023 16:11:54 +0200
Subject: [PATCH 028/366] todos for parseColorSpaceFromString

---
 openpype/pipeline/colorspace.py  | 2 ++
 openpype/scripts/ocio_wrapper.py | 2 ++
 2 files changed, 4 insertions(+)

diff --git a/openpype/pipeline/colorspace.py b/openpype/pipeline/colorspace.py
index 72c140195e..13b235d5dd 100644
--- a/openpype/pipeline/colorspace.py
+++ b/openpype/pipeline/colorspace.py
@@ -123,6 +123,8 @@ def get_imageio_colorspace_from_filepath(
     # from filepath with OCIO v2 way
     # QUESTION: should we override file rules from our settings and
     #           in ocio v2 only focus on file rules set in config file?
+    # TODO: do the ocio v compatibility check inside of wrapper script
+    #       because of implementation `parseColorSpaceFromString`
     if (
         compatibility_check_config_version(config_data["path"], major=2)
         and not colorspace_name
diff --git a/openpype/scripts/ocio_wrapper.py b/openpype/scripts/ocio_wrapper.py
index 4332ea5b01..1feedde627 100644
--- a/openpype/scripts/ocio_wrapper.py
+++ b/openpype/scripts/ocio_wrapper.py
@@ -308,6 +308,8 @@ def _get_colorspace_from_filepath(config_path, filepath):
             f"Input path `{config_path}` should be `config.ocio` file")
 
     config = ocio.Config().CreateFromFile(str(config_path))
+
+    # TODO: use `parseColorSpaceFromString` instead if ocio v1
     colorspace = config.getColorSpaceFromFilepath(str(filepath))
 
     return colorspace

From f7c368892b6a34a808b21a0f4da51b9f74b3228f Mon Sep 17 00:00:00 2001
From: Toke Stuart Jepsen <tokejepsen@gmail.com>
Date: Thu, 13 Jul 2023 15:49:16 +0100
Subject: [PATCH 029/366] Fix Maya Deadline submit plugin

---
 .../deadline/plugins/publish/submit_maya_deadline.py  | 11 ++++-------
 1 file changed, 4 insertions(+), 7 deletions(-)

diff --git a/openpype/modules/deadline/plugins/publish/submit_maya_deadline.py b/openpype/modules/deadline/plugins/publish/submit_maya_deadline.py
index 159ac43289..8193ca2734 100644
--- a/openpype/modules/deadline/plugins/publish/submit_maya_deadline.py
+++ b/openpype/modules/deadline/plugins/publish/submit_maya_deadline.py
@@ -289,7 +289,6 @@ class MayaSubmitDeadline(abstract_submit_deadline.AbstractSubmitDeadline,
     def process_submission(self):
 
         instance = self._instance
-        context = instance.context
 
         filepath = self.scene_path  # publish if `use_publish` else workfile
 
@@ -306,13 +305,11 @@ class MayaSubmitDeadline(abstract_submit_deadline.AbstractSubmitDeadline,
             self._patch_workfile()
 
         # Gather needed data ------------------------------------------------
-        workspace = context.data["workspaceDir"]
-        default_render_file = instance.context.data.get('project_settings')\
-            .get('maya')\
-            .get('RenderSettings')\
-            .get('default_render_image_folder')
         filename = os.path.basename(filepath)
-        dirname = os.path.join(workspace, default_render_file)
+        dirname = os.path.join(
+            cmds.workspace(query=True, rootDirectory=True),
+            cmds.workspace(fileRuleEntry="images")
+        )
 
         # Fill in common data to payload ------------------------------------
         # TODO: Replace these with collected data from CollectRender

From c264a6abf1a2c6605b9d7d51d2e2cdb6c0d9a63b Mon Sep 17 00:00:00 2001
From: Toke Stuart Jepsen <tokejepsen@gmail.com>
Date: Mon, 24 Jul 2023 08:14:57 +0100
Subject: [PATCH 030/366] Disable hardlinking.

---
 .../hosts/maya/plugins/publish/extract_look.py    | 15 ++++++---------
 1 file changed, 6 insertions(+), 9 deletions(-)

diff --git a/openpype/hosts/maya/plugins/publish/extract_look.py b/openpype/hosts/maya/plugins/publish/extract_look.py
index e2c88ef44a..50a6db3bf7 100644
--- a/openpype/hosts/maya/plugins/publish/extract_look.py
+++ b/openpype/hosts/maya/plugins/publish/extract_look.py
@@ -6,7 +6,6 @@ import contextlib
 import json
 import logging
 import os
-import platform
 import tempfile
 import six
 import attr
@@ -585,14 +584,12 @@ class ExtractLook(publish.Extractor):
         resources = instance.data["resources"]
         color_management = lib.get_color_management_preferences()
 
-        # Temporary fix to NOT create hardlinks on windows machines
-        if platform.system().lower() == "windows":
-            self.log.info(
-                "Forcing copy instead of hardlink due to issues on Windows..."
-            )
-            force_copy = True
-        else:
-            force_copy = instance.data.get("forceCopy", False)
+        # Temporary disable all hardlinking, due to the feature not being used
+        # or properly working.
+        self.log.info(
+            "Forcing copy instead of hardlink."
+        )
+        force_copy = True
 
         destinations_cache = {}
 

From a2e18323ff1103861891cf84dd9e2ac3b6efab53 Mon Sep 17 00:00:00 2001
From: Mustafa-Zarkash <mustafataherzaky@outlook.com>
Date: Thu, 27 Jul 2023 22:32:43 +0300
Subject: [PATCH 031/366] update fbx creator

---
 .../houdini/plugins/create/create_fbx.py      | 103 ++++++++++++++++++
 1 file changed, 103 insertions(+)
 create mode 100644 openpype/hosts/houdini/plugins/create/create_fbx.py

diff --git a/openpype/hosts/houdini/plugins/create/create_fbx.py b/openpype/hosts/houdini/plugins/create/create_fbx.py
new file mode 100644
index 0000000000..65f613bdea
--- /dev/null
+++ b/openpype/hosts/houdini/plugins/create/create_fbx.py
@@ -0,0 +1,103 @@
+# -*- coding: utf-8 -*-
+"""Creator plugin for creating fbx."""
+from openpype.hosts.houdini.api import plugin
+
+import hou
+
+
+class CreateFilmboxFBX(plugin.HoudiniCreator):
+    """Filmbox FBX Driver"""
+    identifier = "io.openpype.creators.houdini.filmboxfbx"
+    label = "Filmbox FBX"
+    family = "filmboxfbx"
+    icon = "fa5s.cubes"
+
+    def create(self, subset_name, instance_data, pre_create_data):
+        instance_data.pop("active", None)
+        instance_data.update({"node_type": "filmboxfbx"})
+
+        instance = super(CreateFilmboxFBX, self).create(
+            subset_name,
+            instance_data,
+            pre_create_data)
+
+        instance_node = hou.node(instance.get("instance_node"))
+        output_path = hou.text.expandString(
+            "$HIP/pyblish/{}.fbx".format(subset_name))
+
+        parms = {
+            "sopoutput": output_path
+        }
+
+        if self.selected_nodes:
+            selected_node = self.selected_nodes[0]
+
+            # Although Houdini allows ObjNode path on `startnode` for the
+            # the ROP node we prefer it set to the SopNode path explicitly
+
+            # Allow sop level paths (e.g. /obj/geo1/box1)
+            if isinstance(selected_node, hou.SopNode):
+                parms["startnode"] = selected_node.path()
+                self.log.debug(
+                    "Valid SopNode selection, 'Export' in filmboxfbx"
+                    " will be set to '%s'."
+                    % selected_node
+                )
+
+            # Allow object level paths to Geometry nodes (e.g. /obj/geo1)
+            # but do not allow other object level nodes types like cameras, etc.
+            elif isinstance(selected_node, hou.ObjNode) and \
+                    selected_node.type().name() in ["geo"]:
+
+                # get the output node with the minimum
+                # 'outputidx' or the node with display flag
+                sop_path = self.get_obj_output(selected_node)
+
+                if sop_path:
+                    parms["startnode"] = sop_path.path()
+                    self.log.debug(
+                        "Valid ObjNode selection, 'Export' in filmboxfbx "
+                        "will be set to the child path '%s'."
+                        % sop_path
+                    )
+
+            if not parms.get("startnode", None):
+                self.log.debug(
+                    "Selection isn't valid. 'Export' in filmboxfbx will be empty."
+                )
+        else:
+            self.log.debug(
+                "No Selection. 'Export' in filmboxfbx will be empty."
+            )
+
+        instance_node.setParms(parms)
+
+        # Lock any parameters in this list
+        to_lock = []
+        self.lock_parameters(instance_node, to_lock)
+
+    def get_network_categories(self):
+        return [
+            hou.ropNodeTypeCategory(),
+            hou.sopNodeTypeCategory()
+        ]
+
+    def get_obj_output(self, obj_node):
+        """Find output node with the smallest 'outputidx'."""
+
+        outputs = obj_node.subnetOutputs()
+
+        # if obj_node is empty
+        if not outputs:
+            return
+
+        # if obj_node has one output child whether its
+        # sop output node or a node with the render flag
+        elif len(outputs) == 1:
+            return outputs[0]
+
+        # if there are more than one, then it have multiple ouput nodes
+        # return the one with the minimum 'outputidx'
+        else:
+            return min(outputs,
+                       key=lambda node: node.evalParm('outputidx'))

From 5a9281823d3d18cc9857875b796f7e65d9c747f1 Mon Sep 17 00:00:00 2001
From: Mustafa-Zarkash <mustafataherzaky@outlook.com>
Date: Fri, 28 Jul 2023 00:06:55 +0300
Subject: [PATCH 032/366] update create_fbx

---
 .../houdini/plugins/create/create_fbx.py      | 62 ++++++++++++++-----
 1 file changed, 46 insertions(+), 16 deletions(-)

diff --git a/openpype/hosts/houdini/plugins/create/create_fbx.py b/openpype/hosts/houdini/plugins/create/create_fbx.py
index 65f613bdea..b59a8ccfc6 100644
--- a/openpype/hosts/houdini/plugins/create/create_fbx.py
+++ b/openpype/hosts/houdini/plugins/create/create_fbx.py
@@ -12,23 +12,61 @@ class CreateFilmboxFBX(plugin.HoudiniCreator):
     family = "filmboxfbx"
     icon = "fa5s.cubes"
 
+    # Overrides HoudiniCreator.create()
     def create(self, subset_name, instance_data, pre_create_data):
-        instance_data.pop("active", None)
+        # instance_data.pop("active", None)
+
+        # set node type
         instance_data.update({"node_type": "filmboxfbx"})
 
+        # set essential extra parameters
         instance = super(CreateFilmboxFBX, self).create(
             subset_name,
             instance_data,
             pre_create_data)
 
+        # get the created node
         instance_node = hou.node(instance.get("instance_node"))
+
+        # get output path
         output_path = hou.text.expandString(
             "$HIP/pyblish/{}.fbx".format(subset_name))
 
+        # get selection
+        selection = self.get_selection()
+
+        # parms dictionary
         parms = {
+            "startnode" : selection,
             "sopoutput": output_path
         }
 
+        # set parms
+        instance_node.setParms(parms)
+
+        # Lock any parameters in this list
+        to_lock = []
+        self.lock_parameters(instance_node, to_lock)
+
+    # Overrides HoudiniCreator.get_network_categories()
+    def get_network_categories(self):
+        return [
+            hou.ropNodeTypeCategory(),
+            hou.sopNodeTypeCategory()
+        ]
+
+    def get_selection(self):
+        """Selection Logic.
+
+        how self.selected_nodes should be processed to get
+        the desirable node from selection.
+
+        Returns:
+            str : node path
+        """
+
+        selection = ""
+
         if self.selected_nodes:
             selected_node = self.selected_nodes[0]
 
@@ -37,7 +75,7 @@ class CreateFilmboxFBX(plugin.HoudiniCreator):
 
             # Allow sop level paths (e.g. /obj/geo1/box1)
             if isinstance(selected_node, hou.SopNode):
-                parms["startnode"] = selected_node.path()
+                selection = selected_node.path()
                 self.log.debug(
                     "Valid SopNode selection, 'Export' in filmboxfbx"
                     " will be set to '%s'."
@@ -54,14 +92,14 @@ class CreateFilmboxFBX(plugin.HoudiniCreator):
                 sop_path = self.get_obj_output(selected_node)
 
                 if sop_path:
-                    parms["startnode"] = sop_path.path()
+                    selection = sop_path.path()
                     self.log.debug(
                         "Valid ObjNode selection, 'Export' in filmboxfbx "
                         "will be set to the child path '%s'."
                         % sop_path
                     )
 
-            if not parms.get("startnode", None):
+            if not selection:
                 self.log.debug(
                     "Selection isn't valid. 'Export' in filmboxfbx will be empty."
                 )
@@ -70,20 +108,12 @@ class CreateFilmboxFBX(plugin.HoudiniCreator):
                 "No Selection. 'Export' in filmboxfbx will be empty."
             )
 
-        instance_node.setParms(parms)
-
-        # Lock any parameters in this list
-        to_lock = []
-        self.lock_parameters(instance_node, to_lock)
-
-    def get_network_categories(self):
-        return [
-            hou.ropNodeTypeCategory(),
-            hou.sopNodeTypeCategory()
-        ]
+        return selection
 
     def get_obj_output(self, obj_node):
-        """Find output node with the smallest 'outputidx'."""
+        """Find output node with the smallest 'outputidx'
+        or return tje node with the render flag instead.
+        """
 
         outputs = obj_node.subnetOutputs()
 

From 9724ea4c84f51e68785cbd54c1d3eef87cdd4a3f Mon Sep 17 00:00:00 2001
From: Mustafa-Zarkash <mustafataherzaky@outlook.com>
Date: Fri, 28 Jul 2023 00:08:23 +0300
Subject: [PATCH 033/366] update create_fbx

---
 openpype/hosts/houdini/plugins/create/create_fbx.py | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/openpype/hosts/houdini/plugins/create/create_fbx.py b/openpype/hosts/houdini/plugins/create/create_fbx.py
index b59a8ccfc6..d4594edcbe 100644
--- a/openpype/hosts/houdini/plugins/create/create_fbx.py
+++ b/openpype/hosts/houdini/plugins/create/create_fbx.py
@@ -1,5 +1,8 @@
 # -*- coding: utf-8 -*-
-"""Creator plugin for creating fbx."""
+"""Creator plugin for creating fbx.
+
+It was made to pratice publish process.
+"""
 from openpype.hosts.houdini.api import plugin
 
 import hou

From 8a431f2d44c967daab56dce3ed06fdfd7bcae0c5 Mon Sep 17 00:00:00 2001
From: Mustafa-Zarkash <mustafataherzaky@outlook.com>
Date: Fri, 28 Jul 2023 00:18:47 +0300
Subject: [PATCH 034/366] update create_fbx

---
 openpype/hosts/houdini/plugins/create/create_fbx.py | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/openpype/hosts/houdini/plugins/create/create_fbx.py b/openpype/hosts/houdini/plugins/create/create_fbx.py
index d4594edcbe..30cc98ddb9 100644
--- a/openpype/hosts/houdini/plugins/create/create_fbx.py
+++ b/openpype/hosts/houdini/plugins/create/create_fbx.py
@@ -31,11 +31,12 @@ class CreateFilmboxFBX(plugin.HoudiniCreator):
         # get the created node
         instance_node = hou.node(instance.get("instance_node"))
 
-        # get output path
+        # Get this node specific parms
+        # 1. get output path
         output_path = hou.text.expandString(
             "$HIP/pyblish/{}.fbx".format(subset_name))
 
-        # get selection
+        # 2. get selection
         selection = self.get_selection()
 
         # parms dictionary

From 1db5d5f838b78a4e807385ab5a202cd13134f1d5 Mon Sep 17 00:00:00 2001
From: Toke Stuart Jepsen <tokejepsen@gmail.com>
Date: Fri, 28 Jul 2023 08:27:37 +0100
Subject: [PATCH 035/366] Ensure legacy_io_distinct is not used in AYON

---
 openpype/hosts/maya/plugins/publish/extract_look.py | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/openpype/hosts/maya/plugins/publish/extract_look.py b/openpype/hosts/maya/plugins/publish/extract_look.py
index 50a6db3bf7..ec01a817b3 100644
--- a/openpype/hosts/maya/plugins/publish/extract_look.py
+++ b/openpype/hosts/maya/plugins/publish/extract_look.py
@@ -18,6 +18,7 @@ from openpype.lib.vendor_bin_utils import find_executable
 from openpype.lib import source_hash, run_subprocess, get_oiio_tools_path
 from openpype.pipeline import legacy_io, publish, KnownPublishError
 from openpype.hosts.maya.api import lib
+from openpype import AYON_SERVER_ENABLED
 
 # Modes for transfer
 COPY = 1
@@ -50,6 +51,12 @@ def find_paths_by_hash(texture_hash):
         str: path to texture if found.
 
     """
+    if AYON_SERVER_ENABLED:
+        raise ValueError(
+            "This is a bug. \"find_paths_by_hash\" is not compatible with "
+            "AYON."
+        )
+
     key = "data.sourceHashes.{0}".format(texture_hash)
     return legacy_io.distinct(key, {"type": "version"})
 

From e4c9275ac36e1900d48a3605f2693a189ab92158 Mon Sep 17 00:00:00 2001
From: Mustafa-Zarkash <mustafataherzaky@outlook.com>
Date: Fri, 28 Jul 2023 20:08:20 +0300
Subject: [PATCH 036/366] update default_variants

---
 openpype/hosts/houdini/plugins/create/create_fbx.py | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/openpype/hosts/houdini/plugins/create/create_fbx.py b/openpype/hosts/houdini/plugins/create/create_fbx.py
index 30cc98ddb9..18fd879ac7 100644
--- a/openpype/hosts/houdini/plugins/create/create_fbx.py
+++ b/openpype/hosts/houdini/plugins/create/create_fbx.py
@@ -15,6 +15,9 @@ class CreateFilmboxFBX(plugin.HoudiniCreator):
     family = "filmboxfbx"
     icon = "fa5s.cubes"
 
+    default_variant = "FBX"
+    default_variants = ["FBX", "Main", "Test"]
+
     # Overrides HoudiniCreator.create()
     def create(self, subset_name, instance_data, pre_create_data):
         # instance_data.pop("active", None)

From 919247b3d4675b5febbb3ebebdc2b92075312399 Mon Sep 17 00:00:00 2001
From: Mustafa-Zarkash <mustafataherzaky@outlook.com>
Date: Fri, 28 Jul 2023 21:17:38 +0300
Subject: [PATCH 037/366] update creator

---
 .../houdini/plugins/create/create_fbx.py      | 20 ++++++++++++++++++-
 1 file changed, 19 insertions(+), 1 deletion(-)

diff --git a/openpype/hosts/houdini/plugins/create/create_fbx.py b/openpype/hosts/houdini/plugins/create/create_fbx.py
index 18fd879ac7..fed1ad0562 100644
--- a/openpype/hosts/houdini/plugins/create/create_fbx.py
+++ b/openpype/hosts/houdini/plugins/create/create_fbx.py
@@ -4,6 +4,7 @@
 It was made to pratice publish process.
 """
 from openpype.hosts.houdini.api import plugin
+from openpype.lib import EnumDef
 
 import hou
 
@@ -42,10 +43,14 @@ class CreateFilmboxFBX(plugin.HoudiniCreator):
         # 2. get selection
         selection = self.get_selection()
 
+        # 3. get Vertex Cache Format
+        vcformat = pre_create_data.get("vcformat")
+
         # parms dictionary
         parms = {
             "startnode" : selection,
-            "sopoutput": output_path
+            "sopoutput": output_path,
+            "vcformat" : vcformat
         }
 
         # set parms
@@ -62,6 +67,19 @@ class CreateFilmboxFBX(plugin.HoudiniCreator):
             hou.sopNodeTypeCategory()
         ]
 
+    # Overrides HoudiniCreator.get_pre_create_attr_defs()
+    def get_pre_create_attr_defs(self):
+        attrs = super().get_pre_create_attr_defs()
+        vcformat = EnumDef("vcformat",
+                            items={
+                                0: "Maya Compatible (MC)",
+                                1: "3DS MAX Compatible (PC2)"
+                            },
+                            default=0,
+                            label="Vertex Cache Format")
+
+        return attrs + [vcformat]
+
     def get_selection(self):
         """Selection Logic.
 

From 7918668e72ec743c63d966cbf1db3f60159292ef Mon Sep 17 00:00:00 2001
From: Mustafa-Zarkash <mustafataherzaky@outlook.com>
Date: Fri, 28 Jul 2023 22:15:59 +0300
Subject: [PATCH 038/366] add Valid Frame Range

---
 .../hosts/houdini/plugins/create/create_fbx.py    | 15 +++++++++++++--
 1 file changed, 13 insertions(+), 2 deletions(-)

diff --git a/openpype/hosts/houdini/plugins/create/create_fbx.py b/openpype/hosts/houdini/plugins/create/create_fbx.py
index fed1ad0562..0345e07ea6 100644
--- a/openpype/hosts/houdini/plugins/create/create_fbx.py
+++ b/openpype/hosts/houdini/plugins/create/create_fbx.py
@@ -46,11 +46,15 @@ class CreateFilmboxFBX(plugin.HoudiniCreator):
         # 3. get Vertex Cache Format
         vcformat = pre_create_data.get("vcformat")
 
+        # 3. get Valid Frame Range
+        trange = pre_create_data.get("trange")
+
         # parms dictionary
         parms = {
             "startnode" : selection,
             "sopoutput": output_path,
-            "vcformat" : vcformat
+            "vcformat" : vcformat,
+            "trange" : trange
         }
 
         # set parms
@@ -77,8 +81,15 @@ class CreateFilmboxFBX(plugin.HoudiniCreator):
                             },
                             default=0,
                             label="Vertex Cache Format")
+        trange = EnumDef("trange",
+                            items={
+                                0: "Render Current Frame",
+                                1: "Render Frame Range"
+                            },
+                            default=0,
+                            label="Valid Frame Range")
 
-        return attrs + [vcformat]
+        return attrs + [vcformat, trange]
 
     def get_selection(self):
         """Selection Logic.

From ed2a48e2cd9af28fdd45237cecd9d1d9c17eab7e Mon Sep 17 00:00:00 2001
From: Mustafa-Zarkash <mustafataherzaky@outlook.com>
Date: Sat, 29 Jul 2023 02:28:02 +0300
Subject: [PATCH 039/366] add fbx collector

---
 .../plugins/publish/collect_fbx_type.py       | 56 +++++++++++++++++++
 1 file changed, 56 insertions(+)
 create mode 100644 openpype/hosts/houdini/plugins/publish/collect_fbx_type.py

diff --git a/openpype/hosts/houdini/plugins/publish/collect_fbx_type.py b/openpype/hosts/houdini/plugins/publish/collect_fbx_type.py
new file mode 100644
index 0000000000..f25dbf3a5b
--- /dev/null
+++ b/openpype/hosts/houdini/plugins/publish/collect_fbx_type.py
@@ -0,0 +1,56 @@
+"""Collector for filmboxfbx types.
+
+A Collector can act as a preprocessor for the validation stage.
+It is used mainly to update instance.data
+
+P.S.
+    There are some collectors that run by default for all types.
+"""
+import pyblish.api
+
+
+class CollectFilmboxfbxType(pyblish.api.InstancePlugin):
+    """Collect data type for filmboxfbx instance."""
+
+    order = pyblish.api.CollectorOrder
+    hosts = ["houdini"]
+    families = ["filmboxfbx"]
+    label = "Collect type of filmboxfbx"
+
+    def process(self, instance):
+
+        if instance.data["creator_identifier"] == "io.openpype.creators.houdini.filmboxfbx":  # noqa: E501
+            # such a condition can be used to differentiate between
+            #  instances by identifier even if they have the same type.
+            pass
+
+        # Update instance.data with ouptut_node
+        out_node = self.get_output_node(instance)
+
+        if out_node:
+            instance.data["output_node"] = out_node
+
+        # Disclaimer : As a convntin we use collect_output_node.py
+        #   to Update instance.data with ouptut_node of different types
+        #   however, we use this collector instead for demonstration
+
+
+    def get_output_node(self, instance):
+        """Getting output_node Logic.
+
+        It's moved here so that it become easier to focus on
+        process method.
+        """
+
+        import hou
+
+        # get output node
+        node = hou.node(instance.data["instance_node"])
+        out_node = node.parm("startnode").evalAsNode()
+
+        if not out_node:
+            self.log.warning("No output node collected.")
+            return
+
+        self.log.debug("Output node: %s" % out_node.path())
+        return out_node

From 051f03f4fa4e4718c6be56878ae2f8b07b5a3a11 Mon Sep 17 00:00:00 2001
From: Mustafa-Zarkash <mustafataherzaky@outlook.com>
Date: Mon, 31 Jul 2023 21:00:16 +0300
Subject: [PATCH 040/366] add export validator

---
 .../publish/validate_fbx_export_node.py       | 43 +++++++++++++++++++
 1 file changed, 43 insertions(+)
 create mode 100644 openpype/hosts/houdini/plugins/publish/validate_fbx_export_node.py

diff --git a/openpype/hosts/houdini/plugins/publish/validate_fbx_export_node.py b/openpype/hosts/houdini/plugins/publish/validate_fbx_export_node.py
new file mode 100644
index 0000000000..f9f2461415
--- /dev/null
+++ b/openpype/hosts/houdini/plugins/publish/validate_fbx_export_node.py
@@ -0,0 +1,43 @@
+# -*- coding: utf-8 -*-
+"""Validator plugin for Export node in filmbox instance."""
+import pyblish.api
+from openpype.pipeline import PublishValidationError
+
+
+class ValidateNoExportPath(pyblish.api.InstancePlugin):
+    """Validate if Export node in filmboxfbx instance exists."""
+
+    order = pyblish.api.ValidatorOrder
+    families = ["filmboxfbx"]
+    label = "Validate Filmbox Export Node"
+
+    def process(self, instance):
+
+        invalid = self.get_invalid(instance)
+        if invalid:
+            raise PublishValidationError(
+                "Export node is incorrect",
+                title="Invalid Export Node"
+            )
+
+    @classmethod
+    def get_invalid(cls, instance):
+
+        import hou
+
+        fbx_rop = hou.node(instance.data.get("instance_node"))
+        export_node = fbx_rop.parm("startnode").evalAsNode()
+
+        if not export_node:
+            cls.log.error(
+                ("Empty Export ('Export' parameter) found in "
+                 "the filmbox instance - {}".format(fbx_rop.path()))
+            )
+            return [fbx_rop]
+
+        if not isinstance(export_node, hou.SopNode):
+            cls.log.error(
+                "Export node '{}' is not pointing to valid SOP"
+                " node".format(export_node.path())
+            )
+            return [export_node]

From ecc583f8f2eec059e8589e6c45934540085aad34 Mon Sep 17 00:00:00 2001
From: Mustafa-Zarkash <mustafataherzaky@outlook.com>
Date: Tue, 1 Aug 2023 22:04:04 +0300
Subject: [PATCH 041/366] update create collect validate

---
 .../houdini/plugins/create/create_fbx.py      |  11 +-
 .../plugins/publish/collect_fbx_type.py       |   1 +
 .../publish/validate_fbx_export_node.py       |  43 ----
 .../publish/validate_fbx_hierarchy_path.py    | 220 ++++++++++++++++++
 .../publish/validate_sop_output_node.py       |   2 +-
 5 files changed, 231 insertions(+), 46 deletions(-)
 delete mode 100644 openpype/hosts/houdini/plugins/publish/validate_fbx_export_node.py
 create mode 100644 openpype/hosts/houdini/plugins/publish/validate_fbx_hierarchy_path.py

diff --git a/openpype/hosts/houdini/plugins/create/create_fbx.py b/openpype/hosts/houdini/plugins/create/create_fbx.py
index 0345e07ea6..ee2fdcd73f 100644
--- a/openpype/hosts/houdini/plugins/create/create_fbx.py
+++ b/openpype/hosts/houdini/plugins/create/create_fbx.py
@@ -2,7 +2,14 @@
 """Creator plugin for creating fbx.
 
 It was made to pratice publish process.
+
+Filmbox by default expects an ObjNode
+it's by default selects the output sop with mimimum idx
+or the node with render flag isntead.
+
+to eleminate any confusion, we set the sop node explictly.
 """
+
 from openpype.hosts.houdini.api import plugin
 from openpype.lib import EnumDef
 
@@ -16,8 +23,8 @@ class CreateFilmboxFBX(plugin.HoudiniCreator):
     family = "filmboxfbx"
     icon = "fa5s.cubes"
 
-    default_variant = "FBX"
-    default_variants = ["FBX", "Main", "Test"]
+    default_variant = "Main"
+    default_variants = ["Main", "Test"]
 
     # Overrides HoudiniCreator.create()
     def create(self, subset_name, instance_data, pre_create_data):
diff --git a/openpype/hosts/houdini/plugins/publish/collect_fbx_type.py b/openpype/hosts/houdini/plugins/publish/collect_fbx_type.py
index f25dbf3a5b..05a0af659f 100644
--- a/openpype/hosts/houdini/plugins/publish/collect_fbx_type.py
+++ b/openpype/hosts/houdini/plugins/publish/collect_fbx_type.py
@@ -17,6 +17,7 @@ class CollectFilmboxfbxType(pyblish.api.InstancePlugin):
     families = ["filmboxfbx"]
     label = "Collect type of filmboxfbx"
 
+    # overrides InstancePlugin.process()
     def process(self, instance):
 
         if instance.data["creator_identifier"] == "io.openpype.creators.houdini.filmboxfbx":  # noqa: E501
diff --git a/openpype/hosts/houdini/plugins/publish/validate_fbx_export_node.py b/openpype/hosts/houdini/plugins/publish/validate_fbx_export_node.py
deleted file mode 100644
index f9f2461415..0000000000
--- a/openpype/hosts/houdini/plugins/publish/validate_fbx_export_node.py
+++ /dev/null
@@ -1,43 +0,0 @@
-# -*- coding: utf-8 -*-
-"""Validator plugin for Export node in filmbox instance."""
-import pyblish.api
-from openpype.pipeline import PublishValidationError
-
-
-class ValidateNoExportPath(pyblish.api.InstancePlugin):
-    """Validate if Export node in filmboxfbx instance exists."""
-
-    order = pyblish.api.ValidatorOrder
-    families = ["filmboxfbx"]
-    label = "Validate Filmbox Export Node"
-
-    def process(self, instance):
-
-        invalid = self.get_invalid(instance)
-        if invalid:
-            raise PublishValidationError(
-                "Export node is incorrect",
-                title="Invalid Export Node"
-            )
-
-    @classmethod
-    def get_invalid(cls, instance):
-
-        import hou
-
-        fbx_rop = hou.node(instance.data.get("instance_node"))
-        export_node = fbx_rop.parm("startnode").evalAsNode()
-
-        if not export_node:
-            cls.log.error(
-                ("Empty Export ('Export' parameter) found in "
-                 "the filmbox instance - {}".format(fbx_rop.path()))
-            )
-            return [fbx_rop]
-
-        if not isinstance(export_node, hou.SopNode):
-            cls.log.error(
-                "Export node '{}' is not pointing to valid SOP"
-                " node".format(export_node.path())
-            )
-            return [export_node]
diff --git a/openpype/hosts/houdini/plugins/publish/validate_fbx_hierarchy_path.py b/openpype/hosts/houdini/plugins/publish/validate_fbx_hierarchy_path.py
new file mode 100644
index 0000000000..24f88b384f
--- /dev/null
+++ b/openpype/hosts/houdini/plugins/publish/validate_fbx_hierarchy_path.py
@@ -0,0 +1,220 @@
+# -*- coding: utf-8 -*-
+"""It's almost the same as
+'validate_primitive_hierarchy_paths.py'
+however this one includes more comments for demonstration.
+
+FYI, path for fbx behaves a little differently.
+In maya terms:
+in Filmbox FBX: it sets the name of the object
+in Alembic ROP: it sets the name of the shape
+"""
+
+import pyblish.api
+from openpype.pipeline import PublishValidationError
+from openpype.pipeline.publish import (
+    ValidateContentsOrder,
+    RepairAction,
+)
+from openpype.hosts.houdini.api.action import (
+    SelectInvalidAction,
+    SelectROPAction,
+)
+
+import hou
+
+# Each validation can have a single repair action
+# which calls the repair method
+class AddDefaultPathAction(RepairAction):
+    label = "Add a default path"
+    icon = "mdi.pencil-plus-outline"
+
+
+class ValidatePrimitiveHierarchyPaths(pyblish.api.InstancePlugin):
+    """Validate all primitives build hierarchy from attribute
+    when enabled.
+
+    The name of the attribute must exist on the prims and have the
+    same name as Build Hierarchy from Attribute's `Path Attribute`
+    value on the FilmBox node.
+    This validation enables 'Build Hierarchy from Attribute'
+    by default.
+    """
+
+    # Usually you will this value by default
+    order = ValidateContentsOrder + 0.1
+    families = ["filmboxfbx"]
+    hosts = ["houdini"]
+    label = "Validate FBX Hierarchy Path"
+
+    # Validation can have as many actions as you want
+    # all of these actions are defined in a seperate place
+    # unlike the repair action
+    actions = [SelectInvalidAction, AddDefaultPathAction,
+               SelectROPAction]
+
+    # overrides InstancePlugin.process()
+    def process(self, instance):
+        invalid = self.get_invalid(instance)
+        if invalid:
+            nodes = [n.name() for n in invalid]
+            raise PublishValidationError(
+                "See log for details. "
+                "Invalid nodes: {0}".format(nodes),
+                title=self.label
+            )
+
+    # This method was named get_invalid as a convention
+    # it's also used by SelectInvalidAction to select
+    # the returned node
+    @classmethod
+    def get_invalid(cls, instance):
+
+        output_node = instance.data.get("output_node")
+        rop_node = hou.node(instance.data["instance_node"])
+
+        if output_node is None:
+            cls.log.error(
+                "SOP Output node in '%s' does not exist. "
+                "Ensure a valid SOP output path is set.",
+                rop_node.path()
+            )
+
+            return [rop_node]
+
+        build_from_path = rop_node.parm("buildfrompath").eval()
+        if not build_from_path:
+            cls.log.debug(
+                "Filmbox FBX has 'Build from Path' disabled. "
+                "Enbaling it as default."
+            )
+            rop_node.parm("buildfrompath").set(1)
+
+        path_attr = rop_node.parm("pathattrib").eval()
+        if not path_attr:
+            cls.log.debug(
+                "Filmbox FBX node has no Path Attribute"
+                "value set, setting it to 'path' as default."
+            )
+            rop_node.parm("pathattrib").set("path")
+
+        cls.log.debug("Checking for attribute: %s", path_attr)
+
+        if not hasattr(output_node, "geometry"):
+            # In the case someone has explicitly set an Object
+            # node instead of a SOP node in Geometry context
+            # then for now we ignore - this allows us to also
+            # export object transforms.
+            cls.log.warning("No geometry output node found,"
+                            " skipping check..")
+            return
+
+        # Check if the primitive attribute exists
+        frame = instance.data.get("frameStart", 0)
+        geo = output_node.geometryAtFrame(frame)
+
+        # If there are no primitives on the current frame then
+        # we can't check whether the path names are correct.
+        # So we'll just issue a warning that the check can't
+        # be done consistently and skip validation.
+
+        if len(geo.iterPrims()) == 0:
+            cls.log.warning(
+                "No primitives found on current frame."
+                " Validation for primitive hierarchy"
+                " paths will be skipped,"
+                " thus can't be validated."
+            )
+            return
+
+        # Check if there are any values for the primitives
+        attrib = geo.findPrimAttrib(path_attr)
+        if not attrib:
+            cls.log.info(
+                "Geometry Primitives are missing "
+                "path attribute: `%s`", path_attr
+            )
+            return [output_node]
+
+        # Ensure at least a single string value is present
+        if not attrib.strings():
+            cls.log.info(
+                "Primitive path attribute has no "
+                "string values: %s", path_attr
+            )
+            return [output_node]
+
+        paths = geo.primStringAttribValues(path_attr)
+        # Ensure all primitives are set to a valid path
+        # Collect all invalid primitive numbers
+        invalid_prims = [i for i, path in enumerate(paths) if not path]
+        if invalid_prims:
+            num_prims = len(geo.iterPrims())  # faster than len(geo.prims())
+            cls.log.info(
+                "Prims have no value for attribute `%s` "
+                "(%s of %s prims)",
+                path_attr, len(invalid_prims), num_prims
+            )
+            return [output_node]
+
+    # what repair action expects to find and call
+    @classmethod
+    def repair(cls, instance):
+        """Add a default path attribute Action.
+
+        It is a helper action more than a repair action,
+        used to add a default single value for the path.
+        """
+
+        rop_node = hou.node(instance.data["instance_node"])
+        # I'm doing so because an artist may change output node
+        # before clicking the button.
+        output_node = rop_node.parm("startnode").evalAsNode()
+
+        if not output_node:
+            cls.log.debug(
+                "Action isn't performed, invalid SOP Path on %s",
+                rop_node
+            )
+            return
+
+        # This check to prevent the action from running multiple times.
+        # git_invalid only returns [output_node] when
+        #   path attribute is the problem
+        if cls.get_invalid(instance) != [output_node]:
+            return
+
+        path_attr = rop_node.parm("pathattrib").eval()
+
+        path_node = output_node.parent().createNode("name",
+                                                    "AUTO_PATH")
+        path_node.parm("attribname").set(path_attr)
+        path_node.parm("name1").set('`opname("..")`_GEO')
+
+        cls.log.debug(
+            "'%s' was created. It adds '%s' with a default"
+            " single value", path_node, path_attr
+        )
+
+        path_node.setGenericFlag(hou.nodeFlag.DisplayComment, True)
+        path_node.setComment(
+            'Auto path node was created automatically by '
+            '"Add a default path attribute"'
+            '\nFeel free to modify or replace it.'
+        )
+
+        if output_node.type().name() in ["null", "output"]:
+            # Connect before
+            path_node.setFirstInput(output_node.input(0))
+            path_node.moveToGoodPosition()
+            output_node.setFirstInput(path_node)
+            output_node.moveToGoodPosition()
+        else:
+            # Connect after
+            path_node.setFirstInput(output_node)
+            rop_node.parm("startnode").set(path_node.path())
+            path_node.moveToGoodPosition()
+
+            cls.log.debug(
+                "SOP path on '%s' updated to new output node '%s'",
+                rop_node, path_node
+            )
diff --git a/openpype/hosts/houdini/plugins/publish/validate_sop_output_node.py b/openpype/hosts/houdini/plugins/publish/validate_sop_output_node.py
index d9dee38680..da9752505a 100644
--- a/openpype/hosts/houdini/plugins/publish/validate_sop_output_node.py
+++ b/openpype/hosts/houdini/plugins/publish/validate_sop_output_node.py
@@ -22,7 +22,7 @@ class ValidateSopOutputNode(pyblish.api.InstancePlugin):
     """
 
     order = pyblish.api.ValidatorOrder
-    families = ["pointcache", "vdbcache"]
+    families = ["pointcache", "vdbcache", "filmboxfbx"]
     hosts = ["houdini"]
     label = "Validate Output Node"
     actions = [SelectROPAction, SelectInvalidAction]

From 0a7d6aa31845a172dea4899f98a99bac66d806d8 Mon Sep 17 00:00:00 2001
From: Mustafa-Zarkash <mustafataherzaky@outlook.com>
Date: Tue, 1 Aug 2023 22:09:01 +0300
Subject: [PATCH 042/366] update validate

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

diff --git a/openpype/hosts/houdini/plugins/publish/validate_fbx_hierarchy_path.py b/openpype/hosts/houdini/plugins/publish/validate_fbx_hierarchy_path.py
index 24f88b384f..7e890db58e 100644
--- a/openpype/hosts/houdini/plugins/publish/validate_fbx_hierarchy_path.py
+++ b/openpype/hosts/houdini/plugins/publish/validate_fbx_hierarchy_path.py
@@ -56,7 +56,7 @@ class ValidatePrimitiveHierarchyPaths(pyblish.api.InstancePlugin):
     def process(self, instance):
         invalid = self.get_invalid(instance)
         if invalid:
-            nodes = [n.name() for n in invalid]
+            nodes = [n.path() for n in invalid]
             raise PublishValidationError(
                 "See log for details. "
                 "Invalid nodes: {0}".format(nodes),

From 39225ee0479c0bdf257d02fcfff236d105806fd6 Mon Sep 17 00:00:00 2001
From: Mustafa-Zarkash <mustafataherzaky@outlook.com>
Date: Tue, 1 Aug 2023 22:54:05 +0300
Subject: [PATCH 043/366] add fbx extractor

---
 .../houdini/plugins/publish/extract_fbx.py    | 50 +++++++++++++++++++
 1 file changed, 50 insertions(+)
 create mode 100644 openpype/hosts/houdini/plugins/publish/extract_fbx.py

diff --git a/openpype/hosts/houdini/plugins/publish/extract_fbx.py b/openpype/hosts/houdini/plugins/publish/extract_fbx.py
new file mode 100644
index 0000000000..70bf3e1017
--- /dev/null
+++ b/openpype/hosts/houdini/plugins/publish/extract_fbx.py
@@ -0,0 +1,50 @@
+import os
+
+import pyblish.api
+
+from openpype.pipeline import publish
+from openpype.hosts.houdini.api.lib import render_rop
+
+import hou
+
+
+class ExtractRedshiftProxy(publish.Extractor):
+
+    order = pyblish.api.ExtractorOrder + 0.1
+    label = "Extract FilmBox FBX"
+    families = ["filmboxfbx"]
+    hosts = ["houdini"]
+
+    # overrides InstancePlugin.process()
+    def process(self, instance):
+
+        ropnode = hou.node(instance.data.get("instance_node"))
+
+        # Get the filename from the filename parameter
+        # `.evalParm(parameter)` will make sure all tokens are resolved
+        output = ropnode.evalParm("sopoutput")
+        staging_dir = os.path.normpath(os.path.dirname(output))
+        instance.data["stagingDir"] = staging_dir
+        file_name = os.path.basename(output)
+
+        self.log.info("Writing FBX '%s' to '%s'" % (file_name,
+                                                    staging_dir))
+
+        render_rop(ropnode)
+
+        if "representations" not in instance.data:
+            instance.data["representations"] = []
+
+        representation = {
+            "name": "fbx",
+            "ext": "fbx",
+            "files": file_name,
+            "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)

From b507c2d52b2b2ad23ec1d300e8f5d8cbbd97fb58 Mon Sep 17 00:00:00 2001
From: Mustafa-Zarkash <mustafataherzaky@outlook.com>
Date: Tue, 1 Aug 2023 23:03:55 +0300
Subject: [PATCH 044/366] register filmbox family in integrate.py

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

diff --git a/openpype/plugins/publish/integrate.py b/openpype/plugins/publish/integrate.py
index ffb9acf4a7..05ffe0bd3d 100644
--- a/openpype/plugins/publish/integrate.py
+++ b/openpype/plugins/publish/integrate.py
@@ -138,7 +138,8 @@ class IntegrateAsset(pyblish.api.InstancePlugin):
                 "simpleUnrealTexture",
                 "online",
                 "uasset",
-                "blendScene"
+                "blendScene",
+                "filmboxfbx"
                 ]
 
     default_template_name = "publish"

From 686ba073cef895b17bc6393e4a4dd9bbb4bf73f5 Mon Sep 17 00:00:00 2001
From: Mustafa-Zarkash <mustafataherzaky@outlook.com>
Date: Tue, 1 Aug 2023 23:06:40 +0300
Subject: [PATCH 045/366] update comments

---
 openpype/hosts/houdini/plugins/publish/collect_fbx_type.py     | 1 +
 openpype/hosts/houdini/plugins/publish/extract_fbx.py          | 3 ++-
 .../houdini/plugins/publish/validate_fbx_hierarchy_path.py     | 2 +-
 3 files changed, 4 insertions(+), 2 deletions(-)

diff --git a/openpype/hosts/houdini/plugins/publish/collect_fbx_type.py b/openpype/hosts/houdini/plugins/publish/collect_fbx_type.py
index 05a0af659f..c665852bb6 100644
--- a/openpype/hosts/houdini/plugins/publish/collect_fbx_type.py
+++ b/openpype/hosts/houdini/plugins/publish/collect_fbx_type.py
@@ -12,6 +12,7 @@ import pyblish.api
 class CollectFilmboxfbxType(pyblish.api.InstancePlugin):
     """Collect data type for filmboxfbx instance."""
 
+    # Usually you will use this value as default
     order = pyblish.api.CollectorOrder
     hosts = ["houdini"]
     families = ["filmboxfbx"]
diff --git a/openpype/hosts/houdini/plugins/publish/extract_fbx.py b/openpype/hosts/houdini/plugins/publish/extract_fbx.py
index 70bf3e1017..6a4b541c33 100644
--- a/openpype/hosts/houdini/plugins/publish/extract_fbx.py
+++ b/openpype/hosts/houdini/plugins/publish/extract_fbx.py
@@ -10,12 +10,13 @@ import hou
 
 class ExtractRedshiftProxy(publish.Extractor):
 
+    # Usually you will use this value as default
     order = pyblish.api.ExtractorOrder + 0.1
     label = "Extract FilmBox FBX"
     families = ["filmboxfbx"]
     hosts = ["houdini"]
 
-    # overrides InstancePlugin.process()
+    # overrides Extractor.process()
     def process(self, instance):
 
         ropnode = hou.node(instance.data.get("instance_node"))
diff --git a/openpype/hosts/houdini/plugins/publish/validate_fbx_hierarchy_path.py b/openpype/hosts/houdini/plugins/publish/validate_fbx_hierarchy_path.py
index 7e890db58e..871b347155 100644
--- a/openpype/hosts/houdini/plugins/publish/validate_fbx_hierarchy_path.py
+++ b/openpype/hosts/houdini/plugins/publish/validate_fbx_hierarchy_path.py
@@ -40,7 +40,7 @@ class ValidatePrimitiveHierarchyPaths(pyblish.api.InstancePlugin):
     by default.
     """
 
-    # Usually you will this value by default
+    # Usually you will use this value as default
     order = ValidateContentsOrder + 0.1
     families = ["filmboxfbx"]
     hosts = ["houdini"]

From 7a74608b11bfd891d52b92ae2bdf78ebf3dcd468 Mon Sep 17 00:00:00 2001
From: Mustafa-Zarkash <mustafataherzaky@outlook.com>
Date: Thu, 3 Aug 2023 21:42:26 +0300
Subject: [PATCH 046/366] add loader

---
 .../hosts/houdini/plugins/load/load_fbx.py    | 118 ++++++++++++++++++
 1 file changed, 118 insertions(+)
 create mode 100644 openpype/hosts/houdini/plugins/load/load_fbx.py

diff --git a/openpype/hosts/houdini/plugins/load/load_fbx.py b/openpype/hosts/houdini/plugins/load/load_fbx.py
new file mode 100644
index 0000000000..e69bdbb10a
--- /dev/null
+++ b/openpype/hosts/houdini/plugins/load/load_fbx.py
@@ -0,0 +1,118 @@
+# -*- coding: utf-8 -*-
+"""Fbx Loader for houdini.
+
+It's an exact copy of
+'load_bgeo.py'
+however this one includes extra comments for demonstration.
+
+This plugin is part of publish process guide.
+"""
+import os
+import re
+
+from openpype.pipeline import (
+    load,
+    get_representation_path,
+)
+from openpype.hosts.houdini.api import pipeline
+
+
+class FbxLoader(load.LoaderPlugin):
+    """Load fbx files to Houdini."""
+
+    label = "Load FBX"
+    families = ["filmboxfbx", "fbx"]
+    representations = ["fbx"]
+    order = -10
+    icon = "code-fork"
+    color = "orange"
+
+    def load(self, context, name=None, namespace=None, data=None):
+
+        import hou
+
+        # Get the root node
+        obj = hou.node("/obj")
+
+        # Define node name
+        namespace = namespace if namespace else context["asset"]["name"]
+        node_name = "{}_{}".format(namespace, name) if namespace else name
+
+        # 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
+        file_node = container.node("file1")
+        if file_node:
+            file_node.destroy()
+
+        # Explicitly create a file node
+        path = self.filepath_from_context(context)
+        file_node = container.createNode("file", node_name=node_name)
+        file_node.setParms(
+            {"file": self.format_path(path, context["representation"])})
+
+        # Set display on last node
+        file_node.setDisplayFlag(True)
+
+        nodes = [container, file_node]
+        self[:] = nodes
+
+        return pipeline.containerise(
+            node_name,
+            namespace,
+            nodes,
+            context,
+            self.__class__.__name__,
+            suffix="",
+        )
+
+    @staticmethod
+    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
+        else:
+            filename = re.sub(r"(.*)\.(\d+)\.(bgeo.*)", "\\1.$F4.\\3", path)
+
+            filename = os.path.join(path, filename)
+
+        filename = os.path.normpath(filename)
+        filename = filename.replace("\\", "/")
+
+        return filename
+
+    def update(self, container, representation):
+
+        node = container["node"]
+        try:
+            file_node = next(
+                n for n in node.children() if n.type().name() == "file"
+            )
+        except StopIteration:
+            self.log.error("Could not find node of type `file`")
+            return
+
+        # Update the file path
+        file_path = get_representation_path(representation)
+        file_path = self.format_path(file_path, representation)
+
+        file_node.setParms({"file": file_path})
+
+        # Update attribute
+        node.setParms({"representation": str(representation["_id"])})
+
+    def remove(self, container):
+
+        node = container["node"]
+        node.destroy()
+
+    def switch(self, container, representation):
+        self.update(container, representation)

From a1b0c409aca7af1f9d44563bc4c797d884b67b5a Mon Sep 17 00:00:00 2001
From: Mustafa-Zarkash <mustafataherzaky@outlook.com>
Date: Thu, 3 Aug 2023 21:43:50 +0300
Subject: [PATCH 047/366] update doc strings

---
 openpype/hosts/houdini/plugins/create/create_fbx.py       | 2 ++
 .../hosts/houdini/plugins/publish/collect_fbx_type.py     | 2 ++
 .../plugins/publish/validate_fbx_hierarchy_path.py        | 8 ++++++--
 3 files changed, 10 insertions(+), 2 deletions(-)

diff --git a/openpype/hosts/houdini/plugins/create/create_fbx.py b/openpype/hosts/houdini/plugins/create/create_fbx.py
index ee2fdcd73f..ac76dc0441 100644
--- a/openpype/hosts/houdini/plugins/create/create_fbx.py
+++ b/openpype/hosts/houdini/plugins/create/create_fbx.py
@@ -8,6 +8,8 @@ it's by default selects the output sop with mimimum idx
 or the node with render flag isntead.
 
 to eleminate any confusion, we set the sop node explictly.
+
+This plugin is part of publish process guide.
 """
 
 from openpype.hosts.houdini.api import plugin
diff --git a/openpype/hosts/houdini/plugins/publish/collect_fbx_type.py b/openpype/hosts/houdini/plugins/publish/collect_fbx_type.py
index c665852bb6..f1665b27f0 100644
--- a/openpype/hosts/houdini/plugins/publish/collect_fbx_type.py
+++ b/openpype/hosts/houdini/plugins/publish/collect_fbx_type.py
@@ -5,6 +5,8 @@ It is used mainly to update instance.data
 
 P.S.
     There are some collectors that run by default for all types.
+
+This plugin is part of publish process guide.
 """
 import pyblish.api
 
diff --git a/openpype/hosts/houdini/plugins/publish/validate_fbx_hierarchy_path.py b/openpype/hosts/houdini/plugins/publish/validate_fbx_hierarchy_path.py
index 871b347155..6a2bda1bca 100644
--- a/openpype/hosts/houdini/plugins/publish/validate_fbx_hierarchy_path.py
+++ b/openpype/hosts/houdini/plugins/publish/validate_fbx_hierarchy_path.py
@@ -1,12 +1,16 @@
 # -*- coding: utf-8 -*-
-"""It's almost the same as
+"""Validate path attribute for all primitives.
+
+It's almost the same as
 'validate_primitive_hierarchy_paths.py'
-however this one includes more comments for demonstration.
+however this one includes extra comments for demonstration.
 
 FYI, path for fbx behaves a little differently.
 In maya terms:
 in Filmbox FBX: it sets the name of the object
 in Alembic ROP: it sets the name of the shape
+
+This plugin is part of publish process guide.
 """
 
 import pyblish.api

From 08fdbf1283151e2109f1649321700ea8697c261d Mon Sep 17 00:00:00 2001
From: Mustafa-Zarkash <mustafataherzaky@outlook.com>
Date: Thu, 3 Aug 2023 23:34:32 +0300
Subject: [PATCH 048/366] make loader look prettier

---
 .../hosts/houdini/plugins/load/load_fbx.py    | 151 +++++++++++-------
 1 file changed, 96 insertions(+), 55 deletions(-)

diff --git a/openpype/hosts/houdini/plugins/load/load_fbx.py b/openpype/hosts/houdini/plugins/load/load_fbx.py
index e69bdbb10a..5afd39ea99 100644
--- a/openpype/hosts/houdini/plugins/load/load_fbx.py
+++ b/openpype/hosts/houdini/plugins/load/load_fbx.py
@@ -23,71 +23,25 @@ class FbxLoader(load.LoaderPlugin):
     label = "Load FBX"
     families = ["filmboxfbx", "fbx"]
     representations = ["fbx"]
-    order = -10
-    icon = "code-fork"
-    color = "orange"
+    order = -10  # you can use this by default.
+    icon = "code-fork"  # you can use this by default.
+    color = "orange"  # you can use this by default.
 
     def load(self, context, name=None, namespace=None, data=None):
 
-        import hou
+        file_path = self.get_file_path(context)
 
-        # Get the root node
-        obj = hou.node("/obj")
+        namespace, node_name = self.get_node_name(context, name, namespace)
 
-        # Define node name
-        namespace = namespace if namespace else context["asset"]["name"]
-        node_name = "{}_{}".format(namespace, name) if namespace else name
+        nodes = self.create_load_node_tree(file_path, node_name, name)
 
-        # 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
-        file_node = container.node("file1")
-        if file_node:
-            file_node.destroy()
-
-        # Explicitly create a file node
-        path = self.filepath_from_context(context)
-        file_node = container.createNode("file", node_name=node_name)
-        file_node.setParms(
-            {"file": self.format_path(path, context["representation"])})
-
-        # Set display on last node
-        file_node.setDisplayFlag(True)
-
-        nodes = [container, file_node]
         self[:] = nodes
 
-        return pipeline.containerise(
-            node_name,
-            namespace,
-            nodes,
-            context,
-            self.__class__.__name__,
-            suffix="",
+        containerised_nodes = self.get_containerised_nodes(
+            nodes, context, node_name, namespace
         )
 
-    @staticmethod
-    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
-        else:
-            filename = re.sub(r"(.*)\.(\d+)\.(bgeo.*)", "\\1.$F4.\\3", path)
-
-            filename = os.path.join(path, filename)
-
-        filename = os.path.normpath(filename)
-        filename = filename.replace("\\", "/")
-
-        return filename
+        return containerised_nodes
 
     def update(self, container, representation):
 
@@ -116,3 +70,90 @@ class FbxLoader(load.LoaderPlugin):
 
     def switch(self, container, representation):
         self.update(container, representation)
+
+    def get_file_path(self, context):
+        """Return formatted file path."""
+
+        # Format file name, Houdini only wants forward slashes
+        file_path = self.filepath_from_context(context)
+        file_path = os.path.normpath(file_path)
+        file_path = file_path.replace("\\", "/")
+
+        return file_path
+
+    def get_node_name(self, context, name=None, namespace=None):
+        """Define node name."""
+
+        if not namespace:
+            namespace = context["asset"]["name"]
+
+        if namespace:
+            node_name = "{}_{}".format(namespace, name)
+        else:
+            node_name = name
+
+        return namespace, node_name
+
+    def create_load_node_tree(self, file_path, node_name, subset_name):
+        """Create Load node network.
+
+        you can start building your tree at any obj level.
+        it'll be much easier to build it in the root obj level.
+
+        Afterwards, your tree will be automatically moved to
+        '/obj/AVALON_CONTAINERS' subnetwork.
+        """
+        import hou
+
+        # Get the root obj level
+        obj = hou.node("/obj")
+
+        # Create a new obj geo node
+        parent_node = obj.createNode("geo", node_name=node_name)
+
+        # In older houdini,
+        # when reating a new obj geo node, a default file node will be
+        # automatically created.
+        # so, we will delete it if exists.
+        file_node = parent_node.node("file1")
+        if file_node:
+            file_node.destroy()
+
+        # Create a new file node
+        file_node = parent_node.createNode("file", node_name= node_name)
+        file_node.setParms({"file":file_path})
+
+        # Create attribute delete
+        attribdelete_name = "attribdelete_{}".format(subset_name)
+        attribdelete = parent_node.createNode("attribdelete",
+                                              node_name= attribdelete_name)
+        attribdelete.setParms({"ptdel":"fbx_*"})
+        attribdelete.setInput(0, file_node)
+
+        # Create a Null node
+        null_name = "OUT_{}".format(subset_name)
+        null = parent_node.createNode("null", node_name= null_name)
+        null.setInput(0, attribdelete)
+
+        # Ensure display flag is on the file_node input node and not on the OUT
+        # node to optimize "debug" displaying in the viewport.
+        file_node.setDisplayFlag(True)
+
+        # Set new position for unpack node else it gets cluttered
+        nodes = [parent_node, file_node, attribdelete, null]
+        for nr, node in enumerate(nodes):
+            node.setPosition([0, (0 - nr)])
+
+        return nodes
+
+    def get_containerised_nodes(self, nodes, context, node_name, namespace):
+        containerised_nodes = pipeline.containerise(
+            node_name,
+            namespace,
+            nodes,
+            context,
+            self.__class__.__name__,
+            suffix="",
+        )
+
+        return containerised_nodes

From de56b53ac6c48f0ca73b9111ce0edbf73d02d950 Mon Sep 17 00:00:00 2001
From: Mustafa-Zarkash <mustafataherzaky@outlook.com>
Date: Thu, 3 Aug 2023 23:35:28 +0300
Subject: [PATCH 049/366] update doc string

---
 openpype/hosts/houdini/plugins/load/load_fbx.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/openpype/hosts/houdini/plugins/load/load_fbx.py b/openpype/hosts/houdini/plugins/load/load_fbx.py
index 5afd39ea99..6bac7a7cec 100644
--- a/openpype/hosts/houdini/plugins/load/load_fbx.py
+++ b/openpype/hosts/houdini/plugins/load/load_fbx.py
@@ -1,8 +1,8 @@
 # -*- coding: utf-8 -*-
 """Fbx Loader for houdini.
 
-It's an exact copy of
-'load_bgeo.py'
+It's almost a copy of
+'load_bgeo.py'and 'load_alembic.py'
 however this one includes extra comments for demonstration.
 
 This plugin is part of publish process guide.

From ba5f7eb417ccf86edccb4a3b1ef2b6dfe64fecca Mon Sep 17 00:00:00 2001
From: Mustafa-Zarkash <mustafataherzaky@outlook.com>
Date: Thu, 3 Aug 2023 23:36:33 +0300
Subject: [PATCH 050/366] remove un-necessary import

---
 openpype/hosts/houdini/plugins/load/load_fbx.py | 1 -
 1 file changed, 1 deletion(-)

diff --git a/openpype/hosts/houdini/plugins/load/load_fbx.py b/openpype/hosts/houdini/plugins/load/load_fbx.py
index 6bac7a7cec..3f66c8e88f 100644
--- a/openpype/hosts/houdini/plugins/load/load_fbx.py
+++ b/openpype/hosts/houdini/plugins/load/load_fbx.py
@@ -8,7 +8,6 @@ however this one includes extra comments for demonstration.
 This plugin is part of publish process guide.
 """
 import os
-import re
 
 from openpype.pipeline import (
     load,

From 31f8c4cd13ef4240566f8dbf98af86f2488d3936 Mon Sep 17 00:00:00 2001
From: Mustafa-Zarkash <mustafataherzaky@outlook.com>
Date: Mon, 7 Aug 2023 18:59:04 +0300
Subject: [PATCH 051/366] update fbx creator

---
 .../houdini/plugins/create/create_fbx.py      | 62 +++++++++++--------
 1 file changed, 35 insertions(+), 27 deletions(-)

diff --git a/openpype/hosts/houdini/plugins/create/create_fbx.py b/openpype/hosts/houdini/plugins/create/create_fbx.py
index ac76dc0441..9e1dbea2f4 100644
--- a/openpype/hosts/houdini/plugins/create/create_fbx.py
+++ b/openpype/hosts/houdini/plugins/create/create_fbx.py
@@ -4,10 +4,12 @@
 It was made to pratice publish process.
 
 Filmbox by default expects an ObjNode
-it's by default selects the output sop with mimimum idx
-or the node with render flag isntead.
+however, we set the sop node explictly
+to eleminate any confusion.
 
-to eleminate any confusion, we set the sop node explictly.
+This creator by default will select
+the output sop with mimimum idx
+or the node with render flag isntead.
 
 This plugin is part of publish process guide.
 """
@@ -30,12 +32,11 @@ class CreateFilmboxFBX(plugin.HoudiniCreator):
 
     # Overrides HoudiniCreator.create()
     def create(self, subset_name, instance_data, pre_create_data):
-        # instance_data.pop("active", None)
 
         # set node type
         instance_data.update({"node_type": "filmboxfbx"})
 
-        # set essential extra parameters
+        # create instance (calls super create method)
         instance = super(CreateFilmboxFBX, self).create(
             subset_name,
             instance_data,
@@ -44,33 +45,14 @@ class CreateFilmboxFBX(plugin.HoudiniCreator):
         # get the created node
         instance_node = hou.node(instance.get("instance_node"))
 
-        # Get this node specific parms
-        # 1. get output path
-        output_path = hou.text.expandString(
-            "$HIP/pyblish/{}.fbx".format(subset_name))
-
-        # 2. get selection
-        selection = self.get_selection()
-
-        # 3. get Vertex Cache Format
-        vcformat = pre_create_data.get("vcformat")
-
-        # 3. get Valid Frame Range
-        trange = pre_create_data.get("trange")
-
-        # parms dictionary
-        parms = {
-            "startnode" : selection,
-            "sopoutput": output_path,
-            "vcformat" : vcformat,
-            "trange" : trange
-        }
+        # get parms
+        parms = self.get_parms(subset_name, pre_create_data)
 
         # set parms
         instance_node.setParms(parms)
 
         # Lock any parameters in this list
-        to_lock = []
+        to_lock = ["family", "id"]
         self.lock_parameters(instance_node, to_lock)
 
     # Overrides HoudiniCreator.get_network_categories()
@@ -100,6 +82,32 @@ class CreateFilmboxFBX(plugin.HoudiniCreator):
 
         return attrs + [vcformat, trange]
 
+    def get_parms(self, subset_name, pre_create_data):
+        """Get parameters values for this specific node."""
+
+        # 1. get output path
+        output_path = hou.text.expandString(
+            "$HIP/pyblish/{}.fbx".format(subset_name))
+
+        # 2. get selection
+        selection = self.get_selection()
+
+        # 3. get Vertex Cache Format
+        vcformat = pre_create_data.get("vcformat")
+
+        # 4. get Valid Frame Range
+        trange = pre_create_data.get("trange")
+
+        # parms dictionary
+        parms = {
+            "startnode" : selection,
+            "sopoutput": output_path,
+            "vcformat" : vcformat,
+            "trange" : trange
+        }
+
+        return parms
+
     def get_selection(self):
         """Selection Logic.
 

From b1ac707a68335990970481885f7b3ac6bcbb87c5 Mon Sep 17 00:00:00 2001
From: Mustafa-Zarkash <mustafataherzaky@outlook.com>
Date: Mon, 7 Aug 2023 22:11:01 +0300
Subject: [PATCH 052/366] update plugins for better demonstration

---
 .../houdini/plugins/create/create_fbx.py      |  7 ++-
 .../hosts/houdini/plugins/load/load_fbx.py    |  8 ++--
 .../plugins/publish/collect_fbx_type.py       | 22 ++++-----
 .../houdini/plugins/publish/extract_fbx.py    | 48 +++++++++++++++----
 .../publish/validate_fbx_hierarchy_path.py    | 10 ++--
 5 files changed, 66 insertions(+), 29 deletions(-)

diff --git a/openpype/hosts/houdini/plugins/create/create_fbx.py b/openpype/hosts/houdini/plugins/create/create_fbx.py
index 9e1dbea2f4..2bfdb3e729 100644
--- a/openpype/hosts/houdini/plugins/create/create_fbx.py
+++ b/openpype/hosts/houdini/plugins/create/create_fbx.py
@@ -21,12 +21,15 @@ import hou
 
 
 class CreateFilmboxFBX(plugin.HoudiniCreator):
-    """Filmbox FBX Driver"""
+    """Filmbox FBX Driver."""
+
+    # you should set
     identifier = "io.openpype.creators.houdini.filmboxfbx"
     label = "Filmbox FBX"
     family = "filmboxfbx"
     icon = "fa5s.cubes"
 
+    # optional to set
     default_variant = "Main"
     default_variants = ["Main", "Test"]
 
@@ -36,7 +39,7 @@ class CreateFilmboxFBX(plugin.HoudiniCreator):
         # set node type
         instance_data.update({"node_type": "filmboxfbx"})
 
-        # create instance (calls super create method)
+        # create instance (calls HoudiniCreator.create())
         instance = super(CreateFilmboxFBX, self).create(
             subset_name,
             instance_data,
diff --git a/openpype/hosts/houdini/plugins/load/load_fbx.py b/openpype/hosts/houdini/plugins/load/load_fbx.py
index 3f66c8e88f..993b57ad21 100644
--- a/openpype/hosts/houdini/plugins/load/load_fbx.py
+++ b/openpype/hosts/houdini/plugins/load/load_fbx.py
@@ -22,9 +22,11 @@ class FbxLoader(load.LoaderPlugin):
     label = "Load FBX"
     families = ["filmboxfbx", "fbx"]
     representations = ["fbx"]
-    order = -10  # you can use this by default.
-    icon = "code-fork"  # you can use this by default.
-    color = "orange"  # you can use this by default.
+
+    # Usually you will use these value as default
+    order = -10
+    icon = "code-fork"
+    color = "orange"
 
     def load(self, context, name=None, namespace=None, data=None):
 
diff --git a/openpype/hosts/houdini/plugins/publish/collect_fbx_type.py b/openpype/hosts/houdini/plugins/publish/collect_fbx_type.py
index f1665b27f0..794d8bd6e7 100644
--- a/openpype/hosts/houdini/plugins/publish/collect_fbx_type.py
+++ b/openpype/hosts/houdini/plugins/publish/collect_fbx_type.py
@@ -1,10 +1,11 @@
 """Collector for filmboxfbx types.
 
-A Collector can act as a preprocessor for the validation stage.
+Collectors act as a pre process for the validation stage.
 It is used mainly to update instance.data
 
 P.S.
-    There are some collectors that run by default for all types.
+    There are some collectors that run by default
+    for all types.
 
 This plugin is part of publish process guide.
 """
@@ -14,18 +15,21 @@ import pyblish.api
 class CollectFilmboxfbxType(pyblish.api.InstancePlugin):
     """Collect data type for filmboxfbx instance."""
 
-    # Usually you will use this value as default
-    order = pyblish.api.CollectorOrder
     hosts = ["houdini"]
     families = ["filmboxfbx"]
     label = "Collect type of filmboxfbx"
 
+    # Usually you will use this value as default
+    order = pyblish.api.CollectorOrder
+
     # overrides InstancePlugin.process()
     def process(self, instance):
 
         if instance.data["creator_identifier"] == "io.openpype.creators.houdini.filmboxfbx":  # noqa: E501
             # such a condition can be used to differentiate between
-            #  instances by identifier even if they have the same type.
+            #  instances by identifier becuase sometimes instances
+            #  may have the same family but different identifier
+            #  e.g. bgeo and alembic
             pass
 
         # Update instance.data with ouptut_node
@@ -36,15 +40,11 @@ class CollectFilmboxfbxType(pyblish.api.InstancePlugin):
 
         # Disclaimer : As a convntin we use collect_output_node.py
         #   to Update instance.data with ouptut_node of different types
-        #   however, we use this collector instead for demonstration
+        #   however, this collector is used for demonstration
 
 
     def get_output_node(self, instance):
-        """Getting output_node Logic.
-
-        It's moved here so that it become easier to focus on
-        process method.
-        """
+        """Getting output_node Logic."""
 
         import hou
 
diff --git a/openpype/hosts/houdini/plugins/publish/extract_fbx.py b/openpype/hosts/houdini/plugins/publish/extract_fbx.py
index 6a4b541c33..102b075838 100644
--- a/openpype/hosts/houdini/plugins/publish/extract_fbx.py
+++ b/openpype/hosts/houdini/plugins/publish/extract_fbx.py
@@ -1,3 +1,11 @@
+"""Extract FilmBox FBX.
+
+Extractors are used to generate output and
+update representation dictionary.
+
+This plugin is part of publish process guide.
+"""
+
 import os
 
 import pyblish.api
@@ -10,31 +18,51 @@ import hou
 
 class ExtractRedshiftProxy(publish.Extractor):
 
-    # Usually you will use this value as default
-    order = pyblish.api.ExtractorOrder + 0.1
     label = "Extract FilmBox FBX"
     families = ["filmboxfbx"]
     hosts = ["houdini"]
 
+    # Usually you will use this value as default
+    order = pyblish.api.ExtractorOrder + 0.1
+
     # overrides Extractor.process()
     def process(self, instance):
 
+        # get rop node
         ropnode = hou.node(instance.data.get("instance_node"))
 
-        # Get the filename from the filename parameter
-        # `.evalParm(parameter)` will make sure all tokens are resolved
-        output = ropnode.evalParm("sopoutput")
-        staging_dir = os.path.normpath(os.path.dirname(output))
+        # render rop
+        render_rop(ropnode)
+
+        # get required data
+        file_name, staging_dir = self.get_paths_data(ropnode)
+        representation = self.get_representation(instance,
+                                                 file_name,
+                                                 staging_dir)
+
+        # set value type for 'representations' key to list
+        if "representations" not in instance.data:
+            instance.data["representations"] = []
+
+        # update instance data
         instance.data["stagingDir"] = staging_dir
+        instance.data["representations"].append(representation)
+
+    def get_paths_data(self, ropnode):
+        # Get the filename from the filename parameter
+        output = ropnode.evalParm("sopoutput")
+
+        staging_dir = os.path.normpath(os.path.dirname(output))
+
         file_name = os.path.basename(output)
 
         self.log.info("Writing FBX '%s' to '%s'" % (file_name,
                                                     staging_dir))
 
-        render_rop(ropnode)
+        return file_name, staging_dir
 
-        if "representations" not in instance.data:
-            instance.data["representations"] = []
+    def get_representation(self, instance,
+                           file_name, staging_dir):
 
         representation = {
             "name": "fbx",
@@ -48,4 +76,4 @@ class ExtractRedshiftProxy(publish.Extractor):
             representation["frameStart"] = instance.data["frameStart"]
             representation["frameEnd"] = instance.data["frameEnd"]
 
-        instance.data["representations"].append(representation)
+        return representation
diff --git a/openpype/hosts/houdini/plugins/publish/validate_fbx_hierarchy_path.py b/openpype/hosts/houdini/plugins/publish/validate_fbx_hierarchy_path.py
index 6a2bda1bca..e98e562fe8 100644
--- a/openpype/hosts/houdini/plugins/publish/validate_fbx_hierarchy_path.py
+++ b/openpype/hosts/houdini/plugins/publish/validate_fbx_hierarchy_path.py
@@ -1,6 +1,9 @@
 # -*- coding: utf-8 -*-
 """Validate path attribute for all primitives.
 
+Validators are used to verify the work of artists,
+by running some checks which automates the approval process.
+
 It's almost the same as
 'validate_primitive_hierarchy_paths.py'
 however this one includes extra comments for demonstration.
@@ -44,12 +47,13 @@ class ValidatePrimitiveHierarchyPaths(pyblish.api.InstancePlugin):
     by default.
     """
 
-    # Usually you will use this value as default
-    order = ValidateContentsOrder + 0.1
     families = ["filmboxfbx"]
     hosts = ["houdini"]
     label = "Validate FBX Hierarchy Path"
 
+    # Usually you will use this value as default
+    order = ValidateContentsOrder + 0.1
+
     # Validation can have as many actions as you want
     # all of these actions are defined in a seperate place
     # unlike the repair action
@@ -69,7 +73,7 @@ class ValidatePrimitiveHierarchyPaths(pyblish.api.InstancePlugin):
 
     # This method was named get_invalid as a convention
     # it's also used by SelectInvalidAction to select
-    # the returned node
+    # the returned nodes
     @classmethod
     def get_invalid(cls, instance):
 

From f41ad17b7bbf962baf209adcce243372ab7948bd Mon Sep 17 00:00:00 2001
From: Mustafa-Zarkash <mustafataherzaky@outlook.com>
Date: Mon, 7 Aug 2023 22:22:47 +0300
Subject: [PATCH 053/366] update comments

---
 openpype/hosts/houdini/plugins/load/load_fbx.py | 13 ++++++++++++-
 1 file changed, 12 insertions(+), 1 deletion(-)

diff --git a/openpype/hosts/houdini/plugins/load/load_fbx.py b/openpype/hosts/houdini/plugins/load/load_fbx.py
index 993b57ad21..5294f5248d 100644
--- a/openpype/hosts/houdini/plugins/load/load_fbx.py
+++ b/openpype/hosts/houdini/plugins/load/load_fbx.py
@@ -30,14 +30,19 @@ class FbxLoader(load.LoaderPlugin):
 
     def load(self, context, name=None, namespace=None, data=None):
 
+        # get file path
         file_path = self.get_file_path(context)
 
+        # get necessary data
         namespace, node_name = self.get_node_name(context, name, namespace)
 
+        # create load tree
         nodes = self.create_load_node_tree(file_path, node_name, name)
 
         self[:] = nodes
 
+        # Call containerise function which does some
+        # automations for you
         containerised_nodes = self.get_containerised_nodes(
             nodes, context, node_name, namespace
         )
@@ -96,7 +101,7 @@ class FbxLoader(load.LoaderPlugin):
         return namespace, node_name
 
     def create_load_node_tree(self, file_path, node_name, subset_name):
-        """Create Load node network.
+        """Create Load network.
 
         you can start building your tree at any obj level.
         it'll be much easier to build it in the root obj level.
@@ -148,6 +153,12 @@ class FbxLoader(load.LoaderPlugin):
         return nodes
 
     def get_containerised_nodes(self, nodes, context, node_name, namespace):
+        """Call containerise function.
+
+        It does some automations that you don't have to worry about, e.g.
+            1. It moves created nodes to the AVALON_CONTAINERS  subnetwork
+            2. Add extra parameters
+        """
         containerised_nodes = pipeline.containerise(
             node_name,
             namespace,

From c72c8f332cbfbf3ded76ba9c6b2fcb9cbd9b1522 Mon Sep 17 00:00:00 2001
From: Kayla Man <moonyuet2008@hotmail.com>
Date: Tue, 8 Aug 2023 15:00:17 +0800
Subject: [PATCH 054/366] switching asset can maintain linkages on the
 modifiers and other data

---
 openpype/hosts/max/plugins/load/load_max_scene.py | 14 ++++++++------
 1 file changed, 8 insertions(+), 6 deletions(-)

diff --git a/openpype/hosts/max/plugins/load/load_max_scene.py b/openpype/hosts/max/plugins/load/load_max_scene.py
index 76cd3bf367..c98b7909ee 100644
--- a/openpype/hosts/max/plugins/load/load_max_scene.py
+++ b/openpype/hosts/max/plugins/load/load_max_scene.py
@@ -24,7 +24,9 @@ class MaxSceneLoader(load.LoaderPlugin):
         path = os.path.normpath(path)
         # import the max scene by using "merge file"
         path = path.replace('\\', '/')
-        rt.MergeMaxFile(path)
+        rt.MergeMaxFile(
+            path, rt.Name("autoRenameDups"),
+            includeFullGroup=True)
         max_objects = rt.getLastMergedNodes()
         max_container = rt.Container(name=f"{name}")
         for max_object in max_objects:
@@ -38,11 +40,11 @@ class MaxSceneLoader(load.LoaderPlugin):
 
         path = get_representation_path(representation)
         node_name = container["instance_node"]
-
-        rt.MergeMaxFile(path,
-                        rt.Name("noRedraw"),
-                        rt.Name("deleteOldDups"),
-                        rt.Name("useSceneMtlDups"))
+        merged_max_objects = rt.getLastMergedNodes()
+        rt.MergeMaxFile(
+            path, rt.Name("autoRenameDups"),
+            mergedNodes=merged_max_objects,
+            includeFullGroup=True)
 
         max_objects = rt.getLastMergedNodes()
         container_node = rt.GetNodeByName(node_name)

From d51c1fa9fb3ba534d9b2ba5b0cd3c6254c465290 Mon Sep 17 00:00:00 2001
From: Kayla Man <moonyuet2008@hotmail.com>
Date: Tue, 8 Aug 2023 15:11:13 +0800
Subject: [PATCH 055/366] do not use autorename duplicate when updating or
 switching version

---
 openpype/hosts/max/plugins/load/load_max_scene.py | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/openpype/hosts/max/plugins/load/load_max_scene.py b/openpype/hosts/max/plugins/load/load_max_scene.py
index c98b7909ee..3af4613d1a 100644
--- a/openpype/hosts/max/plugins/load/load_max_scene.py
+++ b/openpype/hosts/max/plugins/load/load_max_scene.py
@@ -42,8 +42,7 @@ class MaxSceneLoader(load.LoaderPlugin):
         node_name = container["instance_node"]
         merged_max_objects = rt.getLastMergedNodes()
         rt.MergeMaxFile(
-            path, rt.Name("autoRenameDups"),
-            mergedNodes=merged_max_objects,
+            path, mergedNodes=merged_max_objects,
             includeFullGroup=True)
 
         max_objects = rt.getLastMergedNodes()

From ab1172b277eaa396f3c3e992b3ad5759ff1635bf Mon Sep 17 00:00:00 2001
From: Kayla Man <moonyuet2008@hotmail.com>
Date: Tue, 8 Aug 2023 15:54:35 +0800
Subject: [PATCH 056/366]  delete old duplicates

---
 .../hosts/max/plugins/load/load_max_scene.py  | 22 ++++++++-----------
 1 file changed, 9 insertions(+), 13 deletions(-)

diff --git a/openpype/hosts/max/plugins/load/load_max_scene.py b/openpype/hosts/max/plugins/load/load_max_scene.py
index 3af4613d1a..92e1bdc59a 100644
--- a/openpype/hosts/max/plugins/load/load_max_scene.py
+++ b/openpype/hosts/max/plugins/load/load_max_scene.py
@@ -25,31 +25,27 @@ class MaxSceneLoader(load.LoaderPlugin):
         # import the max scene by using "merge file"
         path = path.replace('\\', '/')
         rt.MergeMaxFile(
-            path, rt.Name("autoRenameDups"),
+            path, rt.Name("mergeDups"),
             includeFullGroup=True)
         max_objects = rt.getLastMergedNodes()
-        max_container = rt.Container(name=f"{name}")
-        for max_object in max_objects:
-            max_object.Parent = max_container
 
         return containerise(
-            name, [max_container], context, loader=self.__class__.__name__)
+            name, [max_objects], context, loader=self.__class__.__name__)
 
     def update(self, container, representation):
         from pymxs import runtime as rt
 
         path = get_representation_path(representation)
-        node_name = container["instance_node"]
-        merged_max_objects = rt.getLastMergedNodes()
+        prev_max_objects = rt.getLastMergedNodes()
+        merged_max_objects = [obj.name for obj
+                              in prev_max_objects]
         rt.MergeMaxFile(
-            path, mergedNodes=merged_max_objects,
+            path, merged_max_objects,
+            rt.Name("deleteOldDups"),
+            quiet=True,
+            mergedNodes=prev_max_objects,
             includeFullGroup=True)
 
-        max_objects = rt.getLastMergedNodes()
-        container_node = rt.GetNodeByName(node_name)
-        for max_object in max_objects:
-            max_object.Parent = container_node
-
         lib.imprint(container["instance_node"], {
             "representation": str(representation["_id"])
         })

From 70cb60a17eb98ca7796674f4555f115019e27abe Mon Sep 17 00:00:00 2001
From: Kayla Man <moonyuet2008@hotmail.com>
Date: Tue, 8 Aug 2023 17:19:42 +0800
Subject: [PATCH 057/366] deletion of the old objects

---
 openpype/hosts/max/plugins/load/load_max_scene.py | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/openpype/hosts/max/plugins/load/load_max_scene.py b/openpype/hosts/max/plugins/load/load_max_scene.py
index 92e1bdc59a..1d105f1bc0 100644
--- a/openpype/hosts/max/plugins/load/load_max_scene.py
+++ b/openpype/hosts/max/plugins/load/load_max_scene.py
@@ -45,6 +45,11 @@ class MaxSceneLoader(load.LoaderPlugin):
             quiet=True,
             mergedNodes=prev_max_objects,
             includeFullGroup=True)
+        current_max_objects = rt.getLastMergedNodes()
+        for current_object in current_max_objects:
+            prev_max_objects = prev_max_objects.remove(current_object)
+        for prev_object in prev_max_objects:
+            rt.Delete(prev_object)
 
         lib.imprint(container["instance_node"], {
             "representation": str(representation["_id"])

From 58d2bcad88ca7ccd69a04fa6ec1e85dd693ac462 Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Tue, 8 Aug 2023 12:07:57 +0200
Subject: [PATCH 058/366] Extract active view as thumbnail

---
 .../publish/extract_active_view_thumbnail.py  | 51 +++++++++++++++++++
 1 file changed, 51 insertions(+)
 create mode 100644 openpype/hosts/maya/plugins/publish/extract_active_view_thumbnail.py

diff --git a/openpype/hosts/maya/plugins/publish/extract_active_view_thumbnail.py b/openpype/hosts/maya/plugins/publish/extract_active_view_thumbnail.py
new file mode 100644
index 0000000000..1bf010896a
--- /dev/null
+++ b/openpype/hosts/maya/plugins/publish/extract_active_view_thumbnail.py
@@ -0,0 +1,51 @@
+import maya.api.OpenMaya as om
+import maya.api.OpenMayaUI as omui
+
+import pyblish.api
+import tempfile
+
+
+class ExtractActiveViewThumbnail(pyblish.api.InstancePlugin):
+    """Set instance thumbnail to a screengrab of current active viewport.
+
+    This makes it so that if an instance does not have a thumbnail set yet that
+    it will get a thumbnail of the currently active view at the time of
+    publishing as a fallback.
+
+    """
+    order = pyblish.api.ExtractorOrder + 0.49
+    label = "Active View Thumbnail"
+    families = ["workfile"]
+    hosts = ["maya"]
+
+    def process(self, instance):
+        thumbnail = instance.data.get("thumbnailPath")
+        if not thumbnail:
+            view_thumbnail = self.get_view_thumbnail(instance)
+            if not view_thumbnail:
+                return
+
+            self.log.debug("Setting instance thumbnail path to: {}".format(
+                view_thumbnail
+            ))
+            instance.data["thumbnailPath"] = view_thumbnail
+
+    def get_view_thumbnail(self, instance):
+        cache_key = "__maya_view_thumbnail"
+        context = instance.context
+
+        if cache_key not in context.data:
+            # Generate only a single thumbnail, even for multiple instances
+            with tempfile.NamedTemporaryFile(suffix="_thumbnail.jpg",
+                                             delete=False) as f:
+                path = f.name
+
+            view = omui.M3dView.active3dView()
+            image = om.MImage()
+            view.readColorBuffer(image, True)
+            image.writeToFile(path, "jpg")
+            self.log.debug("Generated thumbnail: {}".format(path))
+
+            context.data[cache_key] = path
+        return context.data[cache_key]
+

From 4049d9acb148e93f11849bc2395b904c0ff13dcf Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Tue, 8 Aug 2023 12:12:14 +0200
Subject: [PATCH 059/366] Cosmetics - good doggy!

---
 .../hosts/maya/plugins/publish/extract_active_view_thumbnail.py  | 1 -
 1 file changed, 1 deletion(-)

diff --git a/openpype/hosts/maya/plugins/publish/extract_active_view_thumbnail.py b/openpype/hosts/maya/plugins/publish/extract_active_view_thumbnail.py
index 1bf010896a..cb039cbf51 100644
--- a/openpype/hosts/maya/plugins/publish/extract_active_view_thumbnail.py
+++ b/openpype/hosts/maya/plugins/publish/extract_active_view_thumbnail.py
@@ -48,4 +48,3 @@ class ExtractActiveViewThumbnail(pyblish.api.InstancePlugin):
 
             context.data[cache_key] = path
         return context.data[cache_key]
-

From 7b74d0b91ddaf0d1d8bda72a84d9cea87ba2f122 Mon Sep 17 00:00:00 2001
From: Kayla Man <moonyuet2008@hotmail.com>
Date: Wed, 9 Aug 2023 20:21:25 +0800
Subject: [PATCH 060/366] add ornatrix alembic loader

---
 openpype/hosts/max/plugins/load/load_model.py |  2 +-
 .../max/plugins/load/load_model_ornatrix.py   | 74 +++++++++++++++++++
 .../hosts/max/plugins/load/load_pointcache.py |  2 +-
 .../plugins/load/load_pointcache_ornatrix.py  | 70 ++++++++++++++++++
 4 files changed, 146 insertions(+), 2 deletions(-)
 create mode 100644 openpype/hosts/max/plugins/load/load_model_ornatrix.py
 create mode 100644 openpype/hosts/max/plugins/load/load_pointcache_ornatrix.py

diff --git a/openpype/hosts/max/plugins/load/load_model.py b/openpype/hosts/max/plugins/load/load_model.py
index cff82a593c..c149f939a2 100644
--- a/openpype/hosts/max/plugins/load/load_model.py
+++ b/openpype/hosts/max/plugins/load/load_model.py
@@ -9,7 +9,7 @@ class ModelAbcLoader(load.LoaderPlugin):
     """Loading model with the Alembic loader."""
 
     families = ["model"]
-    label = "Load Model(Alembic)"
+    label = "Load Model(Alembic) with Max"
     representations = ["abc"]
     order = -10
     icon = "code-fork"
diff --git a/openpype/hosts/max/plugins/load/load_model_ornatrix.py b/openpype/hosts/max/plugins/load/load_model_ornatrix.py
new file mode 100644
index 0000000000..d92e92f63b
--- /dev/null
+++ b/openpype/hosts/max/plugins/load/load_model_ornatrix.py
@@ -0,0 +1,74 @@
+import os
+from openpype.pipeline import load, get_representation_path
+from openpype.hosts.max.api.pipeline import containerise
+from openpype.hosts.max.api import lib
+
+
+class ModelAbcLoader(load.LoaderPlugin):
+    """Loading model with the Ornatrix Alembic loader."""
+
+    families = ["model"]
+    label = "Load Model(Alembic) with Ornatrix"
+    representations = ["abc"]
+    order = -10
+    icon = "code-fork"
+    color = "orange"
+
+    def load(self, context, name=None, namespace=None, data=None):
+        from pymxs import runtime as rt
+
+        file_path = os.path.normpath(self.filepath_from_context(context))
+        scene_object_before = [obj for obj in rt.rootNode.Children]
+        rt.AlembicImport.ImportToRoot = True
+        rt.AlembicImport.CustomAttributes = True
+        rt.AlembicImport.UVs = True
+        rt.AlembicImport.VertexColors = True
+        rt.importFile(file_path)
+        scene_object_after = [obj for obj in rt.rootNode.Children]
+        for scene_object in scene_object_before:
+            scene_object_after = scene_object_after.remove(scene_object)
+
+        abc_container = rt.Container(name=name)
+        for abc in scene_object_after:
+            abc.Parent = abc_container
+
+        return containerise(
+            name, [abc_container], context, loader=self.__class__.__name__
+        )
+
+    def update(self, container, representation):
+        from pymxs import runtime as rt
+
+        path = get_representation_path(representation)
+        node_name = container["instance_node"]
+        instance_name, _ = os.path.splitext(node_name)
+        container = rt.getNodeByName(instance_name)
+        for children in container.Children:
+            rt.Delete(children)
+
+        scene_object_before = [obj for obj in rt.rootNode.Children]
+        rt.AlembicImport.ImportToRoot = True
+        rt.AlembicImport.CustomAttributes = True
+        rt.AlembicImport.UVs = True
+        rt.AlembicImport.VertexColors = True
+        rt.importFile(path)
+        scene_object_after = [obj for obj in rt.rootNode.Children]
+        for scene_object in scene_object_before:
+            scene_object_after = scene_object_after.remove(scene_object)
+
+        for scene_object in scene_object_after:
+            scene_object.Parent = container
+
+        lib.imprint(
+            container["instance_node"],
+            {"representation": str(representation["_id"])},
+        )
+
+    def switch(self, container, representation):
+        self.update(container, representation)
+
+    def remove(self, container):
+        from pymxs import runtime as rt
+
+        node = rt.GetNodeByName(container["instance_node"])
+        rt.Delete(node)
diff --git a/openpype/hosts/max/plugins/load/load_pointcache.py b/openpype/hosts/max/plugins/load/load_pointcache.py
index 290503e053..e59ad09c9f 100644
--- a/openpype/hosts/max/plugins/load/load_pointcache.py
+++ b/openpype/hosts/max/plugins/load/load_pointcache.py
@@ -14,7 +14,7 @@ class AbcLoader(load.LoaderPlugin):
     """Alembic loader."""
 
     families = ["camera", "animation", "pointcache"]
-    label = "Load Alembic"
+    label = "Load Alembic with Max"
     representations = ["abc"]
     order = -10
     icon = "code-fork"
diff --git a/openpype/hosts/max/plugins/load/load_pointcache_ornatrix.py b/openpype/hosts/max/plugins/load/load_pointcache_ornatrix.py
new file mode 100644
index 0000000000..0b0932da6a
--- /dev/null
+++ b/openpype/hosts/max/plugins/load/load_pointcache_ornatrix.py
@@ -0,0 +1,70 @@
+import os
+from openpype.pipeline import load, get_representation_path
+from openpype.hosts.max.api.pipeline import containerise
+from openpype.hosts.max.api import lib
+
+
+class ModelAbcLoader(load.LoaderPlugin):
+    """Ornatrix Alembic loader."""
+
+    families = ["camera", "animation", "pointcache"]
+    label = "Load Model(Alembic) with Ornatrix"
+    representations = ["abc"]
+    order = -10
+    icon = "code-fork"
+    color = "orange"
+
+    def load(self, context, name=None, namespace=None, data=None):
+        from pymxs import runtime as rt
+
+        file_path = os.path.normpath(self.filepath_from_context(context))
+        scene_object_before = [obj for obj in rt.rootNode.Children]
+        rt.AlembicImport.ImportToRoot = True
+        rt.AlembicImport.CustomAttributes = True
+        rt.importFile(file_path)
+        scene_object_after = [obj for obj in rt.rootNode.Children]
+        for scene_object in scene_object_before:
+            scene_object_after = scene_object_after.remove(scene_object)
+
+        abc_container = rt.Container(name=name)
+        for abc in scene_object_after:
+            abc.Parent = abc_container
+
+        return containerise(
+            name, [abc_container], context, loader=self.__class__.__name__
+        )
+
+    def update(self, container, representation):
+        from pymxs import runtime as rt
+
+        path = get_representation_path(representation)
+        node_name = container["instance_node"]
+        instance_name, _ = os.path.splitext(node_name)
+        container = rt.getNodeByName(instance_name)
+        for children in container.Children:
+            rt.Delete(children)
+
+        scene_object_before = [obj for obj in rt.rootNode.Children]
+        rt.AlembicImport.ImportToRoot = False
+        rt.AlembicImport.CustomAttributes = True
+        rt.importFile(path)
+        scene_object_after = [obj for obj in rt.rootNode.Children]
+        for scene_object in scene_object_before:
+            scene_object_after = scene_object_after.remove(scene_object)
+
+        for scene_object in scene_object_after:
+            scene_object.Parent = container
+
+        lib.imprint(
+            container["instance_node"],
+            {"representation": str(representation["_id"])},
+        )
+
+    def switch(self, container, representation):
+        self.update(container, representation)
+
+    def remove(self, container):
+        from pymxs import runtime as rt
+
+        node = rt.GetNodeByName(container["instance_node"])
+        rt.Delete(node)

From 8a175b06edb6b6ca8039ac6560c19541d923bd0f Mon Sep 17 00:00:00 2001
From: Kayla Man <moonyuet2008@hotmail.com>
Date: Wed, 9 Aug 2023 20:29:20 +0800
Subject: [PATCH 061/366] rename the label

---
 openpype/hosts/max/plugins/load/load_model.py               | 2 +-
 openpype/hosts/max/plugins/load/load_model_ornatrix.py      | 2 +-
 openpype/hosts/max/plugins/load/load_pointcache_ornatrix.py | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/openpype/hosts/max/plugins/load/load_model.py b/openpype/hosts/max/plugins/load/load_model.py
index c149f939a2..2f402efef8 100644
--- a/openpype/hosts/max/plugins/load/load_model.py
+++ b/openpype/hosts/max/plugins/load/load_model.py
@@ -9,7 +9,7 @@ class ModelAbcLoader(load.LoaderPlugin):
     """Loading model with the Alembic loader."""
 
     families = ["model"]
-    label = "Load Model(Alembic) with Max"
+    label = "Load Model with Alembic"
     representations = ["abc"]
     order = -10
     icon = "code-fork"
diff --git a/openpype/hosts/max/plugins/load/load_model_ornatrix.py b/openpype/hosts/max/plugins/load/load_model_ornatrix.py
index d92e92f63b..8dc34278f5 100644
--- a/openpype/hosts/max/plugins/load/load_model_ornatrix.py
+++ b/openpype/hosts/max/plugins/load/load_model_ornatrix.py
@@ -8,7 +8,7 @@ class ModelAbcLoader(load.LoaderPlugin):
     """Loading model with the Ornatrix Alembic loader."""
 
     families = ["model"]
-    label = "Load Model(Alembic) with Ornatrix"
+    label = "Load Model with Ornatrix Alembic"
     representations = ["abc"]
     order = -10
     icon = "code-fork"
diff --git a/openpype/hosts/max/plugins/load/load_pointcache_ornatrix.py b/openpype/hosts/max/plugins/load/load_pointcache_ornatrix.py
index 0b0932da6a..663c64bc0a 100644
--- a/openpype/hosts/max/plugins/load/load_pointcache_ornatrix.py
+++ b/openpype/hosts/max/plugins/load/load_pointcache_ornatrix.py
@@ -8,7 +8,7 @@ class ModelAbcLoader(load.LoaderPlugin):
     """Ornatrix Alembic loader."""
 
     families = ["camera", "animation", "pointcache"]
-    label = "Load Model(Alembic) with Ornatrix"
+    label = "Load Alembic with Ornatrix"
     representations = ["abc"]
     order = -10
     icon = "code-fork"

From 938185c20835b545fa5c3b4b3e7673264509acf5 Mon Sep 17 00:00:00 2001
From: Kayla Man <moonyuet2008@hotmail.com>
Date: Wed, 9 Aug 2023 20:32:39 +0800
Subject: [PATCH 062/366] rename the class name

---
 openpype/hosts/max/plugins/load/load_model_ornatrix.py      | 2 +-
 openpype/hosts/max/plugins/load/load_pointcache_ornatrix.py | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/openpype/hosts/max/plugins/load/load_model_ornatrix.py b/openpype/hosts/max/plugins/load/load_model_ornatrix.py
index 8dc34278f5..424820e6e6 100644
--- a/openpype/hosts/max/plugins/load/load_model_ornatrix.py
+++ b/openpype/hosts/max/plugins/load/load_model_ornatrix.py
@@ -4,7 +4,7 @@ from openpype.hosts.max.api.pipeline import containerise
 from openpype.hosts.max.api import lib
 
 
-class ModelAbcLoader(load.LoaderPlugin):
+class ModelOxAbcLoader(load.LoaderPlugin):
     """Loading model with the Ornatrix Alembic loader."""
 
     families = ["model"]
diff --git a/openpype/hosts/max/plugins/load/load_pointcache_ornatrix.py b/openpype/hosts/max/plugins/load/load_pointcache_ornatrix.py
index 663c64bc0a..0d04dbdef3 100644
--- a/openpype/hosts/max/plugins/load/load_pointcache_ornatrix.py
+++ b/openpype/hosts/max/plugins/load/load_pointcache_ornatrix.py
@@ -4,7 +4,7 @@ from openpype.hosts.max.api.pipeline import containerise
 from openpype.hosts.max.api import lib
 
 
-class ModelAbcLoader(load.LoaderPlugin):
+class OxAbcLoader(load.LoaderPlugin):
     """Ornatrix Alembic loader."""
 
     families = ["camera", "animation", "pointcache"]

From cb48a2268c996ade66744540c2019b3eb8d06e98 Mon Sep 17 00:00:00 2001
From: Kayla Man <moonyuet2008@hotmail.com>
Date: Thu, 10 Aug 2023 00:19:52 +0800
Subject: [PATCH 063/366] add the using alembic import back to the importfile

---
 openpype/hosts/max/plugins/load/load_model.py |  3 +-
 .../max/plugins/load/load_model_ornatrix.py   | 74 -------------------
 .../hosts/max/plugins/load/load_pointcache.py |  3 +-
 .../plugins/load/load_pointcache_ornatrix.py  | 70 ------------------
 4 files changed, 4 insertions(+), 146 deletions(-)
 delete mode 100644 openpype/hosts/max/plugins/load/load_model_ornatrix.py
 delete mode 100644 openpype/hosts/max/plugins/load/load_pointcache_ornatrix.py

diff --git a/openpype/hosts/max/plugins/load/load_model.py b/openpype/hosts/max/plugins/load/load_model.py
index 2f402efef8..288fc58454 100644
--- a/openpype/hosts/max/plugins/load/load_model.py
+++ b/openpype/hosts/max/plugins/load/load_model.py
@@ -30,7 +30,8 @@ class ModelAbcLoader(load.LoaderPlugin):
         rt.AlembicImport.CustomAttributes = True
         rt.AlembicImport.UVs = True
         rt.AlembicImport.VertexColors = True
-        rt.importFile(file_path, rt.name("noPrompt"))
+        rt.importFile(
+            file_path, rt.name("noPrompt"), using=rt.AlembicImport)
 
         abc_after = {
             c
diff --git a/openpype/hosts/max/plugins/load/load_model_ornatrix.py b/openpype/hosts/max/plugins/load/load_model_ornatrix.py
deleted file mode 100644
index 424820e6e6..0000000000
--- a/openpype/hosts/max/plugins/load/load_model_ornatrix.py
+++ /dev/null
@@ -1,74 +0,0 @@
-import os
-from openpype.pipeline import load, get_representation_path
-from openpype.hosts.max.api.pipeline import containerise
-from openpype.hosts.max.api import lib
-
-
-class ModelOxAbcLoader(load.LoaderPlugin):
-    """Loading model with the Ornatrix Alembic loader."""
-
-    families = ["model"]
-    label = "Load Model with Ornatrix Alembic"
-    representations = ["abc"]
-    order = -10
-    icon = "code-fork"
-    color = "orange"
-
-    def load(self, context, name=None, namespace=None, data=None):
-        from pymxs import runtime as rt
-
-        file_path = os.path.normpath(self.filepath_from_context(context))
-        scene_object_before = [obj for obj in rt.rootNode.Children]
-        rt.AlembicImport.ImportToRoot = True
-        rt.AlembicImport.CustomAttributes = True
-        rt.AlembicImport.UVs = True
-        rt.AlembicImport.VertexColors = True
-        rt.importFile(file_path)
-        scene_object_after = [obj for obj in rt.rootNode.Children]
-        for scene_object in scene_object_before:
-            scene_object_after = scene_object_after.remove(scene_object)
-
-        abc_container = rt.Container(name=name)
-        for abc in scene_object_after:
-            abc.Parent = abc_container
-
-        return containerise(
-            name, [abc_container], context, loader=self.__class__.__name__
-        )
-
-    def update(self, container, representation):
-        from pymxs import runtime as rt
-
-        path = get_representation_path(representation)
-        node_name = container["instance_node"]
-        instance_name, _ = os.path.splitext(node_name)
-        container = rt.getNodeByName(instance_name)
-        for children in container.Children:
-            rt.Delete(children)
-
-        scene_object_before = [obj for obj in rt.rootNode.Children]
-        rt.AlembicImport.ImportToRoot = True
-        rt.AlembicImport.CustomAttributes = True
-        rt.AlembicImport.UVs = True
-        rt.AlembicImport.VertexColors = True
-        rt.importFile(path)
-        scene_object_after = [obj for obj in rt.rootNode.Children]
-        for scene_object in scene_object_before:
-            scene_object_after = scene_object_after.remove(scene_object)
-
-        for scene_object in scene_object_after:
-            scene_object.Parent = container
-
-        lib.imprint(
-            container["instance_node"],
-            {"representation": str(representation["_id"])},
-        )
-
-    def switch(self, container, representation):
-        self.update(container, representation)
-
-    def remove(self, container):
-        from pymxs import runtime as rt
-
-        node = rt.GetNodeByName(container["instance_node"])
-        rt.Delete(node)
diff --git a/openpype/hosts/max/plugins/load/load_pointcache.py b/openpype/hosts/max/plugins/load/load_pointcache.py
index e59ad09c9f..24bcf58582 100644
--- a/openpype/hosts/max/plugins/load/load_pointcache.py
+++ b/openpype/hosts/max/plugins/load/load_pointcache.py
@@ -33,7 +33,8 @@ class AbcLoader(load.LoaderPlugin):
         }
 
         rt.AlembicImport.ImportToRoot = False
-        rt.importFile(file_path, rt.name("noPrompt"))
+        rt.importFile(
+            file_path, rt.name("noPrompt"), using=rt.AlembicImport)
 
         abc_after = {
             c
diff --git a/openpype/hosts/max/plugins/load/load_pointcache_ornatrix.py b/openpype/hosts/max/plugins/load/load_pointcache_ornatrix.py
deleted file mode 100644
index 0d04dbdef3..0000000000
--- a/openpype/hosts/max/plugins/load/load_pointcache_ornatrix.py
+++ /dev/null
@@ -1,70 +0,0 @@
-import os
-from openpype.pipeline import load, get_representation_path
-from openpype.hosts.max.api.pipeline import containerise
-from openpype.hosts.max.api import lib
-
-
-class OxAbcLoader(load.LoaderPlugin):
-    """Ornatrix Alembic loader."""
-
-    families = ["camera", "animation", "pointcache"]
-    label = "Load Alembic with Ornatrix"
-    representations = ["abc"]
-    order = -10
-    icon = "code-fork"
-    color = "orange"
-
-    def load(self, context, name=None, namespace=None, data=None):
-        from pymxs import runtime as rt
-
-        file_path = os.path.normpath(self.filepath_from_context(context))
-        scene_object_before = [obj for obj in rt.rootNode.Children]
-        rt.AlembicImport.ImportToRoot = True
-        rt.AlembicImport.CustomAttributes = True
-        rt.importFile(file_path)
-        scene_object_after = [obj for obj in rt.rootNode.Children]
-        for scene_object in scene_object_before:
-            scene_object_after = scene_object_after.remove(scene_object)
-
-        abc_container = rt.Container(name=name)
-        for abc in scene_object_after:
-            abc.Parent = abc_container
-
-        return containerise(
-            name, [abc_container], context, loader=self.__class__.__name__
-        )
-
-    def update(self, container, representation):
-        from pymxs import runtime as rt
-
-        path = get_representation_path(representation)
-        node_name = container["instance_node"]
-        instance_name, _ = os.path.splitext(node_name)
-        container = rt.getNodeByName(instance_name)
-        for children in container.Children:
-            rt.Delete(children)
-
-        scene_object_before = [obj for obj in rt.rootNode.Children]
-        rt.AlembicImport.ImportToRoot = False
-        rt.AlembicImport.CustomAttributes = True
-        rt.importFile(path)
-        scene_object_after = [obj for obj in rt.rootNode.Children]
-        for scene_object in scene_object_before:
-            scene_object_after = scene_object_after.remove(scene_object)
-
-        for scene_object in scene_object_after:
-            scene_object.Parent = container
-
-        lib.imprint(
-            container["instance_node"],
-            {"representation": str(representation["_id"])},
-        )
-
-    def switch(self, container, representation):
-        self.update(container, representation)
-
-    def remove(self, container):
-        from pymxs import runtime as rt
-
-        node = rt.GetNodeByName(container["instance_node"])
-        rt.Delete(node)

From 5cb43a141476fbba18af9a36df747d6082c31036 Mon Sep 17 00:00:00 2001
From: Kayla Man <moonyuet2008@hotmail.com>
Date: Thu, 10 Aug 2023 00:30:06 +0800
Subject: [PATCH 064/366] restore the label name

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

diff --git a/openpype/hosts/max/plugins/load/load_pointcache.py b/openpype/hosts/max/plugins/load/load_pointcache.py
index 24bcf58582..f250377cfd 100644
--- a/openpype/hosts/max/plugins/load/load_pointcache.py
+++ b/openpype/hosts/max/plugins/load/load_pointcache.py
@@ -14,7 +14,7 @@ class AbcLoader(load.LoaderPlugin):
     """Alembic loader."""
 
     families = ["camera", "animation", "pointcache"]
-    label = "Load Alembic with Max"
+    label = "Load Alembic"
     representations = ["abc"]
     order = -10
     icon = "code-fork"

From 0a69439f2ef257e9800eda5e88d925b258f2ee25 Mon Sep 17 00:00:00 2001
From: Kayla Man <moonyuet2008@hotmail.com>
Date: Thu, 10 Aug 2023 01:00:34 +0800
Subject: [PATCH 065/366] supports loading ornatrix alembic

---
 .../max/plugins/load/load_model_ornatrix.py   | 74 +++++++++++++++++++
 .../plugins/load/load_pointcache_ornatrix.py  | 70 ++++++++++++++++++
 2 files changed, 144 insertions(+)
 create mode 100644 openpype/hosts/max/plugins/load/load_model_ornatrix.py
 create mode 100644 openpype/hosts/max/plugins/load/load_pointcache_ornatrix.py

diff --git a/openpype/hosts/max/plugins/load/load_model_ornatrix.py b/openpype/hosts/max/plugins/load/load_model_ornatrix.py
new file mode 100644
index 0000000000..92773ad567
--- /dev/null
+++ b/openpype/hosts/max/plugins/load/load_model_ornatrix.py
@@ -0,0 +1,74 @@
+import os
+from openpype.pipeline import load, get_representation_path
+from openpype.hosts.max.api.pipeline import containerise
+from openpype.hosts.max.api import lib
+
+
+class OxModelAbcLoader(load.LoaderPlugin):
+    """Loading model with the Ornatrix Alembic loader."""
+
+    families = ["model"]
+    label = "Load Model with Ornatrix Alembic"
+    representations = ["abc"]
+    order = -10
+    icon = "code-fork"
+    color = "orange"
+
+    def load(self, context, name=None, namespace=None, data=None):
+        from pymxs import runtime as rt
+
+        file_path = os.path.normpath(self.filepath_from_context(context))
+        scene_object_before = [obj for obj in rt.rootNode.Children]
+        rt.AlembicImport.ImportToRoot = True
+        rt.AlembicImport.CustomAttributes = True
+        rt.AlembicImport.UVs = True
+        rt.AlembicImport.VertexColors = True
+        rt.importFile(file_path, rt.name("noPrompt"))
+        scene_object_after = [obj for obj in rt.rootNode.Children]
+        for scene_object in scene_object_before:
+            scene_object_after = scene_object_after.remove(scene_object)
+
+        abc_container = rt.Container(name=name)
+        for abc in scene_object_after:
+            abc.Parent = abc_container
+
+        return containerise(
+            name, [abc_container], context, loader=self.__class__.__name__
+        )
+
+    def update(self, container, representation):
+        from pymxs import runtime as rt
+
+        path = get_representation_path(representation)
+        node_name = container["instance_node"]
+        instance_name, _ = os.path.splitext(node_name)
+        container = rt.getNodeByName(instance_name)
+        for children in container.Children:
+            rt.Delete(children)
+
+        scene_object_before = [obj for obj in rt.rootNode.Children]
+        rt.AlembicImport.ImportToRoot = True
+        rt.AlembicImport.CustomAttributes = True
+        rt.AlembicImport.UVs = True
+        rt.AlembicImport.VertexColors = True
+        rt.importFile(path)
+        scene_object_after = [obj for obj in rt.rootNode.Children]
+        for scene_object in scene_object_before:
+            scene_object_after = scene_object_after.remove(scene_object)
+
+        for scene_object in scene_object_after:
+            scene_object.Parent = container
+
+        lib.imprint(
+            container["instance_node"],
+            {"representation": str(representation["_id"])},
+        )
+
+    def switch(self, container, representation):
+        self.update(container, representation)
+
+    def remove(self, container):
+        from pymxs import runtime as rt
+
+        node = rt.GetNodeByName(container["instance_node"])
+        rt.Delete(node)
diff --git a/openpype/hosts/max/plugins/load/load_pointcache_ornatrix.py b/openpype/hosts/max/plugins/load/load_pointcache_ornatrix.py
new file mode 100644
index 0000000000..cd08e9a2ff
--- /dev/null
+++ b/openpype/hosts/max/plugins/load/load_pointcache_ornatrix.py
@@ -0,0 +1,70 @@
+import os
+from openpype.pipeline import load, get_representation_path
+from openpype.hosts.max.api.pipeline import containerise
+from openpype.hosts.max.api import lib
+
+
+class OxAbcLoader(load.LoaderPlugin):
+    """Ornatrix Alembic loader."""
+
+    families = ["camera", "animation", "pointcache"]
+    label = "Load Alembic with Ornatrix"
+    representations = ["abc"]
+    order = -10
+    icon = "code-fork"
+    color = "orange"
+
+    def load(self, context, name=None, namespace=None, data=None):
+        from pymxs import runtime as rt
+
+        file_path = os.path.normpath(self.filepath_from_context(context))
+        scene_object_before = [obj for obj in rt.rootNode.Children]
+        rt.AlembicImport.ImportToRoot = True
+        rt.AlembicImport.CustomAttributes = True
+        rt.importFile(file_path, rt.name("noPrompt"))
+        scene_object_after = [obj for obj in rt.rootNode.Children]
+        for scene_object in scene_object_before:
+            scene_object_after = scene_object_after.remove(scene_object)
+
+        abc_container = rt.Container(name=name)
+        for abc in scene_object_after:
+            abc.Parent = abc_container
+
+        return containerise(
+            name, [abc_container], context, loader=self.__class__.__name__
+        )
+
+    def update(self, container, representation):
+        from pymxs import runtime as rt
+
+        path = get_representation_path(representation)
+        node_name = container["instance_node"]
+        instance_name, _ = os.path.splitext(node_name)
+        container = rt.getNodeByName(instance_name)
+        for children in container.Children:
+            rt.Delete(children)
+
+        scene_object_before = [obj for obj in rt.rootNode.Children]
+        rt.AlembicImport.ImportToRoot = False
+        rt.AlembicImport.CustomAttributes = True
+        rt.importFile(path)
+        scene_object_after = [obj for obj in rt.rootNode.Children]
+        for scene_object in scene_object_before:
+            scene_object_after = scene_object_after.remove(scene_object)
+
+        for scene_object in scene_object_after:
+            scene_object.Parent = container
+
+        lib.imprint(
+            container["instance_node"],
+            {"representation": str(representation["_id"])},
+        )
+
+    def switch(self, container, representation):
+        self.update(container, representation)
+
+    def remove(self, container):
+        from pymxs import runtime as rt
+
+        node = rt.GetNodeByName(container["instance_node"])
+        rt.Delete(node)

From 17904600a00dbb64875ce06fd07d3d6d220ec8ca Mon Sep 17 00:00:00 2001
From: Kayla Man <moonyuet2008@hotmail.com>
Date: Thu, 10 Aug 2023 14:56:23 +0800
Subject: [PATCH 066/366] add using ornatrix alembic importer into the ornatrix
 alembic loaders

---
 openpype/hosts/max/plugins/load/load_model_ornatrix.py      | 4 +++-
 openpype/hosts/max/plugins/load/load_pointcache_ornatrix.py | 4 +++-
 2 files changed, 6 insertions(+), 2 deletions(-)

diff --git a/openpype/hosts/max/plugins/load/load_model_ornatrix.py b/openpype/hosts/max/plugins/load/load_model_ornatrix.py
index 92773ad567..38c081b91c 100644
--- a/openpype/hosts/max/plugins/load/load_model_ornatrix.py
+++ b/openpype/hosts/max/plugins/load/load_model_ornatrix.py
@@ -23,7 +23,9 @@ class OxModelAbcLoader(load.LoaderPlugin):
         rt.AlembicImport.CustomAttributes = True
         rt.AlembicImport.UVs = True
         rt.AlembicImport.VertexColors = True
-        rt.importFile(file_path, rt.name("noPrompt"))
+        rt.importFile(
+            file_path, rt.name("noPrompt"),
+            using=rt.Ornatrix_Alembic_Importer)
         scene_object_after = [obj for obj in rt.rootNode.Children]
         for scene_object in scene_object_before:
             scene_object_after = scene_object_after.remove(scene_object)
diff --git a/openpype/hosts/max/plugins/load/load_pointcache_ornatrix.py b/openpype/hosts/max/plugins/load/load_pointcache_ornatrix.py
index cd08e9a2ff..65a8273ab5 100644
--- a/openpype/hosts/max/plugins/load/load_pointcache_ornatrix.py
+++ b/openpype/hosts/max/plugins/load/load_pointcache_ornatrix.py
@@ -21,7 +21,9 @@ class OxAbcLoader(load.LoaderPlugin):
         scene_object_before = [obj for obj in rt.rootNode.Children]
         rt.AlembicImport.ImportToRoot = True
         rt.AlembicImport.CustomAttributes = True
-        rt.importFile(file_path, rt.name("noPrompt"))
+        rt.importFile(
+            file_path, rt.name("noPrompt"),
+            using=rt.Ornatrix_Alembic_Importer)
         scene_object_after = [obj for obj in rt.rootNode.Children]
         for scene_object in scene_object_before:
             scene_object_after = scene_object_after.remove(scene_object)

From a3c761c0683c25ab5f4a901d06a3f955ffcd8d10 Mon Sep 17 00:00:00 2001
From: Kayla Man <moonyuet2008@hotmail.com>
Date: Thu, 10 Aug 2023 15:36:59 +0800
Subject: [PATCH 067/366] add using ornatrix alembic importer into the ornatrix
 alembic loaders when updating version

---
 openpype/hosts/max/plugins/load/load_model_ornatrix.py      | 4 +++-
 openpype/hosts/max/plugins/load/load_pointcache_ornatrix.py | 4 +++-
 2 files changed, 6 insertions(+), 2 deletions(-)

diff --git a/openpype/hosts/max/plugins/load/load_model_ornatrix.py b/openpype/hosts/max/plugins/load/load_model_ornatrix.py
index 38c081b91c..07633ec55d 100644
--- a/openpype/hosts/max/plugins/load/load_model_ornatrix.py
+++ b/openpype/hosts/max/plugins/load/load_model_ornatrix.py
@@ -53,7 +53,9 @@ class OxModelAbcLoader(load.LoaderPlugin):
         rt.AlembicImport.CustomAttributes = True
         rt.AlembicImport.UVs = True
         rt.AlembicImport.VertexColors = True
-        rt.importFile(path)
+        rt.importFile(
+            path, rt.name("noPrompt"),
+            using=rt.Ornatrix_Alembic_Importer)
         scene_object_after = [obj for obj in rt.rootNode.Children]
         for scene_object in scene_object_before:
             scene_object_after = scene_object_after.remove(scene_object)
diff --git a/openpype/hosts/max/plugins/load/load_pointcache_ornatrix.py b/openpype/hosts/max/plugins/load/load_pointcache_ornatrix.py
index 65a8273ab5..f783583ff1 100644
--- a/openpype/hosts/max/plugins/load/load_pointcache_ornatrix.py
+++ b/openpype/hosts/max/plugins/load/load_pointcache_ornatrix.py
@@ -49,7 +49,9 @@ class OxAbcLoader(load.LoaderPlugin):
         scene_object_before = [obj for obj in rt.rootNode.Children]
         rt.AlembicImport.ImportToRoot = False
         rt.AlembicImport.CustomAttributes = True
-        rt.importFile(path)
+        rt.importFile(
+            path, rt.name("noPrompt"),
+            using=rt.Ornatrix_Alembic_Importer)
         scene_object_after = [obj for obj in rt.rootNode.Children]
         for scene_object in scene_object_before:
             scene_object_after = scene_object_after.remove(scene_object)

From c5b05a95c6799284bf688ef8a0b45e67841dc6b4 Mon Sep 17 00:00:00 2001
From: Simone Barbieri <simone.barbieri@hey.com>
Date: Thu, 10 Aug 2023 11:42:08 +0100
Subject: [PATCH 068/366] Basic implementation

---
 .../blender/plugins/create/create_render.py   |  49 +++++
 .../blender/plugins/publish/collect_render.py |  81 ++++++++
 .../publish/submit_blender_deadline.py        | 175 ++++++++++++++++++
 .../plugins/publish/submit_publish_job.py     |   2 +-
 4 files changed, 306 insertions(+), 1 deletion(-)
 create mode 100644 openpype/hosts/blender/plugins/create/create_render.py
 create mode 100644 openpype/hosts/blender/plugins/publish/collect_render.py
 create mode 100644 openpype/modules/deadline/plugins/publish/submit_blender_deadline.py

diff --git a/openpype/hosts/blender/plugins/create/create_render.py b/openpype/hosts/blender/plugins/create/create_render.py
new file mode 100644
index 0000000000..8323b88cfe
--- /dev/null
+++ b/openpype/hosts/blender/plugins/create/create_render.py
@@ -0,0 +1,49 @@
+"""Create render."""
+
+import bpy
+
+from openpype.pipeline import get_current_task_name
+from openpype.hosts.blender.api import plugin, lib, ops
+from openpype.hosts.blender.api.pipeline import AVALON_INSTANCES
+
+
+class CreateRenderlayer(plugin.Creator):
+    """Single baked camera"""
+
+    name = "renderingMain"
+    label = "Render"
+    family = "renderlayer"
+    icon = "eye"
+
+    render_settings = {}
+
+    def process(self):
+        """ Run the creator on Blender main thread"""
+        mti = ops.MainThreadItem(self._process)
+        ops.execute_in_main_thread(mti)
+
+    def _process(self):
+        # Get Instance Container or create it if it does not exist
+        instances = bpy.data.collections.get(AVALON_INSTANCES)
+        if not instances:
+            instances = bpy.data.collections.new(name=AVALON_INSTANCES)
+            bpy.context.scene.collection.children.link(instances)
+
+        # Create instance object
+        asset = self.data["asset"]
+        subset = self.data["subset"]
+        name = plugin.asset_name(asset, subset)
+        asset_group = bpy.data.collections.new(name=name)
+        instances.children.link(asset_group)
+        self.data['task'] = get_current_task_name()
+        lib.imprint(asset_group, self.data)
+
+        if (self.options or {}).get("useSelection"):
+            selected = lib.get_selection()
+            for obj in selected:
+                asset_group.objects.link(obj)
+        elif (self.options or {}).get("asset_group"):
+            obj = (self.options or {}).get("asset_group")
+            asset_group.objects.link(obj)
+
+        return asset_group
diff --git a/openpype/hosts/blender/plugins/publish/collect_render.py b/openpype/hosts/blender/plugins/publish/collect_render.py
new file mode 100644
index 0000000000..c0d314e466
--- /dev/null
+++ b/openpype/hosts/blender/plugins/publish/collect_render.py
@@ -0,0 +1,81 @@
+# -*- coding: utf-8 -*-
+"""Collect render data."""
+
+import os
+import re
+
+import bpy
+
+import pyblish.api
+
+
+class CollectBlenderRender(pyblish.api.InstancePlugin):
+    """Gather all publishable render layers from renderSetup."""
+
+    order = pyblish.api.CollectorOrder + 0.01
+    hosts = ["blender"]
+    families = ["renderlayer"]
+    label = "Collect Render Layers"
+    sync_workfile_version = False
+
+    def process(self, instance):
+        context = instance.context
+
+        filepath = context.data["currentFile"].replace("\\", "/")
+
+        frame_start = context.data["frameStart"]
+        frame_end = context.data["frameEnd"]
+        frame_handle_start = context.data["frameStartHandle"]
+        frame_handle_end = context.data["frameEndHandle"]
+
+        instance.data.update({
+            "frameStart": frame_start,
+            "frameEnd": frame_end,
+            "frameStartHandle": frame_handle_start,
+            "frameEndHandle": frame_handle_end,
+            "fps": context.data["fps"],
+            "byFrameStep": bpy.context.scene.frame_step,
+            "farm": True,
+            "toBeRenderedOn": "deadline",
+        })
+
+        # instance.data["expectedFiles"] = self.generate_expected_files(
+        #     instance, filepath)
+
+        expected_files = []
+
+        for frame in range(
+            int(frame_start),
+            int(frame_end) + 1,
+            int(bpy.context.scene.frame_step),
+        ):
+            frame_str = str(frame).rjust(4, "0")
+            expected_files.append(f"C:/tmp/{frame_str}.png")
+
+        instance.data["expectedFiles"] = expected_files
+
+        self.log.debug(instance.data["expectedFiles"])
+
+    def generate_expected_files(self, instance, path):
+        """Create expected files in instance data"""
+
+        dir = os.path.dirname(path)
+        file = os.path.basename(path)
+
+        if "#" in file:
+            def replace(match):
+                return "%0{}d".format(len(match.group()))
+
+            file = re.sub("#+", replace, file)
+
+        if "%" not in file:
+            return path
+
+        expected_files = []
+        start = instance.data["frameStart"]
+        end = instance.data["frameEnd"]
+        for i in range(int(start), (int(end) + 1)):
+            expected_files.append(
+                os.path.join(dir, (file % i)).replace("\\", "/"))
+
+        return expected_files
diff --git a/openpype/modules/deadline/plugins/publish/submit_blender_deadline.py b/openpype/modules/deadline/plugins/publish/submit_blender_deadline.py
new file mode 100644
index 0000000000..66be306a52
--- /dev/null
+++ b/openpype/modules/deadline/plugins/publish/submit_blender_deadline.py
@@ -0,0 +1,175 @@
+# -*- coding: utf-8 -*-
+"""Submitting render job to Deadline."""
+
+import os
+import getpass
+import attr
+from datetime import datetime
+
+import bpy
+
+from openpype.lib import is_running_from_build
+from openpype.pipeline import legacy_io
+from openpype.pipeline.farm.tools import iter_expected_files
+from openpype.tests.lib import is_in_tests
+
+from openpype_modules.deadline import abstract_submit_deadline
+from openpype_modules.deadline.abstract_submit_deadline import DeadlineJobInfo
+
+
+def _validate_deadline_bool_value(instance, attribute, value):
+    if not isinstance(value, (str, bool)):
+        raise TypeError(f"Attribute {attribute} must be str or bool.")
+    if value not in {"1", "0", True, False}:
+        raise ValueError(
+            f"Value of {attribute} must be one of '0', '1', True, False")
+
+
+@attr.s
+class BlenderPluginInfo():
+    SceneFile = attr.ib(default=None)   # Input
+    Version = attr.ib(default=None)  # Mandatory for Deadline
+
+
+class BlenderSubmitDeadline(abstract_submit_deadline.AbstractSubmitDeadline):
+    label = "Submit Render to Deadline"
+    hosts = ["blender"]
+    families = ["renderlayer"]
+
+    priority = 50
+
+    jobInfo = {}
+    pluginInfo = {}
+    group = None
+
+    def get_job_info(self):
+        job_info = DeadlineJobInfo(Plugin="Blender")
+
+        job_info.update(self.jobInfo)
+
+        instance = self._instance
+        context = instance.context
+
+        # Always use the original work file name for the Job name even when
+        # rendering is done from the published Work File. The original work
+        # file name is clearer because it can also have subversion strings,
+        # etc. which are stripped for the published file.
+        src_filepath = context.data["currentFile"]
+        src_filename = os.path.basename(src_filepath)
+
+        if is_in_tests():
+            src_filename += datetime.now().strftime("%d%m%Y%H%M%S")
+
+        job_info.Name = f"{src_filename} - {instance.name}"
+        job_info.BatchName = src_filename
+        instance.data.get("blenderRenderPlugin", "Blender")
+        job_info.UserName = context.data.get("deadlineUser", getpass.getuser())
+
+        # Deadline requires integers in frame range
+        frames = "{start}-{end}x{step}".format(
+            start=int(instance.data["frameStartHandle"]),
+            end=int(instance.data["frameEndHandle"]),
+            step=int(instance.data["byFrameStep"]),
+        )
+        job_info.Frames = frames
+
+        job_info.Pool = instance.data.get("primaryPool")
+        job_info.SecondaryPool = instance.data.get("secondaryPool")
+        job_info.Comment = context.data.get("comment")
+        job_info.Priority = instance.data.get("priority", self.priority)
+
+        if self.group != "none" and self.group:
+            job_info.Group = self.group
+
+        attr_values = self.get_attr_values_from_data(instance.data)
+        render_globals = instance.data.setdefault("renderGlobals", {})
+        machine_list = attr_values.get("machineList", "")
+        if machine_list:
+            if attr_values.get("whitelist", True):
+                machine_list_key = "Whitelist"
+            else:
+                machine_list_key = "Blacklist"
+            render_globals[machine_list_key] = machine_list
+
+        job_info.Priority = attr_values.get("priority")
+        job_info.ChunkSize = attr_values.get("chunkSize")
+
+        # Add options from RenderGlobals
+        render_globals = instance.data.get("renderGlobals", {})
+        job_info.update(render_globals)
+
+        keys = [
+            "FTRACK_API_KEY",
+            "FTRACK_API_USER",
+            "FTRACK_SERVER",
+            "OPENPYPE_SG_USER",
+            "AVALON_PROJECT",
+            "AVALON_ASSET",
+            "AVALON_TASK",
+            "AVALON_APP_NAME",
+            "OPENPYPE_DEV"
+            "IS_TEST"
+        ]
+
+        # Add OpenPype version if we are running from build.
+        if is_running_from_build():
+            keys.append("OPENPYPE_VERSION")
+
+        # Add mongo url if it's enabled
+        if self._instance.context.data.get("deadlinePassMongoUrl"):
+            keys.append("OPENPYPE_MONGO")
+
+        environment = dict({key: os.environ[key] for key in keys
+                            if key in os.environ}, **legacy_io.Session)
+
+        for key in keys:
+            value = environment.get(key)
+            if not value:
+                continue
+            job_info.EnvironmentKeyValue[key] = value
+
+        # to recognize job from PYPE for turning Event On/Off
+        job_info.EnvironmentKeyValue["OPENPYPE_RENDER_JOB"] = "1"
+        job_info.EnvironmentKeyValue["OPENPYPE_LOG_NO_COLORS"] = "1"
+
+        # Adding file dependencies.
+        if self.asset_dependencies:
+            dependencies = instance.context.data["fileDependencies"]
+            for dependency in dependencies:
+                job_info.AssetDependency += dependency
+
+        # Add list of expected files to job
+        # ---------------------------------
+        exp = instance.data.get("expectedFiles")
+        for filepath in iter_expected_files(exp):
+            job_info.OutputDirectory += os.path.dirname(filepath)
+            job_info.OutputFilename += os.path.basename(filepath)
+
+        return job_info
+
+    def get_plugin_info(self):
+        instance = self._instance
+        context = instance.context
+
+        plugin_info = BlenderPluginInfo(
+            SceneFile=self.scene_path,
+            Version=bpy.app.version_string,
+        )
+
+        plugin_payload = attr.asdict(plugin_info)
+
+        # Patching with pluginInfo from settings
+        for key, value in self.pluginInfo.items():
+            plugin_payload[key] = value
+
+        return plugin_payload
+
+    def process(self, instance):
+        output_dir = "C:/tmp"
+        instance.data["outputDir"] = output_dir
+
+        super(BlenderSubmitDeadline, self).process(instance)
+
+        # TODO: Avoid the need for this logic here, needed for submit publish
+        # Store output dir for unified publisher (filesequence)
+        # output_dir = os.path.dirname(instance.data["expectedFiles"][0])
diff --git a/openpype/modules/deadline/plugins/publish/submit_publish_job.py b/openpype/modules/deadline/plugins/publish/submit_publish_job.py
index ec182fcd66..47cb441143 100644
--- a/openpype/modules/deadline/plugins/publish/submit_publish_job.py
+++ b/openpype/modules/deadline/plugins/publish/submit_publish_job.py
@@ -95,7 +95,7 @@ class ProcessSubmittedJobOnFarm(pyblish.api.InstancePlugin,
     targets = ["local"]
 
     hosts = ["fusion", "max", "maya", "nuke", "houdini",
-             "celaction", "aftereffects", "harmony"]
+             "celaction", "aftereffects", "harmony", "blender"]
 
     families = ["render.farm", "prerender.farm",
                 "renderlayer", "imagesequence",

From fb76d6348155b6f0db6dee923d74a653921d3707 Mon Sep 17 00:00:00 2001
From: Simone Barbieri <simone.barbieri@hey.com>
Date: Thu, 10 Aug 2023 17:41:02 +0100
Subject: [PATCH 069/366] Implemented settings and removed hardcoded paths

---
 .../blender/plugins/publish/collect_render.py | 150 +++++++++++++-----
 .../publish/submit_blender_deadline.py        |  41 +++--
 .../defaults/project_settings/blender.json    |   4 +
 .../defaults/project_settings/deadline.json   |   9 ++
 .../schema_project_blender.json               |  31 ++++
 .../schema_project_deadline.json              |  44 +++++
 6 files changed, 228 insertions(+), 51 deletions(-)

diff --git a/openpype/hosts/blender/plugins/publish/collect_render.py b/openpype/hosts/blender/plugins/publish/collect_render.py
index c0d314e466..eb37d5b946 100644
--- a/openpype/hosts/blender/plugins/publish/collect_render.py
+++ b/openpype/hosts/blender/plugins/publish/collect_render.py
@@ -6,6 +6,12 @@ import re
 
 import bpy
 
+from openpype.pipeline import (
+    get_current_project_name,
+)
+from openpype.settings import (
+    get_project_settings,
+)
 import pyblish.api
 
 
@@ -18,16 +24,117 @@ class CollectBlenderRender(pyblish.api.InstancePlugin):
     label = "Collect Render Layers"
     sync_workfile_version = False
 
+    @staticmethod
+    def get_default_render_folder(settings):
+        """Get default render folder from blender settings."""
+
+        return (settings["blender"]
+                        ["RenderSettings"]
+                        ["default_render_image_folder"])
+
+    @staticmethod
+    def get_image_format(settings):
+        """Get image format from blender settings."""
+
+        return (settings["blender"]
+                        ["RenderSettings"]
+                        ["image_format"])
+
+    @staticmethod
+    def get_render_product(file_path, render_folder, file_name, instance, ext):
+        output_file = os.path.join(
+            file_path, render_folder, file_name, instance.name)
+
+        render_product = f"{output_file}.####.{ext}"
+        render_product = render_product.replace("\\", "/")
+
+        return render_product
+
+    @staticmethod
+    def generate_expected_files(
+        render_product, frame_start, frame_end, frame_step
+    ):
+        path = os.path.dirname(render_product)
+        file = os.path.basename(render_product)
+
+        expected_files = []
+
+        for frame in range(frame_start, frame_end + 1, frame_step):
+            frame_str = str(frame).rjust(4, "0")
+            expected_file = os.path.join(path, re.sub("#+", frame_str, file))
+            expected_files.append(expected_file.replace("\\", "/"))
+
+        return expected_files
+
+    @staticmethod
+    def set_render_format(ext):
+        image_settings = bpy.context.scene.render.image_settings
+
+        if ext == "exr":
+            image_settings.file_format = "OPEN_EXR"
+        elif ext == "bmp":
+            image_settings.file_format = "BMP"
+        elif ext == "iris":
+            image_settings.file_format = "IRIS"
+        elif ext == "png":
+            image_settings.file_format = "PNG"
+        elif ext == "jpeg":
+            image_settings.file_format = "JPEG"
+        elif ext == "jpeg2000":
+            image_settings.file_format = "JPEG2000"
+        elif ext == "tga":
+            image_settings.file_format = "TARGA"
+        elif ext == "tga_raw":
+            image_settings.file_format = "TARGA_RAW"
+        elif ext == "tiff":
+            image_settings.file_format = "TIFF"
+
+    @staticmethod
+    def set_render_camera(instance):
+        # There should be only one camera in the instance
+        found = False
+        for obj in instance:
+            if isinstance(obj, bpy.types.Object) and obj.type == "CAMERA":
+                bpy.context.scene.camera = obj
+                found = True
+                break
+
+        assert found, "No camera found in the render instance"
+
     def process(self, instance):
         context = instance.context
 
         filepath = context.data["currentFile"].replace("\\", "/")
+        file_path = os.path.dirname(filepath)
+        file_name = os.path.basename(filepath)
+        file_name, _ = os.path.splitext(file_name)
+
+        project = get_current_project_name()
+        settings = get_project_settings(project)
+
+        render_folder = self.get_default_render_folder(settings)
+        ext = self.get_image_format(settings)
+
+        render_product = self.get_render_product(
+            file_path, render_folder, file_name, instance, ext)
+
+        # We set the render path, the format and the camera
+        bpy.context.scene.render.filepath = render_product
+        self.set_render_format(ext)
+        self.set_render_camera(instance)
+
+        # We save the file to save the render settings
+        bpy.ops.wm.save_as_mainfile(filepath=bpy.data.filepath)
 
         frame_start = context.data["frameStart"]
         frame_end = context.data["frameEnd"]
         frame_handle_start = context.data["frameStartHandle"]
         frame_handle_end = context.data["frameEndHandle"]
 
+        expected_files = self.generate_expected_files(
+            render_product, int(frame_start), int(frame_end),
+            int(bpy.context.scene.frame_step))
+
         instance.data.update({
             "frameStart": frame_start,
             "frameEnd": frame_end,
@@ -36,46 +143,7 @@ class CollectBlenderRender(pyblish.api.InstancePlugin):
             "fps": context.data["fps"],
             "byFrameStep": bpy.context.scene.frame_step,
             "farm": True,
-            "toBeRenderedOn": "deadline",
+            "expectedFiles": expected_files,
         })
 
-        # instance.data["expectedFiles"] = self.generate_expected_files(
-        #     instance, filepath)
-
-        expected_files = []
-
-        for frame in range(
-            int(frame_start),
-            int(frame_end) + 1,
-            int(bpy.context.scene.frame_step),
-        ):
-            frame_str = str(frame).rjust(4, "0")
-            expected_files.append(f"C:/tmp/{frame_str}.png")
-
-        instance.data["expectedFiles"] = expected_files
-
-        self.log.debug(instance.data["expectedFiles"])
-
-    def generate_expected_files(self, instance, path):
-        """Create expected files in instance data"""
-
-        dir = os.path.dirname(path)
-        file = os.path.basename(path)
-
-        if "#" in file:
-            def replace(match):
-                return "%0{}d".format(len(match.group()))
-
-            file = re.sub("#+", replace, file)
-
-        if "%" not in file:
-            return path
-
-        expected_files = []
-        start = instance.data["frameStart"]
-        end = instance.data["frameEnd"]
-        for i in range(int(start), (int(end) + 1)):
-            expected_files.append(
-                os.path.join(dir, (file % i)).replace("\\", "/"))
-
-        return expected_files
+        self.log.info(f"data: {instance.data}")
diff --git a/openpype/modules/deadline/plugins/publish/submit_blender_deadline.py b/openpype/modules/deadline/plugins/publish/submit_blender_deadline.py
index 66be306a52..761c5b7b06 100644
--- a/openpype/modules/deadline/plugins/publish/submit_blender_deadline.py
+++ b/openpype/modules/deadline/plugins/publish/submit_blender_deadline.py
@@ -29,6 +29,7 @@ def _validate_deadline_bool_value(instance, attribute, value):
 class BlenderPluginInfo():
     SceneFile = attr.ib(default=None)   # Input
     Version = attr.ib(default=None)  # Mandatory for Deadline
+    SaveFile = attr.ib(default=True)
 
 
 class BlenderSubmitDeadline(abstract_submit_deadline.AbstractSubmitDeadline):
@@ -36,8 +37,9 @@ class BlenderSubmitDeadline(abstract_submit_deadline.AbstractSubmitDeadline):
     hosts = ["blender"]
     families = ["renderlayer"]
 
+    use_published = True
     priority = 50
-
+    chunk_size = 1
     jobInfo = {}
     pluginInfo = {}
     group = None
@@ -148,12 +150,10 @@ class BlenderSubmitDeadline(abstract_submit_deadline.AbstractSubmitDeadline):
         return job_info
 
     def get_plugin_info(self):
-        instance = self._instance
-        context = instance.context
-
         plugin_info = BlenderPluginInfo(
             SceneFile=self.scene_path,
             Version=bpy.app.version_string,
+            SaveFile=True,
         )
 
         plugin_payload = attr.asdict(plugin_info)
@@ -164,12 +164,33 @@ class BlenderSubmitDeadline(abstract_submit_deadline.AbstractSubmitDeadline):
 
         return plugin_payload
 
-    def process(self, instance):
-        output_dir = "C:/tmp"
+    def process_submission(self):
+        instance = self._instance
+
+        expected_files = instance.data["expectedFiles"]
+        if not expected_files:
+            raise RuntimeError("No Render Elements found!")
+
+        output_dir = os.path.dirname(expected_files[0])
         instance.data["outputDir"] = output_dir
+        instance.data["toBeRenderedOn"] = "deadline"
 
-        super(BlenderSubmitDeadline, self).process(instance)
+        file = os.path.basename(bpy.context.scene.render.filepath)
+        bpy.context.scene.render.filepath = os.path.join(output_dir, file)
+        bpy.ops.wm.save_as_mainfile(filepath=bpy.data.filepath)
 
-        # TODO: Avoid the need for this logic here, needed for submit publish
-        # Store output dir for unified publisher (filesequence)
-        # output_dir = os.path.dirname(instance.data["expectedFiles"][0])
+        self.log.debug(f"expected_files[0]: {expected_files[0]}")
+        self.log.debug(f"Output dir: {output_dir}")
+
+        payload = self.assemble_payload()
+        return self.submit(payload)
+
+    def from_published_scene(self):
+        """ Do not overwrite expected files.
+
+            Use published is set to True, so rendering will be triggered
+            from published scene (in 'publish' folder). Default implementation
+            of abstract class renames expected (eg. rendered) files accordingly
+            which is not needed here.
+        """
+        return super().from_published_scene(False)
diff --git a/openpype/settings/defaults/project_settings/blender.json b/openpype/settings/defaults/project_settings/blender.json
index df865adeba..333a1fed56 100644
--- a/openpype/settings/defaults/project_settings/blender.json
+++ b/openpype/settings/defaults/project_settings/blender.json
@@ -17,6 +17,10 @@
             "rules": {}
         }
     },
+    "RenderSettings": {
+        "default_render_image_folder": "renders/blender",
+        "image_format": "exr"
+    },
     "workfile_builder": {
         "create_first_version": false,
         "custom_templates": []
diff --git a/openpype/settings/defaults/project_settings/deadline.json b/openpype/settings/defaults/project_settings/deadline.json
index 1b8c8397d7..33ea533863 100644
--- a/openpype/settings/defaults/project_settings/deadline.json
+++ b/openpype/settings/defaults/project_settings/deadline.json
@@ -99,6 +99,15 @@
             "deadline_chunk_size": 10,
             "deadline_job_delay": "00:00:00:00"
         },
+        "BlenderSubmitDeadline": {
+            "enabled": true,
+            "optional": false,
+            "active": true,
+            "use_published": true,
+            "priority": 50,
+            "chunk_size": 10,
+            "group": "none"
+        },
         "ProcessSubmittedJobOnFarm": {
             "enabled": true,
             "deadline_department": "",
diff --git a/openpype/settings/entities/schemas/projects_schema/schema_project_blender.json b/openpype/settings/entities/schemas/projects_schema/schema_project_blender.json
index aeb70dfd8c..787e190de5 100644
--- a/openpype/settings/entities/schemas/projects_schema/schema_project_blender.json
+++ b/openpype/settings/entities/schemas/projects_schema/schema_project_blender.json
@@ -54,6 +54,37 @@
                 }
             ]
         },
+        {
+            "type": "dict",
+            "collapsible": true,
+            "key": "RenderSettings",
+            "label": "Render Settings",
+            "children": [
+                {
+                    "type": "text",
+                    "key": "default_render_image_folder",
+                    "label": "Default render image folder"
+                },
+                {
+                  "key": "image_format",
+                  "label": "Output Image Format",
+                  "type": "enum",
+                  "multiselection": false,
+                  "defaults": "exr",
+                  "enum_items": [
+                    {"exr":      "exr"},
+                    {"bmp":      "bmp"},
+                    {"iris":     "iris"},
+                    {"png":      "png"},
+                    {"jpeg":     "jpeg"},
+                    {"jpeg2000": "jpeg2000"},
+                    {"tga":      "tga"},
+                    {"tga_raw":  "tga_raw"},
+                    {"tiff":     "tiff"}
+                  ]
+                }
+            ]
+        },
         {
             "type": "schema_template",
             "name": "template_workfile_options",
diff --git a/openpype/settings/entities/schemas/projects_schema/schema_project_deadline.json b/openpype/settings/entities/schemas/projects_schema/schema_project_deadline.json
index 6d59b5a92b..596bc30f91 100644
--- a/openpype/settings/entities/schemas/projects_schema/schema_project_deadline.json
+++ b/openpype/settings/entities/schemas/projects_schema/schema_project_deadline.json
@@ -531,6 +531,50 @@
                         }
                     ]
                 },
+                {
+                    "type": "dict",
+                    "collapsible": true,
+                    "key": "BlenderSubmitDeadline",
+                    "label": "Blender Submit to Deadline",
+                    "checkbox_key": "enabled",
+                    "children": [
+                        {
+                            "type": "boolean",
+                            "key": "enabled",
+                            "label": "Enabled"
+                        },
+                        {
+                            "type": "boolean",
+                            "key": "optional",
+                            "label": "Optional"
+                        },
+                        {
+                            "type": "boolean",
+                            "key": "active",
+                            "label": "Active"
+                        },
+                        {
+                            "type": "boolean",
+                            "key": "use_published",
+                            "label": "Use Published scene"
+                        },
+                        {
+                            "type": "number",
+                            "key": "priority",
+                            "label": "Priority"
+                        },
+                        {
+                            "type": "number",
+                            "key": "chunk_size",
+                            "label": "Frame per Task"
+                        },
+                        {
+                            "type": "text",
+                            "key": "group",
+                            "label": "Group Name"
+                        }
+                    ]
+                },
                 {
                     "type": "dict",
                     "collapsible": true,

From a1e8a5eb4c49893291403c4283a60b8a7fad27cf Mon Sep 17 00:00:00 2001
From: Simone Barbieri <simone.barbieri@hey.com>
Date: Thu, 10 Aug 2023 17:54:45 +0100
Subject: [PATCH 070/366] Removed some missed leftover code

---
 .../deadline/plugins/publish/submit_blender_deadline.py    | 7 -------
 1 file changed, 7 deletions(-)

diff --git a/openpype/modules/deadline/plugins/publish/submit_blender_deadline.py b/openpype/modules/deadline/plugins/publish/submit_blender_deadline.py
index 761c5b7b06..b3deb39399 100644
--- a/openpype/modules/deadline/plugins/publish/submit_blender_deadline.py
+++ b/openpype/modules/deadline/plugins/publish/submit_blender_deadline.py
@@ -175,13 +175,6 @@ class BlenderSubmitDeadline(abstract_submit_deadline.AbstractSubmitDeadline):
         instance.data["outputDir"] = output_dir
         instance.data["toBeRenderedOn"] = "deadline"
 
-        file = os.path.basename(bpy.context.scene.render.filepath)
-        bpy.context.scene.render.filepath = os.path.join(output_dir, file)
-        bpy.ops.wm.save_as_mainfile(filepath=bpy.data.filepath)
-
-        self.log.debug(f"expected_files[0]: {expected_files[0]}")
-        self.log.debug(f"Output dir: {output_dir}")
-
         payload = self.assemble_payload()
         return self.submit(payload)
 

From 17b5a86c51c3d1ca3f1a16f8cb249f8c3e8d5ca4 Mon Sep 17 00:00:00 2001
From: Simone Barbieri <simone.barbieri@hey.com>
Date: Fri, 11 Aug 2023 11:24:09 +0100
Subject: [PATCH 071/366] Fixed problem with image format

---
 .../blender/plugins/publish/collect_render.py   |  8 +++-----
 .../projects_schema/schema_project_blender.json | 17 ++++++++---------
 2 files changed, 11 insertions(+), 14 deletions(-)

diff --git a/openpype/hosts/blender/plugins/publish/collect_render.py b/openpype/hosts/blender/plugins/publish/collect_render.py
index eb37d5b946..11b98c76e6 100644
--- a/openpype/hosts/blender/plugins/publish/collect_render.py
+++ b/openpype/hosts/blender/plugins/publish/collect_render.py
@@ -74,19 +74,17 @@ class CollectBlenderRender(pyblish.api.InstancePlugin):
             image_settings.file_format = "OPEN_EXR"
         elif ext == "bmp":
             image_settings.file_format = "BMP"
-        elif ext == "iris":
+        elif ext == "rgb":
             image_settings.file_format = "IRIS"
         elif ext == "png":
             image_settings.file_format = "PNG"
         elif ext == "jpeg":
             image_settings.file_format = "JPEG"
-        elif ext == "jpeg2000":
+        elif ext == "jp2":
             image_settings.file_format = "JPEG2000"
         elif ext == "tga":
             image_settings.file_format = "TARGA"
-        elif ext == "tga_raw":
-            image_settings.file_format = "TARGA_RAW"
-        elif ext == "tiff":
+        elif ext == "tif":
             image_settings.file_format = "TIFF"
 
     @staticmethod
diff --git a/openpype/settings/entities/schemas/projects_schema/schema_project_blender.json b/openpype/settings/entities/schemas/projects_schema/schema_project_blender.json
index 787e190de5..84efec5c0a 100644
--- a/openpype/settings/entities/schemas/projects_schema/schema_project_blender.json
+++ b/openpype/settings/entities/schemas/projects_schema/schema_project_blender.json
@@ -72,15 +72,14 @@
                   "multiselection": false,
                   "defaults": "exr",
                   "enum_items": [
-                    {"exr":      "exr"},
-                    {"bmp":      "bmp"},
-                    {"iris":     "iris"},
-                    {"png":      "png"},
-                    {"jpeg":     "jpeg"},
-                    {"jpeg2000": "jpeg2000"},
-                    {"tga":      "tga"},
-                    {"tga_raw":  "tga_raw"},
-                    {"tiff":     "tiff"}
+                    {"exr": "OpenEXR"},
+                    {"bmp": "BMP"},
+                    {"rgb": "Iris"},
+                    {"png": "PNG"},
+                    {"jpg": "JPEG"},
+                    {"jp2": "JPEG 2000"},
+                    {"tga": "Targa"},
+                    {"tif": "TIFF"}
                   ]
                 }
             ]

From f79f0c44da2e486887f0078c7e3d4dcfa2d4e007 Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Fri, 11 Aug 2023 12:27:09 +0200
Subject: [PATCH 072/366] Add to cleanup files

Co-authored-by: Jakub Trllo <43494761+iLLiCiTiT@users.noreply.github.com>
---
 .../hosts/maya/plugins/publish/extract_active_view_thumbnail.py  | 1 +
 1 file changed, 1 insertion(+)

diff --git a/openpype/hosts/maya/plugins/publish/extract_active_view_thumbnail.py b/openpype/hosts/maya/plugins/publish/extract_active_view_thumbnail.py
index cb039cbf51..b4e62f8acc 100644
--- a/openpype/hosts/maya/plugins/publish/extract_active_view_thumbnail.py
+++ b/openpype/hosts/maya/plugins/publish/extract_active_view_thumbnail.py
@@ -46,5 +46,6 @@ class ExtractActiveViewThumbnail(pyblish.api.InstancePlugin):
             image.writeToFile(path, "jpg")
             self.log.debug("Generated thumbnail: {}".format(path))
 
+            context.data["cleanupFullPaths"].append(path)
             context.data[cache_key] = path
         return context.data[cache_key]

From 7d7a41792e96ab3eb93a48e8c641f8bba3ec0f58 Mon Sep 17 00:00:00 2001
From: Simone Barbieri <simone.barbieri@hey.com>
Date: Fri, 11 Aug 2023 14:52:15 +0100
Subject: [PATCH 073/366] Added more comments

---
 .../blender/plugins/publish/collect_render.py     | 15 +++++++++++++++
 .../plugins/publish/submit_blender_deadline.py    | 11 +++++------
 2 files changed, 20 insertions(+), 6 deletions(-)

diff --git a/openpype/hosts/blender/plugins/publish/collect_render.py b/openpype/hosts/blender/plugins/publish/collect_render.py
index 11b98c76e6..7f060c3b7c 100644
--- a/openpype/hosts/blender/plugins/publish/collect_render.py
+++ b/openpype/hosts/blender/plugins/publish/collect_render.py
@@ -42,6 +42,17 @@ class CollectBlenderRender(pyblish.api.InstancePlugin):
 
     @staticmethod
     def get_render_product(file_path, render_folder, file_name, instance, ext):
+        """
+        Generate the path to the render product. Blender interprets the `#`
+        as the frame number, when it renders.
+
+        Args:
+            file_path (str): The path to the blender scene.
+            render_folder (str): The render folder set in settings.
+            file_name (str): The name of the blender scene.
+            instance (pyblish.api.Instance): The instance to publish.
+            ext (str): The image format to render.
+        """
         output_file = os.path.join(
             file_path, render_folder, file_name, instance.name)
 
@@ -54,6 +65,10 @@ class CollectBlenderRender(pyblish.api.InstancePlugin):
     def generate_expected_files(
         render_product, frame_start, frame_end, frame_step
     ):
+        """Generate the expected files for the render product.
+        This returns a list of files that should be rendered. It replaces
+        the sequence of `#` with the frame number.
+        """
         path = os.path.dirname(render_product)
         file = os.path.basename(render_product)
 
diff --git a/openpype/modules/deadline/plugins/publish/submit_blender_deadline.py b/openpype/modules/deadline/plugins/publish/submit_blender_deadline.py
index b3deb39399..7aee087ddc 100644
--- a/openpype/modules/deadline/plugins/publish/submit_blender_deadline.py
+++ b/openpype/modules/deadline/plugins/publish/submit_blender_deadline.py
@@ -179,11 +179,10 @@ class BlenderSubmitDeadline(abstract_submit_deadline.AbstractSubmitDeadline):
         return self.submit(payload)
 
     def from_published_scene(self):
-        """ Do not overwrite expected files.
-
-            Use published is set to True, so rendering will be triggered
-            from published scene (in 'publish' folder). Default implementation
-            of abstract class renames expected (eg. rendered) files accordingly
-            which is not needed here.
+        """
+        This is needed to set the correct path for the json metadata. Because
+        the rendering path is set in the blend file during the collection,
+        and the path is adjusted to use the published scene, this ensures that
+        the metadata and the rendered files are in the same location.
         """
         return super().from_published_scene(False)

From 94c801ce84fb1bd99ffe57fee9bb0ea127dc03c9 Mon Sep 17 00:00:00 2001
From: Simone Barbieri <simone.barbieri@hey.com>
Date: Fri, 11 Aug 2023 14:52:28 +0100
Subject: [PATCH 074/366] Removed redundant code

---
 .../deadline/plugins/publish/submit_blender_deadline.py   | 8 --------
 1 file changed, 8 deletions(-)

diff --git a/openpype/modules/deadline/plugins/publish/submit_blender_deadline.py b/openpype/modules/deadline/plugins/publish/submit_blender_deadline.py
index 7aee087ddc..9bfc4fbb07 100644
--- a/openpype/modules/deadline/plugins/publish/submit_blender_deadline.py
+++ b/openpype/modules/deadline/plugins/publish/submit_blender_deadline.py
@@ -17,14 +17,6 @@ from openpype_modules.deadline import abstract_submit_deadline
 from openpype_modules.deadline.abstract_submit_deadline import DeadlineJobInfo
 
 
-def _validate_deadline_bool_value(instance, attribute, value):
-    if not isinstance(value, (str, bool)):
-        raise TypeError(f"Attribute {attribute} must be str or bool.")
-    if value not in {"1", "0", True, False}:
-        raise ValueError(
-            f"Value of {attribute} must be one of '0', '1', True, False")
-
-
 @attr.s
 class BlenderPluginInfo():
     SceneFile = attr.ib(default=None)   # Input

From 444cca4213128d470641a58ffac4602b9ac5f833 Mon Sep 17 00:00:00 2001
From: Kayla Man <moonyuet2008@hotmail.com>
Date: Mon, 21 Aug 2023 15:30:46 +0800
Subject: [PATCH 075/366] load max scene wip

---
 .../hosts/max/plugins/load/load_max_scene.py  | 66 +++++++++++++------
 1 file changed, 47 insertions(+), 19 deletions(-)

diff --git a/openpype/hosts/max/plugins/load/load_max_scene.py b/openpype/hosts/max/plugins/load/load_max_scene.py
index 1d105f1bc0..6dfb3d0115 100644
--- a/openpype/hosts/max/plugins/load/load_max_scene.py
+++ b/openpype/hosts/max/plugins/load/load_max_scene.py
@@ -1,7 +1,11 @@
 import os
 
 from openpype.hosts.max.api import lib
-from openpype.hosts.max.api.pipeline import containerise
+from openpype.hosts.max.api.lib import unique_namespace
+from openpype.hosts.max.api.pipeline import (
+    containerise, import_custom_attribute_data,
+    update_custom_attribute_data
+)
 from openpype.pipeline import get_representation_path, load
 
 
@@ -19,37 +23,61 @@ class MaxSceneLoader(load.LoaderPlugin):
 
     def load(self, context, name=None, namespace=None, data=None):
         from pymxs import runtime as rt
-
         path = self.filepath_from_context(context)
         path = os.path.normpath(path)
         # import the max scene by using "merge file"
         path = path.replace('\\', '/')
-        rt.MergeMaxFile(
-            path, rt.Name("mergeDups"),
-            includeFullGroup=True)
+        rt.MergeMaxFile(path, quiet=True, includeFullGroup=True)
         max_objects = rt.getLastMergedNodes()
+        # implement the OP/AYON custom attributes before load
+        max_container = []
 
+        namespace = unique_namespace(
+            name + "_",
+            suffix="_",
+        )
+        container = rt.Container(name=f"{namespace}:{name}")
+        import_custom_attribute_data(container, max_objects)
+        max_container.append(container)
+        max_container.extend(max_objects)
         return containerise(
-            name, [max_objects], context, loader=self.__class__.__name__)
+            name, max_container, context,
+            namespace, loader=self.__class__.__name__)
 
     def update(self, container, representation):
         from pymxs import runtime as rt
 
         path = get_representation_path(representation)
-        prev_max_objects = rt.getLastMergedNodes()
-        merged_max_objects = [obj.name for obj
-                              in prev_max_objects]
-        rt.MergeMaxFile(
-            path, merged_max_objects,
-            rt.Name("deleteOldDups"),
-            quiet=True,
-            mergedNodes=prev_max_objects,
-            includeFullGroup=True)
+        node_name = container["instance_node"]
+
+        node = rt.getNodeByName(node_name)
+        param_container = node_name.split("_CON")[0]
+
+        # delete the old container with attribute
+        # delete old duplicate
+        prev_max_object_names = [obj.name for obj
+                                 in rt.getLastMergedNodes()]
+        rt.MergeMaxFile(path, rt.Name("deleteOldDups"))
+
         current_max_objects = rt.getLastMergedNodes()
-        for current_object in current_max_objects:
-            prev_max_objects = prev_max_objects.remove(current_object)
-        for prev_object in prev_max_objects:
-            rt.Delete(prev_object)
+        current_max_object_names = [obj.name for obj
+                                    in current_max_objects]
+        for name in current_max_object_names:
+            idx = rt.findItem(prev_max_object_names, name)
+            if idx:
+                prev_max_object_names = rt.deleteItem(
+                    prev_max_object_names, idx)
+        for object_name in prev_max_object_names:
+            prev_max_object = rt.getNodeByName(object_name)
+            rt.Delete(prev_max_object)
+
+        for max_object in current_max_objects:
+            max_object.Parent = node
+        for children in node.Children:
+            if rt.classOf(children) == rt.Container:
+                if children.name == param_container:
+                    update_custom_attribute_data(
+                        children, current_max_objects)
 
         lib.imprint(container["instance_node"], {
             "representation": str(representation["_id"])

From dfd748ccd191e3d6058529d8deaf2865c7a9ec89 Mon Sep 17 00:00:00 2001
From: Toke Stuart Jepsen <tokejepsen@gmail.com>
Date: Tue, 22 Aug 2023 08:27:52 +0100
Subject: [PATCH 076/366] Remove force copy option

---
 openpype/hosts/maya/plugins/create/create_look.py | 8 +-------
 1 file changed, 1 insertion(+), 7 deletions(-)

diff --git a/openpype/hosts/maya/plugins/create/create_look.py b/openpype/hosts/maya/plugins/create/create_look.py
index 385ae81e01..11a69151fd 100644
--- a/openpype/hosts/maya/plugins/create/create_look.py
+++ b/openpype/hosts/maya/plugins/create/create_look.py
@@ -37,13 +37,7 @@ class CreateLook(plugin.MayaCreator):
                     label="Convert textures to .rstex",
                     tooltip="Whether to generate Redshift .rstex files for "
                             "your textures",
-                    default=self.rs_tex),
-            BoolDef("forceCopy",
-                    label="Force Copy",
-                    tooltip="Enable users to force a copy instead of hardlink."
-                            "\nNote: On Windows copy is always forced due to "
-                            "bugs in windows' implementation of hardlinks.",
-                    default=False)
+                    default=self.rs_tex)
         ]
 
     def get_pre_create_attr_defs(self):

From 85b49ec761deb3187ded2ee4262f23efa227c40f Mon Sep 17 00:00:00 2001
From: Simone Barbieri <simone.barbieri@hey.com>
Date: Tue, 22 Aug 2023 10:52:02 +0100
Subject: [PATCH 077/366] Basic implementation for AOVs rendering

---
 .../blender/plugins/publish/collect_render.py | 101 ++++++++++++++++--
 1 file changed, 95 insertions(+), 6 deletions(-)

diff --git a/openpype/hosts/blender/plugins/publish/collect_render.py b/openpype/hosts/blender/plugins/publish/collect_render.py
index 7f060c3b7c..fafdd9cc2d 100644
--- a/openpype/hosts/blender/plugins/publish/collect_render.py
+++ b/openpype/hosts/blender/plugins/publish/collect_render.py
@@ -12,6 +12,10 @@ from openpype.pipeline import (
 from openpype.settings import (
     get_project_settings,
 )
+from openpype.hosts.blender.api.ops import (
+    MainThreadItem,
+    execute_in_main_thread
+)
 import pyblish.api
 
 
@@ -41,7 +45,7 @@ class CollectBlenderRender(pyblish.api.InstancePlugin):
                         ["image_format"])
 
     @staticmethod
-    def get_render_product(file_path, render_folder, file_name, instance, ext):
+    def get_render_product(output_path, instance):
         """
         Generate the path to the render product. Blender interprets the `#`
         as the frame number, when it renders.
@@ -53,10 +57,9 @@ class CollectBlenderRender(pyblish.api.InstancePlugin):
             instance (pyblish.api.Instance): The instance to publish.
             ext (str): The image format to render.
         """
-        output_file = os.path.join(
-            file_path, render_folder, file_name, instance.name)
+        output_file = os.path.join(output_path, instance.name)
 
-        render_product = f"{output_file}.####.{ext}"
+        render_product = f"{output_file}.####"
         render_product = render_product.replace("\\", "/")
 
         return render_product
@@ -83,9 +86,13 @@ class CollectBlenderRender(pyblish.api.InstancePlugin):
 
     @staticmethod
     def set_render_format(ext):
+        # Set Blender to save the file with the right extension
+        bpy.context.scene.render.use_file_extension = True
+
         image_settings = bpy.context.scene.render.image_settings
 
         if ext == "exr":
+            # TODO: Check if multilayer option is selected
             image_settings.file_format = "OPEN_EXR"
         elif ext == "bmp":
             image_settings.file_format = "BMP"
@@ -102,6 +109,86 @@ class CollectBlenderRender(pyblish.api.InstancePlugin):
         elif ext == "tif":
             image_settings.file_format = "TIFF"
 
+    def _set_node_tree(self, output_path, instance):
+        # Set the scene to use the compositor node tree to render
+        bpy.context.scene.use_nodes = True
+
+        tree = bpy.context.scene.node_tree
+
+        # Get the Render Layers node
+        rl_node = None
+        for node in tree.nodes:
+            if node.bl_idname == "CompositorNodeRLayers":
+                rl_node = node
+                break
+
+        # If there's not a Render Layers node, we create it
+        if not rl_node:
+            rl_node = tree.nodes.new("CompositorNodeRLayers")
+
+        # Get the enabled output sockets, that are the active passes for the
+        # render.
+        # We also exclude some layers.
+        exclude_sockets = ["Image", "Alpha"]
+        passes = [
+            socket for socket in rl_node.outputs
+            if socket.enabled and socket.name not in exclude_sockets
+        ]
+
+        # Remove all output nodes
+        for node in tree.nodes:
+            if node.bl_idname == "CompositorNodeOutputFile":
+                tree.nodes.remove(node)
+
+        # Create a new output node
+        output = tree.nodes.new("CompositorNodeOutputFile")
+
+
+        context = bpy.context.copy()
+        # context = create_blender_context()
+        context["node"] = output
+
+        win = bpy.context.window_manager.windows[0]
+        screen = win.screen
+        area = screen.areas[0]
+        region = area.regions[0]
+
+        context["window"] = win
+        context['screen'] = screen
+        context['area'] = area
+        context['region'] = region
+
+        self.log.debug(f"context: {context}")
+
+        # Change area type to node editor, to execute node operators
+        old_area_type = area.ui_type
+        area.ui_type = "CompositorNodeTree"
+
+        # Remove the default input socket from the output node
+        bpy.ops.node.output_file_remove_active_socket(context)
+
+        output.base_path = output_path
+        image_settings = bpy.context.scene.render.image_settings
+        output.format.file_format = image_settings.file_format
+
+        # For each active render pass, we add a new socket to the output node
+        # and link it
+        for render_pass in passes:
+            bpy.ops.node.output_file_add_socket(
+                context, file_path=f"{instance.name}_{render_pass.name}.####")
+
+            node_input = output.inputs[-1]
+
+            tree.links.new(render_pass, node_input)
+
+        # Restore the area type
+        area.ui_type = old_area_type
+
+    def set_node_tree(self, output_path, instance):
+        """ Run the creator on Blender main thread"""
+        mti = MainThreadItem(self._set_node_tree, output_path, instance)
+        execute_in_main_thread(mti)
+
     @staticmethod
     def set_render_camera(instance):
         # There should be only one camera in the instance
@@ -128,8 +215,10 @@ class CollectBlenderRender(pyblish.api.InstancePlugin):
         render_folder = self.get_default_render_folder(settings)
         ext = self.get_image_format(settings)
 
-        render_product = self.get_render_product(
-            file_path, render_folder, file_name, instance, ext)
+        output_path = os.path.join(file_path, render_folder, file_name)
+
+        render_product = self.get_render_product(output_path, instance)
+        self.set_node_tree(output_path, instance)
 
         # We set the render path, the format and the camera
         bpy.context.scene.render.filepath = render_product

From ef58284bceb6bff2a6ee965bc456600d821e80a8 Mon Sep 17 00:00:00 2001
From: Toke Stuart Jepsen <tokejepsen@gmail.com>
Date: Tue, 22 Aug 2023 11:30:45 +0100
Subject: [PATCH 078/366] Respect persistent dir on Deadline.

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

diff --git a/openpype/plugins/publish/collect_rendered_files.py b/openpype/plugins/publish/collect_rendered_files.py
index 4b95d8ac44..dc54e296e1 100644
--- a/openpype/plugins/publish/collect_rendered_files.py
+++ b/openpype/plugins/publish/collect_rendered_files.py
@@ -103,13 +103,16 @@ class CollectRenderedFiles(pyblish.api.ContextPlugin):
 
             # stash render job id for later validation
             instance.data["render_job_id"] = data.get("job").get("_id")
-
+            staging_dir_persistent = instance.data.get(
+                "stagingDir_persistent", False
+            )
             representations = []
             for repre_data in instance_data.get("representations") or []:
                 self._fill_staging_dir(repre_data, anatomy)
                 representations.append(repre_data)
 
-                add_repre_files_for_cleanup(instance, repre_data)
+                if not staging_dir_persistent:
+                    add_repre_files_for_cleanup(instance, repre_data)
 
             instance.data["representations"] = representations
 
@@ -124,7 +127,7 @@ class CollectRenderedFiles(pyblish.api.ContextPlugin):
                 self.log.info(
                     f"Adding audio to instance: {instance.data['audio']}")
 
-            return instance.data.get("stagingDir_persistent", False)
+            return staging_dir_persistent
 
     def process(self, context):
         self._context = context

From eb1b5425de4aa546eaaae682f2acf9209dadf359 Mon Sep 17 00:00:00 2001
From: Simone Barbieri <simone.barbieri@hey.com>
Date: Tue, 22 Aug 2023 11:54:49 +0100
Subject: [PATCH 079/366] Added support for multilayer EXR

---
 .../blender/plugins/publish/collect_render.py | 48 ++++++++++++-------
 .../defaults/project_settings/blender.json    |  3 +-
 .../schema_project_blender.json               | 35 ++++++++------
 3 files changed, 52 insertions(+), 34 deletions(-)

diff --git a/openpype/hosts/blender/plugins/publish/collect_render.py b/openpype/hosts/blender/plugins/publish/collect_render.py
index fafdd9cc2d..cd3b922697 100644
--- a/openpype/hosts/blender/plugins/publish/collect_render.py
+++ b/openpype/hosts/blender/plugins/publish/collect_render.py
@@ -44,6 +44,14 @@ class CollectBlenderRender(pyblish.api.InstancePlugin):
                         ["RenderSettings"]
                         ["image_format"])
 
+    @staticmethod
+    def get_multilayer(settings):
+        """Get multilayer from blender settings."""
+
+        return (settings["blender"]
+                        ["RenderSettings"]
+                        ["multilayer_exr"])
+
     @staticmethod
     def get_render_product(output_path, instance):
         """
@@ -85,15 +93,15 @@ class CollectBlenderRender(pyblish.api.InstancePlugin):
         return expected_files
 
     @staticmethod
-    def set_render_format(ext):
+    def set_render_format(ext, multilayer):
         # Set Blender to save the file with the right extension
         bpy.context.scene.render.use_file_extension = True
 
         image_settings = bpy.context.scene.render.image_settings
 
         if ext == "exr":
-            # TODO: Check if multilayer option is selected
-            image_settings.file_format = "OPEN_EXR"
+            image_settings.file_format = (
+                "OPEN_EXR_MULTILAYER" if multilayer else "OPEN_EXR")
         elif ext == "bmp":
             image_settings.file_format = "BMP"
         elif ext == "rgb":
@@ -109,6 +117,21 @@ class CollectBlenderRender(pyblish.api.InstancePlugin):
         elif ext == "tif":
             image_settings.file_format = "TIFF"
 
+    def _create_context():
+        context = bpy.context.copy()
+
+        win = bpy.context.window_manager.windows[0]
+        screen = win.screen
+        area = screen.areas[0]
+        region = area.regions[0]
+
+        context["window"] = win
+        context['screen'] = screen
+        context['area'] = area
+        context['region'] = region
+
+        return context
+
     def _set_node_tree(self, output_path, instance):
         # Set the scene to use the compositor node tree to render
         bpy.context.scene.use_nodes = True
@@ -143,22 +166,10 @@ class CollectBlenderRender(pyblish.api.InstancePlugin):
         # Create a new output node
         output = tree.nodes.new("CompositorNodeOutputFile")
 
-
-        context = bpy.context.copy()
-        # context = create_blender_context()
+        context = self._create_context()
         context["node"] = output
 
-        win = bpy.context.window_manager.windows[0]
-        screen = win.screen
-        area = screen.areas[0]
-        region = area.regions[0]
-
-        context["window"] = win
-        context['screen'] = screen
-        context['area'] = area
-        context['region'] = region
-
-        self.log.debug(f"context: {context}")
+        area = context["area"]
 
         # Change area type to node editor, to execute node operators
         old_area_type = area.ui_type
@@ -214,6 +225,7 @@ class CollectBlenderRender(pyblish.api.InstancePlugin):
 
         render_folder = self.get_default_render_folder(settings)
         ext = self.get_image_format(settings)
+        multilayer = self.get_multilayer(settings)
 
         output_path = os.path.join(file_path, render_folder, file_name)
 
@@ -222,7 +234,7 @@ class CollectBlenderRender(pyblish.api.InstancePlugin):
 
         # We set the render path, the format and the camera
         bpy.context.scene.render.filepath = render_product
-        self.set_render_format(ext)
+        self.set_render_format(ext, multilayer)
         self.set_render_camera(instance)
 
         # We save the file to save the render settings
diff --git a/openpype/settings/defaults/project_settings/blender.json b/openpype/settings/defaults/project_settings/blender.json
index 333a1fed56..c375e550c2 100644
--- a/openpype/settings/defaults/project_settings/blender.json
+++ b/openpype/settings/defaults/project_settings/blender.json
@@ -19,7 +19,8 @@
     },
     "RenderSettings": {
         "default_render_image_folder": "renders/blender",
-        "image_format": "exr"
+        "image_format": "exr",
+        "multilayer_exr": true
     },
     "workfile_builder": {
         "create_first_version": false,
diff --git a/openpype/settings/entities/schemas/projects_schema/schema_project_blender.json b/openpype/settings/entities/schemas/projects_schema/schema_project_blender.json
index 84efec5c0a..d8ef1eee3e 100644
--- a/openpype/settings/entities/schemas/projects_schema/schema_project_blender.json
+++ b/openpype/settings/entities/schemas/projects_schema/schema_project_blender.json
@@ -66,21 +66,26 @@
                     "label": "Default render image folder"
                 },
                 {
-                  "key": "image_format",
-                  "label": "Output Image Format",
-                  "type": "enum",
-                  "multiselection": false,
-                  "defaults": "exr",
-                  "enum_items": [
-                    {"exr": "OpenEXR"},
-                    {"bmp": "BMP"},
-                    {"rgb": "Iris"},
-                    {"png": "PNG"},
-                    {"jpg": "JPEG"},
-                    {"jp2": "JPEG 2000"},
-                    {"tga": "Targa"},
-                    {"tif": "TIFF"}
-                  ]
+                    "key": "image_format",
+                    "label": "Output Image Format",
+                    "type": "enum",
+                    "multiselection": false,
+                    "defaults": "exr",
+                    "enum_items": [
+                        {"exr": "OpenEXR"},
+                        {"bmp": "BMP"},
+                        {"rgb": "Iris"},
+                        {"png": "PNG"},
+                        {"jpg": "JPEG"},
+                        {"jp2": "JPEG 2000"},
+                        {"tga": "Targa"},
+                        {"tif": "TIFF"}
+                    ]
+                },
+                {
+                    "key": "multilayer_exr",
+                    "type": "boolean",
+                    "label": "Multilayer (EXR)"
                 }
             ]
         },

From 9f56721334c8a7d42aa88c34ee4ef01befeb153d Mon Sep 17 00:00:00 2001
From: Simone Barbieri <simone.barbieri@hey.com>
Date: Tue, 22 Aug 2023 15:56:23 +0100
Subject: [PATCH 080/366] Implemented AOVs rendering in deadline and publishing

---
 openpype/hosts/blender/api/colorspace.py      | 52 +++++++++++
 .../blender/plugins/publish/collect_render.py | 92 ++++++++++++++-----
 .../publish/submit_blender_deadline.py        |  3 +-
 3 files changed, 122 insertions(+), 25 deletions(-)
 create mode 100644 openpype/hosts/blender/api/colorspace.py

diff --git a/openpype/hosts/blender/api/colorspace.py b/openpype/hosts/blender/api/colorspace.py
new file mode 100644
index 0000000000..59deb514f8
--- /dev/null
+++ b/openpype/hosts/blender/api/colorspace.py
@@ -0,0 +1,52 @@
+import attr
+
+import bpy
+
+
+@attr.s
+class LayerMetadata(object):
+    """Data class for Render Layer metadata."""
+    frameStart = attr.ib()
+    frameEnd = attr.ib()
+
+
+@attr.s
+class RenderProduct(object):
+    """Getting Colorspace as
+    Specific Render Product Parameter for submitting
+    publish job.
+    """
+    colorspace = attr.ib()                      # colorspace
+    view = attr.ib()
+    productName = attr.ib(default=None)
+
+
+class ARenderProduct(object):
+
+    def __init__(self):
+        """Constructor."""
+        # Initialize
+        self.layer_data = self._get_layer_data()
+        self.layer_data.products = self.get_colorspace_data()
+
+    def _get_layer_data(self):
+        scene = bpy.context.scene
+
+        return LayerMetadata(
+            frameStart=int(scene.frame_start),
+            frameEnd=int(scene.frame_end),
+        )
+
+    def get_colorspace_data(self):
+        """To be implemented by renderer class.
+        This should return a list of RenderProducts.
+        Returns:
+            list: List of RenderProduct
+        """
+        return [
+            RenderProduct(
+                colorspace="sRGB",
+                view="ACES 1.0",
+                productName=""
+            )
+        ]
diff --git a/openpype/hosts/blender/plugins/publish/collect_render.py b/openpype/hosts/blender/plugins/publish/collect_render.py
index cd3b922697..becb735c21 100644
--- a/openpype/hosts/blender/plugins/publish/collect_render.py
+++ b/openpype/hosts/blender/plugins/publish/collect_render.py
@@ -12,10 +12,7 @@ from openpype.pipeline import (
 from openpype.settings import (
     get_project_settings,
 )
-from openpype.hosts.blender.api.ops import (
-    MainThreadItem,
-    execute_in_main_thread
-)
+from openpype.hosts.blender.api import colorspace
 import pyblish.api
 
 
@@ -73,12 +70,13 @@ class CollectBlenderRender(pyblish.api.InstancePlugin):
         return render_product
 
     @staticmethod
-    def generate_expected_files(
-        render_product, frame_start, frame_end, frame_step
+    def generate_expected_beauty(
+        render_product, frame_start, frame_end, frame_step, ext
     ):
-        """Generate the expected files for the render product.
-        This returns a list of files that should be rendered. It replaces
-        the sequence of `#` with the frame number.
+        """
+        Generate the expected files for the render product for the beauty
+        render. This returns a list of files that should be rendered. It
+        replaces the sequence of `#` with the frame number.
         """
         path = os.path.dirname(render_product)
         file = os.path.basename(render_product)
@@ -87,9 +85,39 @@ class CollectBlenderRender(pyblish.api.InstancePlugin):
 
         for frame in range(frame_start, frame_end + 1, frame_step):
             frame_str = str(frame).rjust(4, "0")
-            expected_file = os.path.join(path, re.sub("#+", frame_str, file))
+            filename = re.sub("#+", frame_str, file)
+            expected_file = f"{os.path.join(path, filename)}.{ext}"
             expected_files.append(expected_file.replace("\\", "/"))
 
+        return {
+            "beauty": expected_files
+        }
+
+    @staticmethod
+    def generate_expected_aovs(
+        aov_file_product, frame_start, frame_end, frame_step, ext
+    ):
+        """
+        Generate the expected files for the render product for the beauty
+        render. This returns a list of files that should be rendered. It
+        replaces the sequence of `#` with the frame number.
+        """
+        expected_files = {}
+
+        for aov_name, aov_file in aov_file_product:
+            path = os.path.dirname(aov_file)
+            file = os.path.basename(aov_file)
+
+            aov_files = []
+
+            for frame in range(frame_start, frame_end + 1, frame_step):
+                frame_str = str(frame).rjust(4, "0")
+                filename = re.sub("#+", frame_str, file)
+                expected_file = f"{os.path.join(path, filename)}.{ext}"
+                aov_files.append(expected_file.replace("\\", "/"))
+
+            expected_files[aov_name] = aov_files
+
         return expected_files
 
     @staticmethod
@@ -117,7 +145,7 @@ class CollectBlenderRender(pyblish.api.InstancePlugin):
         elif ext == "tif":
             image_settings.file_format = "TIFF"
 
-    def _create_context():
+    def _create_context(self):
         context = bpy.context.copy()
 
         win = bpy.context.window_manager.windows[0]
@@ -132,7 +160,7 @@ class CollectBlenderRender(pyblish.api.InstancePlugin):
 
         return context
 
-    def _set_node_tree(self, output_path, instance):
+    def set_node_tree(self, output_path, instance):
         # Set the scene to use the compositor node tree to render
         bpy.context.scene.use_nodes = True
 
@@ -153,8 +181,9 @@ class CollectBlenderRender(pyblish.api.InstancePlugin):
         # render.
         # We also exclude some layers.
         exclude_sockets = ["Image", "Alpha"]
-        passes = [
-            socket for socket in rl_node.outputs
+        passes =  [
+            socket
+            for socket in rl_node.outputs
             if socket.enabled and socket.name not in exclude_sockets
         ]
 
@@ -182,11 +211,16 @@ class CollectBlenderRender(pyblish.api.InstancePlugin):
         image_settings = bpy.context.scene.render.image_settings
         output.format.file_format = image_settings.file_format
 
+        aov_file_products = []
+
         # For each active render pass, we add a new socket to the output node
         # and link it
         for render_pass in passes:
-            bpy.ops.node.output_file_add_socket(
-                context, file_path=f"{instance.name}_{render_pass.name}.####")
+            filepath = f"{instance.name}_{render_pass.name}.####"
+            bpy.ops.node.output_file_add_socket(context, file_path=filepath)
+
+            aov_file_products.append(
+                (render_pass.name, os.path.join(output_path, filepath)))
 
             node_input = output.inputs[-1]
 
@@ -195,10 +229,7 @@ class CollectBlenderRender(pyblish.api.InstancePlugin):
         # Restore the area type
         area.ui_type = old_area_type
 
-    def set_node_tree(self, output_path, instance):
-        """ Run the creator on Blender main thread"""
-        mti = MainThreadItem(self._set_node_tree, output_path, instance)
-        execute_in_main_thread(mti)
+        return aov_file_products
 
     @staticmethod
     def set_render_camera(instance):
@@ -230,7 +261,7 @@ class CollectBlenderRender(pyblish.api.InstancePlugin):
         output_path = os.path.join(file_path, render_folder, file_name)
 
         render_product = self.get_render_product(output_path, instance)
-        self.set_node_tree(output_path, instance)
+        aov_file_product = self.set_node_tree(output_path, instance)
 
         # We set the render path, the format and the camera
         bpy.context.scene.render.filepath = render_product
@@ -245,9 +276,15 @@ class CollectBlenderRender(pyblish.api.InstancePlugin):
         frame_handle_start = context.data["frameStartHandle"]
         frame_handle_end = context.data["frameEndHandle"]
 
-        expected_files = self.generate_expected_files(
+        expected_beauty = self.generate_expected_beauty(
             render_product, int(frame_start), int(frame_end),
-            int(bpy.context.scene.frame_step))
+            int(bpy.context.scene.frame_step), ext)
+
+        expected_aovs = self.generate_expected_aovs(
+            aov_file_product, int(frame_start), int(frame_end),
+            int(bpy.context.scene.frame_step), ext)
+
+        expected_files = expected_beauty | expected_aovs
 
         instance.data.update({
             "frameStart": frame_start,
@@ -257,7 +294,14 @@ class CollectBlenderRender(pyblish.api.InstancePlugin):
             "fps": context.data["fps"],
             "byFrameStep": bpy.context.scene.frame_step,
             "farm": True,
-            "expectedFiles": expected_files,
+            "expectedFiles": [expected_files],
+            # OCIO not currently implemented in Blender, but the following
+            # settings are required by the schema, so it is hardcoded.
+            # TODO: Implement OCIO in Blender
+            "colorspaceConfig": "",
+            "colorspaceDisplay": "sRGB",
+            "colorspaceView": "ACES 1.0 SDR-video",
+            "renderProducts": colorspace.ARenderProduct(),
         })
 
         self.log.info(f"data: {instance.data}")
diff --git a/openpype/modules/deadline/plugins/publish/submit_blender_deadline.py b/openpype/modules/deadline/plugins/publish/submit_blender_deadline.py
index 9bfc4fbb07..ad456c0d13 100644
--- a/openpype/modules/deadline/plugins/publish/submit_blender_deadline.py
+++ b/openpype/modules/deadline/plugins/publish/submit_blender_deadline.py
@@ -163,7 +163,8 @@ class BlenderSubmitDeadline(abstract_submit_deadline.AbstractSubmitDeadline):
         if not expected_files:
             raise RuntimeError("No Render Elements found!")
 
-        output_dir = os.path.dirname(expected_files[0])
+        first_file = next(iter_expected_files(expected_files))
+        output_dir = os.path.dirname(first_file)
         instance.data["outputDir"] = output_dir
         instance.data["toBeRenderedOn"] = "deadline"
 

From c9f5a9743257b8ce242660da473d69cb8dba8b52 Mon Sep 17 00:00:00 2001
From: Simone Barbieri <simone.barbieri@hey.com>
Date: Tue, 22 Aug 2023 16:33:51 +0100
Subject: [PATCH 081/366] Added setting for aov separator

---
 .../blender/plugins/publish/collect_render.py | 26 ++++++++++++++++---
 .../defaults/project_settings/blender.json    |  1 +
 .../schema_project_blender.json               | 12 +++++++++
 3 files changed, 35 insertions(+), 4 deletions(-)

diff --git a/openpype/hosts/blender/plugins/publish/collect_render.py b/openpype/hosts/blender/plugins/publish/collect_render.py
index becb735c21..b16354460a 100644
--- a/openpype/hosts/blender/plugins/publish/collect_render.py
+++ b/openpype/hosts/blender/plugins/publish/collect_render.py
@@ -33,6 +33,23 @@ class CollectBlenderRender(pyblish.api.InstancePlugin):
                         ["RenderSettings"]
                         ["default_render_image_folder"])
 
+    @staticmethod
+    def get_aov_separator(settings):
+        """Get aov separator from blender settings."""
+
+        aov_sep = (settings["blender"]
+                           ["RenderSettings"]
+                           ["aov_separator"])
+
+        if aov_sep == "dash":
+            return "-"
+        elif aov_sep == "underscore":
+            return "_"
+        elif aov_sep == "dot":
+            return "."
+        else:
+            raise ValueError(f"Invalid aov separator: {aov_sep}")
+
     @staticmethod
     def get_image_format(settings):
         """Get image format from blender settings."""
@@ -160,7 +177,7 @@ class CollectBlenderRender(pyblish.api.InstancePlugin):
 
         return context
 
-    def set_node_tree(self, output_path, instance):
+    def set_node_tree(self, output_path, instance, aov_sep):
         # Set the scene to use the compositor node tree to render
         bpy.context.scene.use_nodes = True
 
@@ -181,7 +198,7 @@ class CollectBlenderRender(pyblish.api.InstancePlugin):
         # render.
         # We also exclude some layers.
         exclude_sockets = ["Image", "Alpha"]
-        passes =  [
+        passes = [
             socket
             for socket in rl_node.outputs
             if socket.enabled and socket.name not in exclude_sockets
@@ -216,7 +233,7 @@ class CollectBlenderRender(pyblish.api.InstancePlugin):
         # For each active render pass, we add a new socket to the output node
         # and link it
         for render_pass in passes:
-            filepath = f"{instance.name}_{render_pass.name}.####"
+            filepath = f"{instance.name}{aov_sep}{render_pass.name}.####"
             bpy.ops.node.output_file_add_socket(context, file_path=filepath)
 
             aov_file_products.append(
@@ -255,13 +272,14 @@ class CollectBlenderRender(pyblish.api.InstancePlugin):
         settings = get_project_settings(project)
 
         render_folder = self.get_default_render_folder(settings)
+        aov_sep = self.get_aov_separator(settings)
         ext = self.get_image_format(settings)
         multilayer = self.get_multilayer(settings)
 
         output_path = os.path.join(file_path, render_folder, file_name)
 
         render_product = self.get_render_product(output_path, instance)
-        aov_file_product = self.set_node_tree(output_path, instance)
+        aov_file_product = self.set_node_tree(output_path, instance, aov_sep)
 
         # We set the render path, the format and the camera
         bpy.context.scene.render.filepath = render_product
diff --git a/openpype/settings/defaults/project_settings/blender.json b/openpype/settings/defaults/project_settings/blender.json
index c375e550c2..17387f4db6 100644
--- a/openpype/settings/defaults/project_settings/blender.json
+++ b/openpype/settings/defaults/project_settings/blender.json
@@ -19,6 +19,7 @@
     },
     "RenderSettings": {
         "default_render_image_folder": "renders/blender",
+        "aov_separator": "underscore",
         "image_format": "exr",
         "multilayer_exr": true
     },
diff --git a/openpype/settings/entities/schemas/projects_schema/schema_project_blender.json b/openpype/settings/entities/schemas/projects_schema/schema_project_blender.json
index d8ef1eee3e..ecad74b621 100644
--- a/openpype/settings/entities/schemas/projects_schema/schema_project_blender.json
+++ b/openpype/settings/entities/schemas/projects_schema/schema_project_blender.json
@@ -65,6 +65,18 @@
                     "key": "default_render_image_folder",
                     "label": "Default render image folder"
                 },
+                {
+                    "key": "aov_separator",
+                    "label": "AOV Separator Character",
+                    "type": "enum",
+                    "multiselection": false,
+                    "defaults": "underscore",
+                    "enum_items": [
+                        {"dash": "- (dash)"},
+                        {"underscore": "_ (underscore)"},
+                        {"dot": ". (dot)"}
+                    ]
+                },
                 {
                     "key": "image_format",
                     "label": "Output Image Format",

From 5f901f2a62d781d6f29dd145fe69bbc26da24651 Mon Sep 17 00:00:00 2001
From: Simone Barbieri <simone.barbieri@hey.com>
Date: Tue, 22 Aug 2023 17:38:33 +0100
Subject: [PATCH 082/366] Added setting to set AOVs

---
 .../blender/plugins/publish/collect_render.py | 25 +++++++++++++++++++
 .../defaults/project_settings/blender.json    |  3 ++-
 .../schema_project_blender.json               | 23 +++++++++++++++++
 3 files changed, 50 insertions(+), 1 deletion(-)

diff --git a/openpype/hosts/blender/plugins/publish/collect_render.py b/openpype/hosts/blender/plugins/publish/collect_render.py
index b16354460a..309d40d9fd 100644
--- a/openpype/hosts/blender/plugins/publish/collect_render.py
+++ b/openpype/hosts/blender/plugins/publish/collect_render.py
@@ -162,6 +162,29 @@ class CollectBlenderRender(pyblish.api.InstancePlugin):
         elif ext == "tif":
             image_settings.file_format = "TIFF"
 
+    @staticmethod
+    def set_render_passes(settings):
+        aov_list = (settings["blender"]
+                            ["RenderSettings"]
+                            ["aov_list"])
+
+        scene = bpy.context.scene
+        vl = bpy.context.view_layer
+
+        vl.use_pass_combined = "combined" in aov_list
+        vl.use_pass_z = "z" in aov_list
+        vl.use_pass_mist = "mist" in aov_list
+        vl.use_pass_normal = "normal" in aov_list
+        vl.use_pass_diffuse_direct = "diffuse_light" in aov_list
+        vl.use_pass_diffuse_color = "diffuse_color" in aov_list
+        vl.use_pass_glossy_direct = "specular_light" in aov_list
+        vl.use_pass_glossy_color = "specular_color" in aov_list
+        vl.eevee.use_pass_volume_direct = "volume_light" in aov_list
+        vl.use_pass_emit = "emission" in aov_list
+        vl.use_pass_environment = "environment" in aov_list
+        vl.use_pass_shadow = "shadow" in aov_list
+        vl.use_pass_ambient_occlusion = "ao" in aov_list
+
     def _create_context(self):
         context = bpy.context.copy()
 
@@ -276,6 +299,8 @@ class CollectBlenderRender(pyblish.api.InstancePlugin):
         ext = self.get_image_format(settings)
         multilayer = self.get_multilayer(settings)
 
+        self.set_render_passes(settings)
+
         output_path = os.path.join(file_path, render_folder, file_name)
 
         render_product = self.get_render_product(output_path, instance)
diff --git a/openpype/settings/defaults/project_settings/blender.json b/openpype/settings/defaults/project_settings/blender.json
index 17387f4db6..d36fc503dd 100644
--- a/openpype/settings/defaults/project_settings/blender.json
+++ b/openpype/settings/defaults/project_settings/blender.json
@@ -21,7 +21,8 @@
         "default_render_image_folder": "renders/blender",
         "aov_separator": "underscore",
         "image_format": "exr",
-        "multilayer_exr": true
+        "multilayer_exr": true,
+        "aov_list": []
     },
     "workfile_builder": {
         "create_first_version": false,
diff --git a/openpype/settings/entities/schemas/projects_schema/schema_project_blender.json b/openpype/settings/entities/schemas/projects_schema/schema_project_blender.json
index ecad74b621..b7d61d1d69 100644
--- a/openpype/settings/entities/schemas/projects_schema/schema_project_blender.json
+++ b/openpype/settings/entities/schemas/projects_schema/schema_project_blender.json
@@ -98,6 +98,29 @@
                     "key": "multilayer_exr",
                     "type": "boolean",
                     "label": "Multilayer (EXR)"
+                },
+                {
+                    "key": "aov_list",
+                    "label": "AOVs to create",
+                    "type": "enum",
+                    "multiselection": true,
+                    "defaults": "empty",
+                    "enum_items": [
+                        {"empty": "< empty >"},
+                        {"combined": "Combined"},
+                        {"z": "Z"},
+                        {"mist": "Mist"},
+                        {"normal": "Normal"},
+                        {"diffuse_light": "Diffuse Light"},
+                        {"diffuse_color": "Diffuse Color"},
+                        {"specular_light": "Specular Light"},
+                        {"specular_color": "Specular Color"},
+                        {"volume_light": "Volume Light"},
+                        {"emission": "Emission"},
+                        {"environment": "Environment"},
+                        {"shadow": "Shadow"},
+                        {"ao": "Ambient Occlusion"}
+                    ]
                 }
             ]
         },

From 77d18d0b060d009a80102f00a3f76b31f488bd03 Mon Sep 17 00:00:00 2001
From: Mustafa-Zarkash <mustafataherzaky@outlook.com>
Date: Tue, 22 Aug 2023 23:20:33 +0300
Subject: [PATCH 083/366] make hound happy

---
 .../houdini/plugins/create/create_fbx.py      | 32 +++++++++----------
 .../hosts/houdini/plugins/load/load_fbx.py    | 10 +++---
 .../plugins/publish/collect_fbx_type.py       |  1 -
 .../publish/validate_fbx_hierarchy_path.py    |  1 +
 4 files changed, 22 insertions(+), 22 deletions(-)

diff --git a/openpype/hosts/houdini/plugins/create/create_fbx.py b/openpype/hosts/houdini/plugins/create/create_fbx.py
index 2bfdb3e729..1ff63ab2c4 100644
--- a/openpype/hosts/houdini/plugins/create/create_fbx.py
+++ b/openpype/hosts/houdini/plugins/create/create_fbx.py
@@ -69,19 +69,19 @@ class CreateFilmboxFBX(plugin.HoudiniCreator):
     def get_pre_create_attr_defs(self):
         attrs = super().get_pre_create_attr_defs()
         vcformat = EnumDef("vcformat",
-                            items={
-                                0: "Maya Compatible (MC)",
-                                1: "3DS MAX Compatible (PC2)"
-                            },
-                            default=0,
-                            label="Vertex Cache Format")
+                           items={
+                               0: "Maya Compatible (MC)",
+                               1: "3DS MAX Compatible (PC2)"
+                               },
+                               default=0,
+                               label="Vertex Cache Format")
         trange = EnumDef("trange",
-                            items={
-                                0: "Render Current Frame",
-                                1: "Render Frame Range"
-                            },
-                            default=0,
-                            label="Valid Frame Range")
+                         items={
+                             0: "Render Current Frame",
+                             1: "Render Frame Range"
+                             },
+                             default=0,
+                             label="Valid Frame Range")
 
         return attrs + [vcformat, trange]
 
@@ -103,10 +103,10 @@ class CreateFilmboxFBX(plugin.HoudiniCreator):
 
         # parms dictionary
         parms = {
-            "startnode" : selection,
+            "startnode": selection,
             "sopoutput": output_path,
-            "vcformat" : vcformat,
-            "trange" : trange
+            "vcformat": vcformat,
+            "trange": trange
         }
 
         return parms
@@ -139,7 +139,7 @@ class CreateFilmboxFBX(plugin.HoudiniCreator):
                 )
 
             # Allow object level paths to Geometry nodes (e.g. /obj/geo1)
-            # but do not allow other object level nodes types like cameras, etc.
+            # but do not allow other object level nodes types like cameras.
             elif isinstance(selected_node, hou.ObjNode) and \
                     selected_node.type().name() in ["geo"]:
 
diff --git a/openpype/hosts/houdini/plugins/load/load_fbx.py b/openpype/hosts/houdini/plugins/load/load_fbx.py
index 5294f5248d..34f75e1485 100644
--- a/openpype/hosts/houdini/plugins/load/load_fbx.py
+++ b/openpype/hosts/houdini/plugins/load/load_fbx.py
@@ -126,19 +126,19 @@ class FbxLoader(load.LoaderPlugin):
             file_node.destroy()
 
         # Create a new file node
-        file_node = parent_node.createNode("file", node_name= node_name)
-        file_node.setParms({"file":file_path})
+        file_node = parent_node.createNode("file", node_name=node_name)
+        file_node.setParms({"file": file_path})
 
         # Create attribute delete
         attribdelete_name = "attribdelete_{}".format(subset_name)
         attribdelete = parent_node.createNode("attribdelete",
-                                              node_name= attribdelete_name)
-        attribdelete.setParms({"ptdel":"fbx_*"})
+                                              node_name=attribdelete_name)
+        attribdelete.setParms({"ptdel": "fbx_*"})
         attribdelete.setInput(0, file_node)
 
         # Create a Null node
         null_name = "OUT_{}".format(subset_name)
-        null = parent_node.createNode("null", node_name= null_name)
+        null = parent_node.createNode("null", node_name=null_name)
         null.setInput(0, attribdelete)
 
         # Ensure display flag is on the file_node input node and not on the OUT
diff --git a/openpype/hosts/houdini/plugins/publish/collect_fbx_type.py b/openpype/hosts/houdini/plugins/publish/collect_fbx_type.py
index 794d8bd6e7..3ee2541f72 100644
--- a/openpype/hosts/houdini/plugins/publish/collect_fbx_type.py
+++ b/openpype/hosts/houdini/plugins/publish/collect_fbx_type.py
@@ -42,7 +42,6 @@ class CollectFilmboxfbxType(pyblish.api.InstancePlugin):
         #   to Update instance.data with ouptut_node of different types
         #   however, this collector is used for demonstration
 
-
     def get_output_node(self, instance):
         """Getting output_node Logic."""
 
diff --git a/openpype/hosts/houdini/plugins/publish/validate_fbx_hierarchy_path.py b/openpype/hosts/houdini/plugins/publish/validate_fbx_hierarchy_path.py
index e98e562fe8..9208a16bd1 100644
--- a/openpype/hosts/houdini/plugins/publish/validate_fbx_hierarchy_path.py
+++ b/openpype/hosts/houdini/plugins/publish/validate_fbx_hierarchy_path.py
@@ -29,6 +29,7 @@ from openpype.hosts.houdini.api.action import (
 
 import hou
 
+
 # Each validation can have a single repair action
 # which calls the repair method
 class AddDefaultPathAction(RepairAction):

From 0fe908a7cc4e2130e36f52820f9064ba48621d59 Mon Sep 17 00:00:00 2001
From: Mustafa-Zarkash <mustafataherzaky@outlook.com>
Date: Tue, 22 Aug 2023 23:23:56 +0300
Subject: [PATCH 084/366] make hound happy again

---
 openpype/hosts/houdini/plugins/create/create_fbx.py | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/openpype/hosts/houdini/plugins/create/create_fbx.py b/openpype/hosts/houdini/plugins/create/create_fbx.py
index 1ff63ab2c4..a92a4a5a24 100644
--- a/openpype/hosts/houdini/plugins/create/create_fbx.py
+++ b/openpype/hosts/houdini/plugins/create/create_fbx.py
@@ -70,11 +70,11 @@ class CreateFilmboxFBX(plugin.HoudiniCreator):
         attrs = super().get_pre_create_attr_defs()
         vcformat = EnumDef("vcformat",
                            items={
-                               0: "Maya Compatible (MC)",
-                               1: "3DS MAX Compatible (PC2)"
-                               },
-                               default=0,
-                               label="Vertex Cache Format")
+                                 0: "Maya Compatible (MC)",
+                                 1: "3DS MAX Compatible (PC2)"
+                                 },
+                           default=0,
+                           label="Vertex Cache Format")
         trange = EnumDef("trange",
                          items={
                              0: "Render Current Frame",

From 4bfde17a420cc3686734d049728e7eaf66b51538 Mon Sep 17 00:00:00 2001
From: Mustafa-Zarkash <mustafataherzaky@outlook.com>
Date: Tue, 22 Aug 2023 23:26:21 +0300
Subject: [PATCH 085/366] make hound happy

---
 openpype/hosts/houdini/plugins/create/create_fbx.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/openpype/hosts/houdini/plugins/create/create_fbx.py b/openpype/hosts/houdini/plugins/create/create_fbx.py
index a92a4a5a24..e26fd660ba 100644
--- a/openpype/hosts/houdini/plugins/create/create_fbx.py
+++ b/openpype/hosts/houdini/plugins/create/create_fbx.py
@@ -70,8 +70,8 @@ class CreateFilmboxFBX(plugin.HoudiniCreator):
         attrs = super().get_pre_create_attr_defs()
         vcformat = EnumDef("vcformat",
                            items={
-                                 0: "Maya Compatible (MC)",
-                                 1: "3DS MAX Compatible (PC2)"
+                               0: "Maya Compatible (MC)",
+                               1: "3DS MAX Compatible (PC2)"
                                  },
                            default=0,
                            label="Vertex Cache Format")

From 433160e75ae70c2a17d5460c6815588bb17c58b0 Mon Sep 17 00:00:00 2001
From: Mustafa-Zarkash <mustafataherzaky@outlook.com>
Date: Tue, 22 Aug 2023 23:29:02 +0300
Subject: [PATCH 086/366] make hound happy again

---
 openpype/hosts/houdini/plugins/create/create_fbx.py | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/openpype/hosts/houdini/plugins/create/create_fbx.py b/openpype/hosts/houdini/plugins/create/create_fbx.py
index e26fd660ba..ed95daafca 100644
--- a/openpype/hosts/houdini/plugins/create/create_fbx.py
+++ b/openpype/hosts/houdini/plugins/create/create_fbx.py
@@ -72,16 +72,16 @@ class CreateFilmboxFBX(plugin.HoudiniCreator):
                            items={
                                0: "Maya Compatible (MC)",
                                1: "3DS MAX Compatible (PC2)"
-                                 },
+                            },
                            default=0,
                            label="Vertex Cache Format")
         trange = EnumDef("trange",
                          items={
                              0: "Render Current Frame",
                              1: "Render Frame Range"
-                             },
-                             default=0,
-                             label="Valid Frame Range")
+                         },
+                         default=0,
+                         label="Valid Frame Range")
 
         return attrs + [vcformat, trange]
 

From 58408817999f053118a5c14cff8058c909a512cf Mon Sep 17 00:00:00 2001
From: Mustafa-Zarkash <mustafataherzaky@outlook.com>
Date: Tue, 22 Aug 2023 23:30:00 +0300
Subject: [PATCH 087/366] make hound happy

---
 openpype/hosts/houdini/plugins/create/create_fbx.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/hosts/houdini/plugins/create/create_fbx.py b/openpype/hosts/houdini/plugins/create/create_fbx.py
index ed95daafca..cac90f1e87 100644
--- a/openpype/hosts/houdini/plugins/create/create_fbx.py
+++ b/openpype/hosts/houdini/plugins/create/create_fbx.py
@@ -72,7 +72,7 @@ class CreateFilmboxFBX(plugin.HoudiniCreator):
                            items={
                                0: "Maya Compatible (MC)",
                                1: "3DS MAX Compatible (PC2)"
-                            },
+                           },
                            default=0,
                            label="Vertex Cache Format")
         trange = EnumDef("trange",

From fc1a98b47173d34843b0e2b59ca6e492763700d0 Mon Sep 17 00:00:00 2001
From: Simone Barbieri <simone.barbieri@hey.com>
Date: Wed, 23 Aug 2023 09:32:32 +0100
Subject: [PATCH 088/366] Added support for custom render passes

---
 .../blender/plugins/publish/collect_render.py | 15 ++++++++++-
 .../defaults/project_settings/blender.json    |  3 ++-
 .../schema_project_blender.json               | 27 +++++++++++++++++++
 3 files changed, 43 insertions(+), 2 deletions(-)

diff --git a/openpype/hosts/blender/plugins/publish/collect_render.py b/openpype/hosts/blender/plugins/publish/collect_render.py
index 309d40d9fd..7c95bb14cf 100644
--- a/openpype/hosts/blender/plugins/publish/collect_render.py
+++ b/openpype/hosts/blender/plugins/publish/collect_render.py
@@ -168,7 +168,10 @@ class CollectBlenderRender(pyblish.api.InstancePlugin):
                             ["RenderSettings"]
                             ["aov_list"])
 
-        scene = bpy.context.scene
+        custom_passes = (settings["blender"]
+                                 ["RenderSettings"]
+                                 ["custom_passes"])
+
         vl = bpy.context.view_layer
 
         vl.use_pass_combined = "combined" in aov_list
@@ -185,6 +188,16 @@ class CollectBlenderRender(pyblish.api.InstancePlugin):
         vl.use_pass_shadow = "shadow" in aov_list
         vl.use_pass_ambient_occlusion = "ao" in aov_list
 
+        aovs_names = [aov.name for aov in vl.aovs]
+        for cp in custom_passes:
+            cp_name = cp[0]
+            if cp_name not in aovs_names:
+                aov = vl.aovs.add()
+                aov.name = cp_name
+            else:
+                aov = vl.aovs[cp_name]
+            aov.type = cp[1].get("type", "VALUE")
+
     def _create_context(self):
         context = bpy.context.copy()
 
diff --git a/openpype/settings/defaults/project_settings/blender.json b/openpype/settings/defaults/project_settings/blender.json
index d36fc503dd..8b1d602df0 100644
--- a/openpype/settings/defaults/project_settings/blender.json
+++ b/openpype/settings/defaults/project_settings/blender.json
@@ -22,7 +22,8 @@
         "aov_separator": "underscore",
         "image_format": "exr",
         "multilayer_exr": true,
-        "aov_list": []
+        "aov_list": [],
+        "custom_passes": []
     },
     "workfile_builder": {
         "create_first_version": false,
diff --git a/openpype/settings/entities/schemas/projects_schema/schema_project_blender.json b/openpype/settings/entities/schemas/projects_schema/schema_project_blender.json
index b7d61d1d69..8db57f49eb 100644
--- a/openpype/settings/entities/schemas/projects_schema/schema_project_blender.json
+++ b/openpype/settings/entities/schemas/projects_schema/schema_project_blender.json
@@ -121,6 +121,33 @@
                         {"shadow": "Shadow"},
                         {"ao": "Ambient Occlusion"}
                     ]
+                },
+                {
+                    "type": "label",
+                    "label": "Add custom AOVs. They are added to the view layer and in the Compositing Nodetree,\nbut they need to be added manually to the Shader Nodetree."
+                },
+                {
+                    "type": "dict-modifiable",
+                    "store_as_list": true,
+                    "key": "custom_passes",
+                    "label": "Custom Passes",
+                    "use_label_wrap": true,
+                    "object_type": {
+                        "type": "dict",
+                        "children": [
+                            {
+                                "key": "type",
+                                "label": "Type",
+                                "type": "enum",
+                                "multiselection": false,
+                                "defaults": "color",
+                                "enum_items": [
+                                    {"COLOR": "Color"},
+                                    {"VALUE": "Value"}
+                                ]
+                            }
+                        ]
+                    }
                 }
             ]
         },

From 8f78ebeabdb1e6e7fdf0ab461d8b609669266c29 Mon Sep 17 00:00:00 2001
From: Simone Barbieri <simone.barbieri@hey.com>
Date: Wed, 23 Aug 2023 10:51:01 +0100
Subject: [PATCH 089/366] Fixed problem with blender context and multilayer exr

---
 .../blender/plugins/publish/collect_render.py | 47 +++++--------------
 1 file changed, 13 insertions(+), 34 deletions(-)

diff --git a/openpype/hosts/blender/plugins/publish/collect_render.py b/openpype/hosts/blender/plugins/publish/collect_render.py
index 7c95bb14cf..2622c51432 100644
--- a/openpype/hosts/blender/plugins/publish/collect_render.py
+++ b/openpype/hosts/blender/plugins/publish/collect_render.py
@@ -198,22 +198,7 @@ class CollectBlenderRender(pyblish.api.InstancePlugin):
                 aov = vl.aovs[cp_name]
             aov.type = cp[1].get("type", "VALUE")
 
-    def _create_context(self):
-        context = bpy.context.copy()
-
-        win = bpy.context.window_manager.windows[0]
-        screen = win.screen
-        area = screen.areas[0]
-        region = area.regions[0]
-
-        context["window"] = win
-        context['screen'] = screen
-        context['area'] = area
-        context['region'] = region
-
-        return context
-
-    def set_node_tree(self, output_path, instance, aov_sep):
+    def set_node_tree(self, output_path, instance, aov_sep, ext, multilayer):
         # Set the scene to use the compositor node tree to render
         bpy.context.scene.use_nodes = True
 
@@ -248,17 +233,10 @@ class CollectBlenderRender(pyblish.api.InstancePlugin):
         # Create a new output node
         output = tree.nodes.new("CompositorNodeOutputFile")
 
-        context = self._create_context()
-        context["node"] = output
-
-        area = context["area"]
-
-        # Change area type to node editor, to execute node operators
-        old_area_type = area.ui_type
-        area.ui_type = "CompositorNodeTree"
-
-        # Remove the default input socket from the output node
-        bpy.ops.node.output_file_remove_active_socket(context)
+        if ext == "exr" and multilayer:
+            output.layer_slots.clear()
+        else:
+            output.file_slots.clear()
 
         output.base_path = output_path
         image_settings = bpy.context.scene.render.image_settings
@@ -270,18 +248,18 @@ class CollectBlenderRender(pyblish.api.InstancePlugin):
         # and link it
         for render_pass in passes:
             filepath = f"{instance.name}{aov_sep}{render_pass.name}.####"
-            bpy.ops.node.output_file_add_socket(context, file_path=filepath)
+            if ext == "exr" and multilayer:
+                output.layer_slots.new(render_pass.name)
+            else:
+                output.file_slots.new(filepath)
 
-            aov_file_products.append(
-                (render_pass.name, os.path.join(output_path, filepath)))
+                aov_file_products.append(
+                    (render_pass.name, os.path.join(output_path, filepath)))
 
             node_input = output.inputs[-1]
 
             tree.links.new(render_pass, node_input)
 
-        # Restore the area type
-        area.ui_type = old_area_type
-
         return aov_file_products
 
     @staticmethod
@@ -317,7 +295,8 @@ class CollectBlenderRender(pyblish.api.InstancePlugin):
         output_path = os.path.join(file_path, render_folder, file_name)
 
         render_product = self.get_render_product(output_path, instance)
-        aov_file_product = self.set_node_tree(output_path, instance, aov_sep)
+        aov_file_product = self.set_node_tree(
+            output_path, instance, aov_sep, ext, multilayer)
 
         # We set the render path, the format and the camera
         bpy.context.scene.render.filepath = render_product

From c529abb8ab383ff50e92b8b0284ff2efa2fbff63 Mon Sep 17 00:00:00 2001
From: Simone Barbieri <simone.barbieri@hey.com>
Date: Wed, 23 Aug 2023 15:39:31 +0100
Subject: [PATCH 090/366] Moved most of the logic in the creator

---
 .../blender/plugins/create/create_render.py   | 267 +++++++++++++++++-
 .../blender/plugins/publish/collect_render.py | 235 +--------------
 2 files changed, 266 insertions(+), 236 deletions(-)

diff --git a/openpype/hosts/blender/plugins/create/create_render.py b/openpype/hosts/blender/plugins/create/create_render.py
index 8323b88cfe..49d356ab67 100644
--- a/openpype/hosts/blender/plugins/create/create_render.py
+++ b/openpype/hosts/blender/plugins/create/create_render.py
@@ -1,9 +1,18 @@
 """Create render."""
+import os
+import re
 
 import bpy
 
+from openpype.pipeline import (
+    get_current_context,
+    get_current_project_name,
+)
+from openpype.settings import (
+    get_project_settings,
+)
 from openpype.pipeline import get_current_task_name
-from openpype.hosts.blender.api import plugin, lib, ops
+from openpype.hosts.blender.api import plugin, lib
 from openpype.hosts.blender.api.pipeline import AVALON_INSTANCES
 
 
@@ -15,14 +24,217 @@ class CreateRenderlayer(plugin.Creator):
     family = "renderlayer"
     icon = "eye"
 
-    render_settings = {}
+    @staticmethod
+    def get_default_render_folder(settings):
+        """Get default render folder from blender settings."""
+
+        return (settings["blender"]
+                        ["RenderSettings"]
+                        ["default_render_image_folder"])
+
+    @staticmethod
+    def get_aov_separator(settings):
+        """Get aov separator from blender settings."""
+
+        aov_sep = (settings["blender"]
+                           ["RenderSettings"]
+                           ["aov_separator"])
+
+        if aov_sep == "dash":
+            return "-"
+        elif aov_sep == "underscore":
+            return "_"
+        elif aov_sep == "dot":
+            return "."
+        else:
+            raise ValueError(f"Invalid aov separator: {aov_sep}")
+
+    @staticmethod
+    def get_image_format(settings):
+        """Get image format from blender settings."""
+
+        return (settings["blender"]
+                        ["RenderSettings"]
+                        ["image_format"])
+
+    @staticmethod
+    def get_multilayer(settings):
+        """Get multilayer from blender settings."""
+
+        return (settings["blender"]
+                        ["RenderSettings"]
+                        ["multilayer_exr"])
+
+    @staticmethod
+    def get_render_product(output_path, name):
+        """
+        Generate the path to the render product. Blender interprets the `#`
+        as the frame number, when it renders.
+
+        Args:
+            file_path (str): The path to the blender scene.
+            render_folder (str): The render folder set in settings.
+            file_name (str): The name of the blender scene.
+            instance (pyblish.api.Instance): The instance to publish.
+            ext (str): The image format to render.
+        """
+        output_file = os.path.join(output_path, name)
+
+        render_product = f"{output_file}.####"
+        render_product = render_product.replace("\\", "/")
+
+        return render_product
+
+    @staticmethod
+    def set_render_format(ext, multilayer):
+        # Set Blender to save the file with the right extension
+        bpy.context.scene.render.use_file_extension = True
+
+        image_settings = bpy.context.scene.render.image_settings
+
+        if ext == "exr":
+            image_settings.file_format = (
+                "OPEN_EXR_MULTILAYER" if multilayer else "OPEN_EXR")
+        elif ext == "bmp":
+            image_settings.file_format = "BMP"
+        elif ext == "rgb":
+            image_settings.file_format = "IRIS"
+        elif ext == "png":
+            image_settings.file_format = "PNG"
+        elif ext == "jpeg":
+            image_settings.file_format = "JPEG"
+        elif ext == "jp2":
+            image_settings.file_format = "JPEG2000"
+        elif ext == "tga":
+            image_settings.file_format = "TARGA"
+        elif ext == "tif":
+            image_settings.file_format = "TIFF"
+
+    @staticmethod
+    def set_render_passes(settings):
+        aov_list = (settings["blender"]
+                            ["RenderSettings"]
+                            ["aov_list"])
+
+        custom_passes = (settings["blender"]
+                                 ["RenderSettings"]
+                                 ["custom_passes"])
+
+        vl = bpy.context.view_layer
+
+        vl.use_pass_combined = "combined" in aov_list
+        vl.use_pass_z = "z" in aov_list
+        vl.use_pass_mist = "mist" in aov_list
+        vl.use_pass_normal = "normal" in aov_list
+        vl.use_pass_diffuse_direct = "diffuse_light" in aov_list
+        vl.use_pass_diffuse_color = "diffuse_color" in aov_list
+        vl.use_pass_glossy_direct = "specular_light" in aov_list
+        vl.use_pass_glossy_color = "specular_color" in aov_list
+        vl.eevee.use_pass_volume_direct = "volume_light" in aov_list
+        vl.use_pass_emit = "emission" in aov_list
+        vl.use_pass_environment = "environment" in aov_list
+        vl.use_pass_shadow = "shadow" in aov_list
+        vl.use_pass_ambient_occlusion = "ao" in aov_list
+
+        aovs_names = [aov.name for aov in vl.aovs]
+        for cp in custom_passes:
+            cp_name = cp[0]
+            if cp_name not in aovs_names:
+                aov = vl.aovs.add()
+                aov.name = cp_name
+            else:
+                aov = vl.aovs[cp_name]
+            aov.type = cp[1].get("type", "VALUE")
+
+        return aov_list, custom_passes
+
+    def set_node_tree(self, output_path, name, aov_sep, ext, multilayer):
+        # Set the scene to use the compositor node tree to render
+        bpy.context.scene.use_nodes = True
+
+        tree = bpy.context.scene.node_tree
+
+        # Get the Render Layers node
+        rl_node = None
+        for node in tree.nodes:
+            if node.bl_idname == "CompositorNodeRLayers":
+                rl_node = node
+                break
+
+        # If there's not a Render Layers node, we create it
+        if not rl_node:
+            rl_node = tree.nodes.new("CompositorNodeRLayers")
+
+        # Get the enabled output sockets, that are the active passes for the
+        # render.
+        # We also exclude some layers.
+        exclude_sockets = ["Image", "Alpha"]
+        passes = [
+            socket
+            for socket in rl_node.outputs
+            if socket.enabled and socket.name not in exclude_sockets
+        ]
+
+        # Remove all output nodes
+        for node in tree.nodes:
+            if node.bl_idname == "CompositorNodeOutputFile":
+                tree.nodes.remove(node)
+
+        # Create a new output node
+        output = tree.nodes.new("CompositorNodeOutputFile")
+
+        if ext == "exr" and multilayer:
+            output.layer_slots.clear()
+        else:
+            output.file_slots.clear()
+
+        output.base_path = output_path
+        image_settings = bpy.context.scene.render.image_settings
+        output.format.file_format = image_settings.file_format
+
+        aov_file_products = []
+
+        # For each active render pass, we add a new socket to the output node
+        # and link it
+        for render_pass in passes:
+            filepath = f"{name}{aov_sep}{render_pass.name}.####"
+            if ext == "exr" and multilayer:
+                output.layer_slots.new(render_pass.name)
+            else:
+                output.file_slots.new(filepath)
+
+                aov_file_products.append(
+                    (render_pass.name, os.path.join(output_path, filepath)))
+
+            node_input = output.inputs[-1]
+
+            tree.links.new(render_pass, node_input)
+
+        return aov_file_products
+
+    @staticmethod
+    def set_render_camera(asset_group):
+        # There should be only one camera in the instance
+        found = False
+        for obj in asset_group.all_objects:
+            if isinstance(obj, bpy.types.Object) and obj.type == "CAMERA":
+                bpy.context.scene.camera = obj
+                found = True
+                break
+
+        assert found, "No camera found in the render instance"
+
+    @staticmethod
+    def imprint_render_settings(node, data):
+        RENDER_DATA = "render_data"
+        if not node.get(RENDER_DATA):
+            node[RENDER_DATA] = {}
+        for key, value in data.items():
+            if value is None:
+                continue
+            node[RENDER_DATA][key] = value
 
     def process(self):
-        """ Run the creator on Blender main thread"""
-        mti = ops.MainThreadItem(self._process)
-        ops.execute_in_main_thread(mti)
-
-    def _process(self):
         # Get Instance Container or create it if it does not exist
         instances = bpy.data.collections.get(AVALON_INSTANCES)
         if not instances:
@@ -46,4 +258,45 @@ class CreateRenderlayer(plugin.Creator):
             obj = (self.options or {}).get("asset_group")
             asset_group.objects.link(obj)
 
+        filepath = bpy.data.filepath
+        assert filepath, "Workfile not saved. Please save the file first."
+
+        file_path = os.path.dirname(filepath)
+        file_name = os.path.basename(filepath)
+        file_name, _ = os.path.splitext(file_name)
+
+        project = get_current_project_name()
+        settings = get_project_settings(project)
+
+        render_folder = self.get_default_render_folder(settings)
+        aov_sep = self.get_aov_separator(settings)
+        ext = self.get_image_format(settings)
+        multilayer = self.get_multilayer(settings)
+
+        aov_list, custom_passes = self.set_render_passes(settings)
+
+        output_path = os.path.join(file_path, render_folder, file_name)
+
+        render_product = self.get_render_product(output_path, name)
+        aov_file_product = self.set_node_tree(
+            output_path, name, aov_sep, ext, multilayer)
+
+        # We set the render path, the format and the camera
+        bpy.context.scene.render.filepath = render_product
+        self.set_render_format(ext, multilayer)
+        self.set_render_camera(asset_group)
+
+        render_settings = {
+            "render_folder": render_folder,
+            "aov_separator": aov_sep,
+            "image_format": ext,
+            "multilayer_exr": multilayer,
+            "aov_list": aov_list,
+            "custom_passes": custom_passes,
+            "render_product": render_product,
+            "aov_file_product": aov_file_product,
+        }
+
+        self.imprint_render_settings(asset_group, render_settings)
+
         return asset_group
diff --git a/openpype/hosts/blender/plugins/publish/collect_render.py b/openpype/hosts/blender/plugins/publish/collect_render.py
index 2622c51432..557a4c9066 100644
--- a/openpype/hosts/blender/plugins/publish/collect_render.py
+++ b/openpype/hosts/blender/plugins/publish/collect_render.py
@@ -6,12 +6,6 @@ import re
 
 import bpy
 
-from openpype.pipeline import (
-    get_current_project_name,
-)
-from openpype.settings import (
-    get_project_settings,
-)
 from openpype.hosts.blender.api import colorspace
 import pyblish.api
 
@@ -25,67 +19,6 @@ class CollectBlenderRender(pyblish.api.InstancePlugin):
     label = "Collect Render Layers"
     sync_workfile_version = False
 
-    @staticmethod
-    def get_default_render_folder(settings):
-        """Get default render folder from blender settings."""
-
-        return (settings["blender"]
-                        ["RenderSettings"]
-                        ["default_render_image_folder"])
-
-    @staticmethod
-    def get_aov_separator(settings):
-        """Get aov separator from blender settings."""
-
-        aov_sep = (settings["blender"]
-                           ["RenderSettings"]
-                           ["aov_separator"])
-
-        if aov_sep == "dash":
-            return "-"
-        elif aov_sep == "underscore":
-            return "_"
-        elif aov_sep == "dot":
-            return "."
-        else:
-            raise ValueError(f"Invalid aov separator: {aov_sep}")
-
-    @staticmethod
-    def get_image_format(settings):
-        """Get image format from blender settings."""
-
-        return (settings["blender"]
-                        ["RenderSettings"]
-                        ["image_format"])
-
-    @staticmethod
-    def get_multilayer(settings):
-        """Get multilayer from blender settings."""
-
-        return (settings["blender"]
-                        ["RenderSettings"]
-                        ["multilayer_exr"])
-
-    @staticmethod
-    def get_render_product(output_path, instance):
-        """
-        Generate the path to the render product. Blender interprets the `#`
-        as the frame number, when it renders.
-
-        Args:
-            file_path (str): The path to the blender scene.
-            render_folder (str): The render folder set in settings.
-            file_name (str): The name of the blender scene.
-            instance (pyblish.api.Instance): The instance to publish.
-            ext (str): The image format to render.
-        """
-        output_file = os.path.join(output_path, instance.name)
-
-        render_product = f"{output_file}.####"
-        render_product = render_product.replace("\\", "/")
-
-        return render_product
-
     @staticmethod
     def generate_expected_beauty(
         render_product, frame_start, frame_end, frame_step, ext
@@ -137,174 +70,18 @@ class CollectBlenderRender(pyblish.api.InstancePlugin):
 
         return expected_files
 
-    @staticmethod
-    def set_render_format(ext, multilayer):
-        # Set Blender to save the file with the right extension
-        bpy.context.scene.render.use_file_extension = True
-
-        image_settings = bpy.context.scene.render.image_settings
-
-        if ext == "exr":
-            image_settings.file_format = (
-                "OPEN_EXR_MULTILAYER" if multilayer else "OPEN_EXR")
-        elif ext == "bmp":
-            image_settings.file_format = "BMP"
-        elif ext == "rgb":
-            image_settings.file_format = "IRIS"
-        elif ext == "png":
-            image_settings.file_format = "PNG"
-        elif ext == "jpeg":
-            image_settings.file_format = "JPEG"
-        elif ext == "jp2":
-            image_settings.file_format = "JPEG2000"
-        elif ext == "tga":
-            image_settings.file_format = "TARGA"
-        elif ext == "tif":
-            image_settings.file_format = "TIFF"
-
-    @staticmethod
-    def set_render_passes(settings):
-        aov_list = (settings["blender"]
-                            ["RenderSettings"]
-                            ["aov_list"])
-
-        custom_passes = (settings["blender"]
-                                 ["RenderSettings"]
-                                 ["custom_passes"])
-
-        vl = bpy.context.view_layer
-
-        vl.use_pass_combined = "combined" in aov_list
-        vl.use_pass_z = "z" in aov_list
-        vl.use_pass_mist = "mist" in aov_list
-        vl.use_pass_normal = "normal" in aov_list
-        vl.use_pass_diffuse_direct = "diffuse_light" in aov_list
-        vl.use_pass_diffuse_color = "diffuse_color" in aov_list
-        vl.use_pass_glossy_direct = "specular_light" in aov_list
-        vl.use_pass_glossy_color = "specular_color" in aov_list
-        vl.eevee.use_pass_volume_direct = "volume_light" in aov_list
-        vl.use_pass_emit = "emission" in aov_list
-        vl.use_pass_environment = "environment" in aov_list
-        vl.use_pass_shadow = "shadow" in aov_list
-        vl.use_pass_ambient_occlusion = "ao" in aov_list
-
-        aovs_names = [aov.name for aov in vl.aovs]
-        for cp in custom_passes:
-            cp_name = cp[0]
-            if cp_name not in aovs_names:
-                aov = vl.aovs.add()
-                aov.name = cp_name
-            else:
-                aov = vl.aovs[cp_name]
-            aov.type = cp[1].get("type", "VALUE")
-
-    def set_node_tree(self, output_path, instance, aov_sep, ext, multilayer):
-        # Set the scene to use the compositor node tree to render
-        bpy.context.scene.use_nodes = True
-
-        tree = bpy.context.scene.node_tree
-
-        # Get the Render Layers node
-        rl_node = None
-        for node in tree.nodes:
-            if node.bl_idname == "CompositorNodeRLayers":
-                rl_node = node
-                break
-
-        # If there's not a Render Layers node, we create it
-        if not rl_node:
-            rl_node = tree.nodes.new("CompositorNodeRLayers")
-
-        # Get the enabled output sockets, that are the active passes for the
-        # render.
-        # We also exclude some layers.
-        exclude_sockets = ["Image", "Alpha"]
-        passes = [
-            socket
-            for socket in rl_node.outputs
-            if socket.enabled and socket.name not in exclude_sockets
-        ]
-
-        # Remove all output nodes
-        for node in tree.nodes:
-            if node.bl_idname == "CompositorNodeOutputFile":
-                tree.nodes.remove(node)
-
-        # Create a new output node
-        output = tree.nodes.new("CompositorNodeOutputFile")
-
-        if ext == "exr" and multilayer:
-            output.layer_slots.clear()
-        else:
-            output.file_slots.clear()
-
-        output.base_path = output_path
-        image_settings = bpy.context.scene.render.image_settings
-        output.format.file_format = image_settings.file_format
-
-        aov_file_products = []
-
-        # For each active render pass, we add a new socket to the output node
-        # and link it
-        for render_pass in passes:
-            filepath = f"{instance.name}{aov_sep}{render_pass.name}.####"
-            if ext == "exr" and multilayer:
-                output.layer_slots.new(render_pass.name)
-            else:
-                output.file_slots.new(filepath)
-
-                aov_file_products.append(
-                    (render_pass.name, os.path.join(output_path, filepath)))
-
-            node_input = output.inputs[-1]
-
-            tree.links.new(render_pass, node_input)
-
-        return aov_file_products
-
-    @staticmethod
-    def set_render_camera(instance):
-        # There should be only one camera in the instance
-        found = False
-        for obj in instance:
-            if isinstance(obj, bpy.types.Object) and obj.type == "CAMERA":
-                bpy.context.scene.camera = obj
-                found = True
-                break
-
-        assert found, "No camera found in the render instance"
-
     def process(self, instance):
         context = instance.context
 
-        filepath = context.data["currentFile"].replace("\\", "/")
-        file_path = os.path.dirname(filepath)
-        file_name = os.path.basename(filepath)
-        file_name, _ = os.path.splitext(file_name)
+        render_data = bpy.data.collections[str(instance)].get("render_data")
 
-        project = get_current_project_name()
-        settings = get_project_settings(project)
+        assert render_data, "No render data found."
 
-        render_folder = self.get_default_render_folder(settings)
-        aov_sep = self.get_aov_separator(settings)
-        ext = self.get_image_format(settings)
-        multilayer = self.get_multilayer(settings)
+        self.log.info(f"render_data: {dict(render_data)}")
 
-        self.set_render_passes(settings)
-
-        output_path = os.path.join(file_path, render_folder, file_name)
-
-        render_product = self.get_render_product(output_path, instance)
-        aov_file_product = self.set_node_tree(
-            output_path, instance, aov_sep, ext, multilayer)
-
-        # We set the render path, the format and the camera
-        bpy.context.scene.render.filepath = render_product
-        self.set_render_format(ext, multilayer)
-        self.set_render_camera(instance)
-
-        # We save the file to save the render settings
-        bpy.ops.wm.save_as_mainfile(filepath=bpy.data.filepath)
+        render_product = render_data.get("render_product")
+        aov_file_product = render_data.get("aov_file_product")
+        ext = render_data.get("image_format")
 
         frame_start = context.data["frameStart"]
         frame_end = context.data["frameEnd"]

From 259255e7df5bfa6511c859d064aaea0d420b2f88 Mon Sep 17 00:00:00 2001
From: Simone Barbieri <simone.barbieri@hey.com>
Date: Wed, 23 Aug 2023 15:40:28 +0100
Subject: [PATCH 091/366] Hound fixes

---
 openpype/hosts/blender/plugins/create/create_render.py | 2 --
 1 file changed, 2 deletions(-)

diff --git a/openpype/hosts/blender/plugins/create/create_render.py b/openpype/hosts/blender/plugins/create/create_render.py
index 49d356ab67..53a84ab0b8 100644
--- a/openpype/hosts/blender/plugins/create/create_render.py
+++ b/openpype/hosts/blender/plugins/create/create_render.py
@@ -1,11 +1,9 @@
 """Create render."""
 import os
-import re
 
 import bpy
 
 from openpype.pipeline import (
-    get_current_context,
     get_current_project_name,
 )
 from openpype.settings import (

From 089909192026a82fde87ebe80e54871c712e32af Mon Sep 17 00:00:00 2001
From: Simone Barbieri <simone.barbieri@hey.com>
Date: Wed, 23 Aug 2023 16:33:02 +0100
Subject: [PATCH 092/366] Fix EXR multilayer output

---
 openpype/hosts/blender/plugins/create/create_render.py | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/openpype/hosts/blender/plugins/create/create_render.py b/openpype/hosts/blender/plugins/create/create_render.py
index 53a84ab0b8..468e4024e9 100644
--- a/openpype/hosts/blender/plugins/create/create_render.py
+++ b/openpype/hosts/blender/plugins/create/create_render.py
@@ -183,10 +183,12 @@ class CreateRenderlayer(plugin.Creator):
 
         if ext == "exr" and multilayer:
             output.layer_slots.clear()
+            filepath = f"{name}{aov_sep}AOVs.####"
+            output.base_path = os.path.join(output_path, filepath)
         else:
             output.file_slots.clear()
+            output.base_path = output_path
 
-        output.base_path = output_path
         image_settings = bpy.context.scene.render.image_settings
         output.format.file_format = image_settings.file_format
 
@@ -195,10 +197,11 @@ class CreateRenderlayer(plugin.Creator):
         # For each active render pass, we add a new socket to the output node
         # and link it
         for render_pass in passes:
-            filepath = f"{name}{aov_sep}{render_pass.name}.####"
             if ext == "exr" and multilayer:
                 output.layer_slots.new(render_pass.name)
             else:
+                filepath = f"{name}{aov_sep}{render_pass.name}.####"
+
                 output.file_slots.new(filepath)
 
                 aov_file_products.append(

From 028d15fc1efadd93fc963eae52177efa12d66d49 Mon Sep 17 00:00:00 2001
From: Simone Barbieri <simone.barbieri@hey.com>
Date: Wed, 23 Aug 2023 16:55:31 +0100
Subject: [PATCH 093/366] Added validator to check if file is saved

---
 .../plugins/publish/validate_file_saved.py    | 20 +++++++++++
 .../defaults/project_settings/blender.json    |  6 ++++
 .../schemas/schema_blender_publish.json       | 33 +++++++++++++++++++
 3 files changed, 59 insertions(+)
 create mode 100644 openpype/hosts/blender/plugins/publish/validate_file_saved.py

diff --git a/openpype/hosts/blender/plugins/publish/validate_file_saved.py b/openpype/hosts/blender/plugins/publish/validate_file_saved.py
new file mode 100644
index 0000000000..e191585c55
--- /dev/null
+++ b/openpype/hosts/blender/plugins/publish/validate_file_saved.py
@@ -0,0 +1,20 @@
+import bpy
+
+import pyblish.api
+
+
+class ValidateFileSaved(pyblish.api.InstancePlugin):
+    """Validate that the workfile has been saved."""
+
+    order = pyblish.api.ValidatorOrder - 0.01
+    hosts = ["blender"]
+    label = "Validate File Saved"
+    optional = False
+    exclude_families = []
+
+    def process(self, instance):
+        if [ef for ef in self.exclude_families
+                if instance.data["family"] in ef]:
+            return
+        if bpy.data.is_dirty:
+            raise RuntimeError("Workfile is not saved.")
diff --git a/openpype/settings/defaults/project_settings/blender.json b/openpype/settings/defaults/project_settings/blender.json
index 8b1d602df0..09ed800ac8 100644
--- a/openpype/settings/defaults/project_settings/blender.json
+++ b/openpype/settings/defaults/project_settings/blender.json
@@ -35,6 +35,12 @@
             "optional": true,
             "active": true
         },
+        "ValidateFileSaved": {
+            "enabled": true,
+            "optional": false,
+            "active": true,
+            "exclude_families": []
+        },
         "ValidateMeshHasUvs": {
             "enabled": true,
             "optional": true,
diff --git a/openpype/settings/entities/schemas/projects_schema/schemas/schema_blender_publish.json b/openpype/settings/entities/schemas/projects_schema/schemas/schema_blender_publish.json
index 2f0bf0a831..0b694e5b70 100644
--- a/openpype/settings/entities/schemas/projects_schema/schemas/schema_blender_publish.json
+++ b/openpype/settings/entities/schemas/projects_schema/schemas/schema_blender_publish.json
@@ -18,6 +18,39 @@
                 }
             ]
         },
+        {
+            "type": "dict",
+            "collapsible": true,
+            "key": "ValidateFileSaved",
+            "label": "Validate File Saved",
+            "checkbox_key": "enabled",
+            "children": [
+                {
+                    "type": "boolean",
+                    "key": "enabled",
+                    "label": "Enabled"
+                },
+                {
+                    "type": "boolean",
+                    "key": "optional",
+                    "label": "Optional"
+                },
+                {
+                    "type": "boolean",
+                    "key": "active",
+                    "label": "Active"
+                },
+                {
+                    "type": "splitter"
+                },
+                {
+                    "key": "exclude_families",
+                    "label": "Exclude Families",
+                    "type": "list",
+                    "object_type": "text"
+                }
+            ]
+        },
         {
             "type": "collapsible-wrap",
             "label": "Model",

From ee8a2b1aa37567ccfc77fe3f31562eca0622f294 Mon Sep 17 00:00:00 2001
From: Mustafa-Zarkash <mustafataherzaky@outlook.com>
Date: Wed, 23 Aug 2023 19:10:40 +0300
Subject: [PATCH 094/366] update geo validation

---
 .../publish/validate_fbx_hierarchy_path.py    | 36 ++++++++++++-------
 1 file changed, 23 insertions(+), 13 deletions(-)

diff --git a/openpype/hosts/houdini/plugins/publish/validate_fbx_hierarchy_path.py b/openpype/hosts/houdini/plugins/publish/validate_fbx_hierarchy_path.py
index 9208a16bd1..e060756801 100644
--- a/openpype/hosts/houdini/plugins/publish/validate_fbx_hierarchy_path.py
+++ b/openpype/hosts/houdini/plugins/publish/validate_fbx_hierarchy_path.py
@@ -17,7 +17,10 @@ This plugin is part of publish process guide.
 """
 
 import pyblish.api
-from openpype.pipeline import PublishValidationError
+from openpype.pipeline import (
+    PublishValidationError,
+    OptionalPyblishPluginMixin
+)
 from openpype.pipeline.publish import (
     ValidateContentsOrder,
     RepairAction,
@@ -37,7 +40,8 @@ class AddDefaultPathAction(RepairAction):
     icon = "mdi.pencil-plus-outline"
 
 
-class ValidatePrimitiveHierarchyPaths(pyblish.api.InstancePlugin):
+class ValidateFBXPrimitiveHierarchyPaths(pyblish.api.InstancePlugin,
+                                         OptionalPyblishPluginMixin):
     """Validate all primitives build hierarchy from attribute
     when enabled.
 
@@ -50,7 +54,7 @@ class ValidatePrimitiveHierarchyPaths(pyblish.api.InstancePlugin):
 
     families = ["filmboxfbx"]
     hosts = ["houdini"]
-    label = "Validate FBX Hierarchy Path"
+    label = "Validate Prims Hierarchy Path (FBX)"
 
     # Usually you will use this value as default
     order = ValidateContentsOrder + 0.1
@@ -61,6 +65,10 @@ class ValidatePrimitiveHierarchyPaths(pyblish.api.InstancePlugin):
     actions = [SelectInvalidAction, AddDefaultPathAction,
                SelectROPAction]
 
+    # 'OptionalPyblishPluginMixin' where logic for 'optional' is implemented.
+    #  It requires updating project settings
+    optional = True
+
     # overrides InstancePlugin.process()
     def process(self, instance):
         invalid = self.get_invalid(instance)
@@ -108,19 +116,21 @@ class ValidatePrimitiveHierarchyPaths(pyblish.api.InstancePlugin):
 
         cls.log.debug("Checking for attribute: %s", path_attr)
 
-        if not hasattr(output_node, "geometry"):
-            # In the case someone has explicitly set an Object
-            # node instead of a SOP node in Geometry context
-            # then for now we ignore - this allows us to also
-            # export object transforms.
-            cls.log.warning("No geometry output node found,"
+        # Get frame
+        frame = hou.intFrame()
+        trange = rop_node.parm("trange").eval()
+        if trange:
+            frame = int(hou.playbar.frameRange()[0])
+
+        frame = instance.data.get("frameStart", frame)
+
+        # Get Geo at that frame
+        geo = output_node.geometryAtFrame(frame)
+        if not geo:
+            cls.log.warning("No geometry found,"
                             " skipping check..")
             return
 
-        # Check if the primitive attribute exists
-        frame = instance.data.get("frameStart", 0)
-        geo = output_node.geometryAtFrame(frame)
-
         # If there are no primitives on the current frame then
         # we can't check whether the path names are correct.
         # So we'll just issue a warning that the check can't

From 1d0c78f044a4f0d5dd6092968ff543f09d5c5987 Mon Sep 17 00:00:00 2001
From: Mustafa-Zarkash <mustafataherzaky@outlook.com>
Date: Wed, 23 Aug 2023 19:11:04 +0300
Subject: [PATCH 095/366] update label

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

diff --git a/openpype/hosts/houdini/plugins/publish/validate_primitive_hierarchy_paths.py b/openpype/hosts/houdini/plugins/publish/validate_primitive_hierarchy_paths.py
index 471fa5b6d1..930978ef16 100644
--- a/openpype/hosts/houdini/plugins/publish/validate_primitive_hierarchy_paths.py
+++ b/openpype/hosts/houdini/plugins/publish/validate_primitive_hierarchy_paths.py
@@ -26,7 +26,7 @@ class ValidatePrimitiveHierarchyPaths(pyblish.api.InstancePlugin):
     order = ValidateContentsOrder + 0.1
     families = ["abc"]
     hosts = ["houdini"]
-    label = "Validate Prims Hierarchy Path"
+    label = "Validate Prims Hierarchy Path (ABC)"
     actions = [AddDefaultPathAction]
 
     def process(self, instance):

From 4ea1f2b586835f6a6cad97633d5149fc614ce991 Mon Sep 17 00:00:00 2001
From: Mustafa-Zarkash <mustafataherzaky@outlook.com>
Date: Wed, 23 Aug 2023 19:11:47 +0300
Subject: [PATCH 096/366] include fbx validator in settings

---
 openpype/settings/defaults/project_settings/houdini.json  | 5 +++++
 .../projects_schema/schemas/schema_houdini_publish.json   | 6 +++++-
 server_addon/houdini/server/settings/publish_plugins.py   | 8 ++++++++
 server_addon/houdini/server/version.py                    | 2 +-
 4 files changed, 19 insertions(+), 2 deletions(-)

diff --git a/openpype/settings/defaults/project_settings/houdini.json b/openpype/settings/defaults/project_settings/houdini.json
index 9d047c28bd..2295422202 100644
--- a/openpype/settings/defaults/project_settings/houdini.json
+++ b/openpype/settings/defaults/project_settings/houdini.json
@@ -97,6 +97,11 @@
             "enabled": true,
             "optional": true,
             "active": true
+        },
+        "ValidateFBXPrimitiveHierarchyPaths": {
+            "enabled": true,
+            "optional": true,
+            "active": true
         }
     }
 }
diff --git a/openpype/settings/entities/schemas/projects_schema/schemas/schema_houdini_publish.json b/openpype/settings/entities/schemas/projects_schema/schemas/schema_houdini_publish.json
index aa6eaf5164..d58b36eff1 100644
--- a/openpype/settings/entities/schemas/projects_schema/schemas/schema_houdini_publish.json
+++ b/openpype/settings/entities/schemas/projects_schema/schemas/schema_houdini_publish.json
@@ -43,8 +43,12 @@
           {
               "key": "ValidateContainers",
               "label": "ValidateContainers"
+          },
+          {
+            "key": "ValidateFBXPrimitiveHierarchyPaths",
+            "label": "Validate Path Attribute for FBX"
           }
       ]
     }
   ]
-}
\ No newline at end of file
+}
diff --git a/server_addon/houdini/server/settings/publish_plugins.py b/server_addon/houdini/server/settings/publish_plugins.py
index 7d35d7e634..44ff00c318 100644
--- a/server_addon/houdini/server/settings/publish_plugins.py
+++ b/server_addon/houdini/server/settings/publish_plugins.py
@@ -133,6 +133,9 @@ class PublishPluginsModel(BaseSettingsModel):
     ValidateContainers: ValidateContainersModel = Field(
         default_factory=ValidateContainersModel,
         title="Validate Latest Containers.")
+    ValidateFBXPrimitiveHierarchyPaths: ValidateContainersModel = Field(
+        default_factory=ValidateContainersModel,
+        title="Validate Path Attribute for FBX.")
 
 
 DEFAULT_HOUDINI_PUBLISH_SETTINGS = {
@@ -152,5 +155,10 @@ DEFAULT_HOUDINI_PUBLISH_SETTINGS = {
         "enabled": True,
         "optional": True,
         "active": True
+    },
+    "ValidateFBXPrimitiveHierarchyPaths": {
+        "enabled": True,
+        "optional": True,
+        "active": True
     }
 }
diff --git a/server_addon/houdini/server/version.py b/server_addon/houdini/server/version.py
index 485f44ac21..b3f4756216 100644
--- a/server_addon/houdini/server/version.py
+++ b/server_addon/houdini/server/version.py
@@ -1 +1 @@
-__version__ = "0.1.1"
+__version__ = "0.1.2"

From 96893f6ab0a56db976aa14709f2fbbd734b70f88 Mon Sep 17 00:00:00 2001
From: Mustafa-Zarkash <mustafataherzaky@outlook.com>
Date: Wed, 23 Aug 2023 19:56:29 +0300
Subject: [PATCH 097/366] update doc string

---
 openpype/hosts/houdini/plugins/create/create_fbx.py | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/openpype/hosts/houdini/plugins/create/create_fbx.py b/openpype/hosts/houdini/plugins/create/create_fbx.py
index cac90f1e87..b45aef8fdf 100644
--- a/openpype/hosts/houdini/plugins/create/create_fbx.py
+++ b/openpype/hosts/houdini/plugins/create/create_fbx.py
@@ -67,6 +67,8 @@ class CreateFilmboxFBX(plugin.HoudiniCreator):
 
     # Overrides HoudiniCreator.get_pre_create_attr_defs()
     def get_pre_create_attr_defs(self):
+        """Add settings for users. """
+
         attrs = super().get_pre_create_attr_defs()
         vcformat = EnumDef("vcformat",
                            items={

From a0c25edab9e3f209486a53b8caa99b658366f9c7 Mon Sep 17 00:00:00 2001
From: Simone Barbieri <simone.barbieri@hey.com>
Date: Thu, 24 Aug 2023 11:06:37 +0100
Subject: [PATCH 098/366] Add check to remove instance if any error is
 triggered during creation

---
 .../blender/plugins/create/create_render.py   | 49 ++++++++++---------
 1 file changed, 25 insertions(+), 24 deletions(-)

diff --git a/openpype/hosts/blender/plugins/create/create_render.py b/openpype/hosts/blender/plugins/create/create_render.py
index 468e4024e9..63093b539c 100644
--- a/openpype/hosts/blender/plugins/create/create_render.py
+++ b/openpype/hosts/blender/plugins/create/create_render.py
@@ -235,30 +235,7 @@ class CreateRenderlayer(plugin.Creator):
                 continue
             node[RENDER_DATA][key] = value
 
-    def process(self):
-        # Get Instance Container or create it if it does not exist
-        instances = bpy.data.collections.get(AVALON_INSTANCES)
-        if not instances:
-            instances = bpy.data.collections.new(name=AVALON_INSTANCES)
-            bpy.context.scene.collection.children.link(instances)
-
-        # Create instance object
-        asset = self.data["asset"]
-        subset = self.data["subset"]
-        name = plugin.asset_name(asset, subset)
-        asset_group = bpy.data.collections.new(name=name)
-        instances.children.link(asset_group)
-        self.data['task'] = get_current_task_name()
-        lib.imprint(asset_group, self.data)
-
-        if (self.options or {}).get("useSelection"):
-            selected = lib.get_selection()
-            for obj in selected:
-                asset_group.objects.link(obj)
-        elif (self.options or {}).get("asset_group"):
-            obj = (self.options or {}).get("asset_group")
-            asset_group.objects.link(obj)
-
+    def prepare_rendering(self, asset_group, name):
         filepath = bpy.data.filepath
         assert filepath, "Workfile not saved. Please save the file first."
 
@@ -300,4 +277,28 @@ class CreateRenderlayer(plugin.Creator):
 
         self.imprint_render_settings(asset_group, render_settings)
 
+    def process(self):
+        # Get Instance Container or create it if it does not exist
+        instances = bpy.data.collections.get(AVALON_INSTANCES)
+        if not instances:
+            instances = bpy.data.collections.new(name=AVALON_INSTANCES)
+            bpy.context.scene.collection.children.link(instances)
+
+        # Create instance object
+        asset = self.data["asset"]
+        subset = self.data["subset"]
+        name = plugin.asset_name(asset, subset)
+        asset_group = bpy.data.collections.new(name=name)
+
+        try:
+            instances.children.link(asset_group)
+            self.data['task'] = get_current_task_name()
+            lib.imprint(asset_group, self.data)
+
+            self.prepare_rendering(asset_group, name)
+        except Exception:
+            # Remove the instance if there was an error
+            bpy.data.collections.remove(asset_group)
+            raise
+
         return asset_group

From 153a2999011f27901dd05a8953cd91ea82b649c1 Mon Sep 17 00:00:00 2001
From: Simone Barbieri <simone.barbieri@hey.com>
Date: Thu, 24 Aug 2023 11:37:52 +0100
Subject: [PATCH 099/366] Removed camera from render instance and added
 validator to check camera

---
 .../blender/plugins/create/create_render.py   | 13 ----------
 .../publish/validate_render_camera_is_set.py  | 17 +++++++++++++
 .../defaults/project_settings/blender.json    |  5 ++++
 .../schemas/schema_blender_publish.json       | 24 +++++++++++++++++++
 4 files changed, 46 insertions(+), 13 deletions(-)
 create mode 100644 openpype/hosts/blender/plugins/publish/validate_render_camera_is_set.py

diff --git a/openpype/hosts/blender/plugins/create/create_render.py b/openpype/hosts/blender/plugins/create/create_render.py
index 63093b539c..2952baafd3 100644
--- a/openpype/hosts/blender/plugins/create/create_render.py
+++ b/openpype/hosts/blender/plugins/create/create_render.py
@@ -213,18 +213,6 @@ class CreateRenderlayer(plugin.Creator):
 
         return aov_file_products
 
-    @staticmethod
-    def set_render_camera(asset_group):
-        # There should be only one camera in the instance
-        found = False
-        for obj in asset_group.all_objects:
-            if isinstance(obj, bpy.types.Object) and obj.type == "CAMERA":
-                bpy.context.scene.camera = obj
-                found = True
-                break
-
-        assert found, "No camera found in the render instance"
-
     @staticmethod
     def imprint_render_settings(node, data):
         RENDER_DATA = "render_data"
@@ -262,7 +250,6 @@ class CreateRenderlayer(plugin.Creator):
         # We set the render path, the format and the camera
         bpy.context.scene.render.filepath = render_product
         self.set_render_format(ext, multilayer)
-        self.set_render_camera(asset_group)
 
         render_settings = {
             "render_folder": render_folder,
diff --git a/openpype/hosts/blender/plugins/publish/validate_render_camera_is_set.py b/openpype/hosts/blender/plugins/publish/validate_render_camera_is_set.py
new file mode 100644
index 0000000000..5a06c1ff0a
--- /dev/null
+++ b/openpype/hosts/blender/plugins/publish/validate_render_camera_is_set.py
@@ -0,0 +1,17 @@
+import bpy
+
+import pyblish.api
+
+
+class ValidateRenderCameraIsSet(pyblish.api.InstancePlugin):
+    """Validate that there is a camera set as active for rendering."""
+
+    order = pyblish.api.ValidatorOrder
+    hosts = ["blender"]
+    families = ["renderlayer"]
+    label = "Validate Render Camera Is Set"
+    optional = False
+
+    def process(self, instance):
+        if not bpy.context.scene.camera:
+            raise RuntimeError("No camera is active for rendering.")
diff --git a/openpype/settings/defaults/project_settings/blender.json b/openpype/settings/defaults/project_settings/blender.json
index 09ed800ac8..9cbbb49593 100644
--- a/openpype/settings/defaults/project_settings/blender.json
+++ b/openpype/settings/defaults/project_settings/blender.json
@@ -41,6 +41,11 @@
             "active": true,
             "exclude_families": []
         },
+        "ValidateRenderCameraIsSet": {
+            "enabled": true,
+            "optional": false,
+            "active": true
+        },
         "ValidateMeshHasUvs": {
             "enabled": true,
             "optional": true,
diff --git a/openpype/settings/entities/schemas/projects_schema/schemas/schema_blender_publish.json b/openpype/settings/entities/schemas/projects_schema/schemas/schema_blender_publish.json
index 0b694e5b70..05e7f13e70 100644
--- a/openpype/settings/entities/schemas/projects_schema/schemas/schema_blender_publish.json
+++ b/openpype/settings/entities/schemas/projects_schema/schemas/schema_blender_publish.json
@@ -51,6 +51,30 @@
                 }
             ]
         },
+        {
+            "type": "dict",
+            "collapsible": true,
+            "key": "ValidateRenderCameraIsSet",
+            "label": "Validate Render Camera Is Set",
+            "checkbox_key": "enabled",
+            "children": [
+                {
+                    "type": "boolean",
+                    "key": "enabled",
+                    "label": "Enabled"
+                },
+                {
+                    "type": "boolean",
+                    "key": "optional",
+                    "label": "Optional"
+                },
+                {
+                    "type": "boolean",
+                    "key": "active",
+                    "label": "Active"
+                }
+            ]
+        },
         {
             "type": "collapsible-wrap",
             "label": "Model",

From e181eeab93db55b7804f3b6f5055369e1a30ede7 Mon Sep 17 00:00:00 2001
From: Mustafa-Zarkash <mustafataherzaky@outlook.com>
Date: Thu, 24 Aug 2023 16:02:18 +0300
Subject: [PATCH 100/366] convert filmboxfbx to UE static mesh

---
 ...ate_fbx.py => create_unreal_staticmesh.py} | 25 ++++++---------
 .../hosts/houdini/plugins/load/load_fbx.py    |  2 +-
 .../plugins/publish/collect_fbx_type.py       | 10 +++---
 .../houdini/plugins/publish/extract_fbx.py    |  4 +--
 .../publish/validate_fbx_hierarchy_path.py    |  2 +-
 .../publish/validate_sop_output_node.py       |  2 +-
 openpype/plugins/publish/integrate.py         |  3 +-
 .../defaults/project_settings/houdini.json    | 13 ++++++++
 .../schemas/schema_houdini_create.json        | 31 +++++++++++++++++++
 .../server/settings/publish_plugins.py        | 29 +++++++++++++++++
 10 files changed, 94 insertions(+), 27 deletions(-)
 rename openpype/hosts/houdini/plugins/create/{create_fbx.py => create_unreal_staticmesh.py} (89%)

diff --git a/openpype/hosts/houdini/plugins/create/create_fbx.py b/openpype/hosts/houdini/plugins/create/create_unreal_staticmesh.py
similarity index 89%
rename from openpype/hosts/houdini/plugins/create/create_fbx.py
rename to openpype/hosts/houdini/plugins/create/create_unreal_staticmesh.py
index b45aef8fdf..4543f14934 100644
--- a/openpype/hosts/houdini/plugins/create/create_fbx.py
+++ b/openpype/hosts/houdini/plugins/create/create_unreal_staticmesh.py
@@ -20,17 +20,18 @@ from openpype.lib import EnumDef
 import hou
 
 
-class CreateFilmboxFBX(plugin.HoudiniCreator):
+class HouCreateUnrealStaticMesh(plugin.HoudiniCreator):
     """Filmbox FBX Driver."""
 
     # you should set
-    identifier = "io.openpype.creators.houdini.filmboxfbx"
-    label = "Filmbox FBX"
-    family = "filmboxfbx"
+    identifier = "io.openpype.creators.houdini.unrealstaticmesh"
+    label = "Unreal - Static Mesh"
+    family = "staticMesh"
     icon = "fa5s.cubes"
 
     # optional to set
     default_variant = "Main"
+    # 'default_variants' will be overriden by settings.
     default_variants = ["Main", "Test"]
 
     # Overrides HoudiniCreator.create()
@@ -40,7 +41,7 @@ class CreateFilmboxFBX(plugin.HoudiniCreator):
         instance_data.update({"node_type": "filmboxfbx"})
 
         # create instance (calls HoudiniCreator.create())
-        instance = super(CreateFilmboxFBX, self).create(
+        instance = super(HouCreateUnrealStaticMesh, self).create(
             subset_name,
             instance_data,
             pre_create_data)
@@ -77,15 +78,8 @@ class CreateFilmboxFBX(plugin.HoudiniCreator):
                            },
                            default=0,
                            label="Vertex Cache Format")
-        trange = EnumDef("trange",
-                         items={
-                             0: "Render Current Frame",
-                             1: "Render Frame Range"
-                         },
-                         default=0,
-                         label="Valid Frame Range")
 
-        return attrs + [vcformat, trange]
+        return attrs + [vcformat]
 
     def get_parms(self, subset_name, pre_create_data):
         """Get parameters values for this specific node."""
@@ -100,8 +94,9 @@ class CreateFilmboxFBX(plugin.HoudiniCreator):
         # 3. get Vertex Cache Format
         vcformat = pre_create_data.get("vcformat")
 
-        # 4. get Valid Frame Range
-        trange = pre_create_data.get("trange")
+        # 4. Valid Frame Range
+        # It should publish the current frame.
+        trange = 0
 
         # parms dictionary
         parms = {
diff --git a/openpype/hosts/houdini/plugins/load/load_fbx.py b/openpype/hosts/houdini/plugins/load/load_fbx.py
index 34f75e1485..d661f84eeb 100644
--- a/openpype/hosts/houdini/plugins/load/load_fbx.py
+++ b/openpype/hosts/houdini/plugins/load/load_fbx.py
@@ -20,7 +20,7 @@ class FbxLoader(load.LoaderPlugin):
     """Load fbx files to Houdini."""
 
     label = "Load FBX"
-    families = ["filmboxfbx", "fbx"]
+    families = ["staticMesh", "fbx"]
     representations = ["fbx"]
 
     # Usually you will use these value as default
diff --git a/openpype/hosts/houdini/plugins/publish/collect_fbx_type.py b/openpype/hosts/houdini/plugins/publish/collect_fbx_type.py
index 3ee2541f72..4c83829c67 100644
--- a/openpype/hosts/houdini/plugins/publish/collect_fbx_type.py
+++ b/openpype/hosts/houdini/plugins/publish/collect_fbx_type.py
@@ -13,11 +13,11 @@ import pyblish.api
 
 
 class CollectFilmboxfbxType(pyblish.api.InstancePlugin):
-    """Collect data type for filmboxfbx instance."""
+    """Collect data type for fbx instance."""
 
     hosts = ["houdini"]
-    families = ["filmboxfbx"]
-    label = "Collect type of filmboxfbx"
+    families = ["fbx", "staticMesh"]
+    label = "Collect type of fbx"
 
     # Usually you will use this value as default
     order = pyblish.api.CollectorOrder
@@ -25,12 +25,12 @@ class CollectFilmboxfbxType(pyblish.api.InstancePlugin):
     # overrides InstancePlugin.process()
     def process(self, instance):
 
-        if instance.data["creator_identifier"] == "io.openpype.creators.houdini.filmboxfbx":  # noqa: E501
+        if instance.data["creator_identifier"] == "io.openpype.creators.houdini.unrealstaticmesh":  # noqa: E501
             # such a condition can be used to differentiate between
             #  instances by identifier becuase sometimes instances
             #  may have the same family but different identifier
             #  e.g. bgeo and alembic
-            pass
+            instance.data["families"] += ["fbx"]
 
         # Update instance.data with ouptut_node
         out_node = self.get_output_node(instance)
diff --git a/openpype/hosts/houdini/plugins/publish/extract_fbx.py b/openpype/hosts/houdini/plugins/publish/extract_fbx.py
index 102b075838..8e45a554c0 100644
--- a/openpype/hosts/houdini/plugins/publish/extract_fbx.py
+++ b/openpype/hosts/houdini/plugins/publish/extract_fbx.py
@@ -18,8 +18,8 @@ import hou
 
 class ExtractRedshiftProxy(publish.Extractor):
 
-    label = "Extract FilmBox FBX"
-    families = ["filmboxfbx"]
+    label = "Extract FBX"
+    families = ["fbx"]
     hosts = ["houdini"]
 
     # Usually you will use this value as default
diff --git a/openpype/hosts/houdini/plugins/publish/validate_fbx_hierarchy_path.py b/openpype/hosts/houdini/plugins/publish/validate_fbx_hierarchy_path.py
index e060756801..01cb01f497 100644
--- a/openpype/hosts/houdini/plugins/publish/validate_fbx_hierarchy_path.py
+++ b/openpype/hosts/houdini/plugins/publish/validate_fbx_hierarchy_path.py
@@ -52,7 +52,7 @@ class ValidateFBXPrimitiveHierarchyPaths(pyblish.api.InstancePlugin,
     by default.
     """
 
-    families = ["filmboxfbx"]
+    families = ["fbx"]
     hosts = ["houdini"]
     label = "Validate Prims Hierarchy Path (FBX)"
 
diff --git a/openpype/hosts/houdini/plugins/publish/validate_sop_output_node.py b/openpype/hosts/houdini/plugins/publish/validate_sop_output_node.py
index da9752505a..2b426d96dd 100644
--- a/openpype/hosts/houdini/plugins/publish/validate_sop_output_node.py
+++ b/openpype/hosts/houdini/plugins/publish/validate_sop_output_node.py
@@ -22,7 +22,7 @@ class ValidateSopOutputNode(pyblish.api.InstancePlugin):
     """
 
     order = pyblish.api.ValidatorOrder
-    families = ["pointcache", "vdbcache", "filmboxfbx"]
+    families = ["pointcache", "vdbcache", "fbx"]
     hosts = ["houdini"]
     label = "Validate Output Node"
     actions = [SelectROPAction, SelectInvalidAction]
diff --git a/openpype/plugins/publish/integrate.py b/openpype/plugins/publish/integrate.py
index ee4af1a0e0..be07cffe72 100644
--- a/openpype/plugins/publish/integrate.py
+++ b/openpype/plugins/publish/integrate.py
@@ -139,8 +139,7 @@ class IntegrateAsset(pyblish.api.InstancePlugin):
                 "simpleUnrealTexture",
                 "online",
                 "uasset",
-                "blendScene",
-                "filmboxfbx"
+                "blendScene"
                 ]
 
     default_template_name = "publish"
diff --git a/openpype/settings/defaults/project_settings/houdini.json b/openpype/settings/defaults/project_settings/houdini.json
index 2295422202..e19e71de17 100644
--- a/openpype/settings/defaults/project_settings/houdini.json
+++ b/openpype/settings/defaults/project_settings/houdini.json
@@ -19,6 +19,19 @@
             ],
             "ext": ".ass"
         },
+        "HouCreateUnrealStaticMesh": {
+            "enabled": true,
+            "default_variants": [
+                "Main"
+            ],
+            "static_mesh_prefix": "S",
+            "collision_prefixes": [
+                "UBX",
+                "UCP",
+                "USP",
+                "UCX"
+            ]
+        },
         "CreateAlembicCamera": {
             "enabled": true,
             "default_variants": [
diff --git a/openpype/settings/entities/schemas/projects_schema/schemas/schema_houdini_create.json b/openpype/settings/entities/schemas/projects_schema/schemas/schema_houdini_create.json
index 799bc0e81a..3d55bd834f 100644
--- a/openpype/settings/entities/schemas/projects_schema/schemas/schema_houdini_create.json
+++ b/openpype/settings/entities/schemas/projects_schema/schemas/schema_houdini_create.json
@@ -39,6 +39,37 @@
             ]
 
         },
+        {
+            "type": "dict",
+            "collapsible": true,
+            "key": "HouCreateUnrealStaticMesh",
+            "label": "Create Unreal - Static Mesh",
+            "checkbox_key": "enabled",
+            "children": [
+                {
+                    "type": "boolean",
+                    "key": "enabled",
+                    "label": "Enabled"
+                },
+                {
+                    "type": "list",
+                    "key": "default_variants",
+                    "label": "Default Variants",
+                    "object_type": "text"
+                },
+                {
+                    "type": "text",
+                    "key": "static_mesh_prefix",
+                    "label": "Static Mesh Prefix"
+                },
+                {
+                    "type": "list",
+                    "key": "collision_prefixes",
+                    "label": "Collision Mesh Prefixes",
+                    "object_type": "text"
+                }
+            ]
+        },
         {
             "type": "schema_template",
             "name": "template_create_plugin",
diff --git a/server_addon/houdini/server/settings/publish_plugins.py b/server_addon/houdini/server/settings/publish_plugins.py
index 44ff00c318..5ddfa07bc4 100644
--- a/server_addon/houdini/server/settings/publish_plugins.py
+++ b/server_addon/houdini/server/settings/publish_plugins.py
@@ -20,11 +20,27 @@ class CreateArnoldAssModel(BaseSettingsModel):
     )
     ext: str = Field(Title="Extension")
 
+class HouCreateUnrealStaticMeshModel(BaseSettingsModel):
+    enabled: bool = Field(title="Enabled")
+    default_variants: list[str] = Field(
+        default_factory=list,
+        title="Default Products"
+    )
+    static_mesh_prefixes: str = Field("S", title="Static Mesh Prefix")
+    collision_prefixes: list[str] = Field(
+        default_factory=list,
+        title="Collision Prefixes"
+    )
 
 class CreatePluginsModel(BaseSettingsModel):
     CreateArnoldAss: CreateArnoldAssModel = Field(
         default_factory=CreateArnoldAssModel,
         title="Create Alembic Camera")
+    # "-" is not compatible in the new model
+    HouCreateUnrealStaticMesh: HouCreateUnrealStaticMeshModel = Field(
+        default_factory=HouCreateUnrealStaticMeshModel,
+        title="Create Unreal_Static Mesh"
+    )
     CreateAlembicCamera: CreatorModel = Field(
         default_factory=CreatorModel,
         title="Create Alembic Camera")
@@ -63,6 +79,19 @@ DEFAULT_HOUDINI_CREATE_SETTINGS = {
         "default_variants": ["Main"],
         "ext": ".ass"
     },
+    "HouCreateUnrealStaticMesh": {
+        "enabled": True,
+        "default_variants": [
+            "Main"
+        ],
+        "static_mesh_prefix": "S",
+        "collision_prefixes": [
+            "UBX",
+            "UCP",
+            "USP",
+            "UCX"
+        ]
+    },
     "CreateAlembicCamera": {
         "enabled": True,
         "default_variants": ["Main"]

From b6a81bd64b74c60e2b0e8e271f7f2704b6b80bf7 Mon Sep 17 00:00:00 2001
From: Mustafa-Zarkash <mustafataherzaky@outlook.com>
Date: Thu, 24 Aug 2023 16:06:21 +0300
Subject: [PATCH 101/366] resolve hound conversations

---
 .../hosts/houdini/plugins/create/create_unreal_staticmesh.py   | 3 ++-
 server_addon/houdini/server/settings/publish_plugins.py        | 2 ++
 2 files changed, 4 insertions(+), 1 deletion(-)

diff --git a/openpype/hosts/houdini/plugins/create/create_unreal_staticmesh.py b/openpype/hosts/houdini/plugins/create/create_unreal_staticmesh.py
index 4543f14934..2a284f7979 100644
--- a/openpype/hosts/houdini/plugins/create/create_unreal_staticmesh.py
+++ b/openpype/hosts/houdini/plugins/create/create_unreal_staticmesh.py
@@ -154,7 +154,8 @@ class HouCreateUnrealStaticMesh(plugin.HoudiniCreator):
 
             if not selection:
                 self.log.debug(
-                    "Selection isn't valid. 'Export' in filmboxfbx will be empty."
+                    "Selection isn't valid. 'Export' in "
+                    "filmboxfbx will be empty."
                 )
         else:
             self.log.debug(
diff --git a/server_addon/houdini/server/settings/publish_plugins.py b/server_addon/houdini/server/settings/publish_plugins.py
index 5ddfa07bc4..aaa1d0ba1d 100644
--- a/server_addon/houdini/server/settings/publish_plugins.py
+++ b/server_addon/houdini/server/settings/publish_plugins.py
@@ -20,6 +20,7 @@ class CreateArnoldAssModel(BaseSettingsModel):
     )
     ext: str = Field(Title="Extension")
 
+
 class HouCreateUnrealStaticMeshModel(BaseSettingsModel):
     enabled: bool = Field(title="Enabled")
     default_variants: list[str] = Field(
@@ -32,6 +33,7 @@ class HouCreateUnrealStaticMeshModel(BaseSettingsModel):
         title="Collision Prefixes"
     )
 
+
 class CreatePluginsModel(BaseSettingsModel):
     CreateArnoldAss: CreateArnoldAssModel = Field(
         default_factory=CreateArnoldAssModel,

From 0f1bf31f69bfb0632eba5f8994e84c6f72d52126 Mon Sep 17 00:00:00 2001
From: Simone Barbieri <simone.barbieri@hey.com>
Date: Thu, 24 Aug 2023 15:33:16 +0100
Subject: [PATCH 102/366] Updated settings for Ayon

---
 server_addon/blender/server/settings/main.py  |   7 ++
 .../server/settings/publish_plugins.py        |  31 +++++
 .../server/settings/render_settings.py        | 106 ++++++++++++++++++
 server_addon/blender/server/version.py        |   2 +-
 .../server/settings/publish_plugins.py        |  25 ++++-
 5 files changed, 168 insertions(+), 3 deletions(-)
 create mode 100644 server_addon/blender/server/settings/render_settings.py

diff --git a/server_addon/blender/server/settings/main.py b/server_addon/blender/server/settings/main.py
index f6118d39cd..4476ea709b 100644
--- a/server_addon/blender/server/settings/main.py
+++ b/server_addon/blender/server/settings/main.py
@@ -9,6 +9,10 @@ from .publish_plugins import (
     PublishPuginsModel,
     DEFAULT_BLENDER_PUBLISH_SETTINGS
 )
+from .render_settings import (
+    RenderSettingsModel,
+    DEFAULT_RENDER_SETTINGS
+)
 
 
 class UnitScaleSettingsModel(BaseSettingsModel):
@@ -37,6 +41,8 @@ class BlenderSettings(BaseSettingsModel):
         default_factory=BlenderImageIOModel,
         title="Color Management (ImageIO)"
     )
+    render_settings: RenderSettingsModel = Field(
+        default_factory=RenderSettingsModel, title="Render Settings")
     workfile_builder: TemplateWorkfileBaseOptions = Field(
         default_factory=TemplateWorkfileBaseOptions,
         title="Workfile Builder"
@@ -55,6 +61,7 @@ DEFAULT_VALUES = {
     },
     "set_frames_startup": True,
     "set_resolution_startup": True,
+    "render_settings": DEFAULT_RENDER_SETTINGS,
     "publish": DEFAULT_BLENDER_PUBLISH_SETTINGS,
     "workfile_builder": {
         "create_first_version": False,
diff --git a/server_addon/blender/server/settings/publish_plugins.py b/server_addon/blender/server/settings/publish_plugins.py
index 65dda78411..575bfe9f39 100644
--- a/server_addon/blender/server/settings/publish_plugins.py
+++ b/server_addon/blender/server/settings/publish_plugins.py
@@ -26,6 +26,16 @@ class ValidatePluginModel(BaseSettingsModel):
     active: bool = Field(title="Active")
 
 
+class ValidateFileSavedModel(BaseSettingsModel):
+    enabled: bool = Field(title="ValidateFileSaved")
+    optional: bool = Field(title="Optional")
+    active: bool = Field(title="Active")
+    exclude_families: list[str] = Field(
+        default_factory=list,
+        title="Exclude product types"
+    )
+
+
 class ExtractBlendModel(BaseSettingsModel):
     enabled: bool = Field(True)
     optional: bool = Field(title="Optional")
@@ -53,6 +63,16 @@ class PublishPuginsModel(BaseSettingsModel):
         title="Validate Camera Zero Keyframe",
         section="Validators"
     )
+    ValidateFileSaved: ValidateFileSavedModel = Field(
+        default_factory=ValidateFileSavedModel,
+        title="Validate File Saved",
+        section="Validators"
+    )
+    ValidateRenderCameraIsSet: ValidatePluginModel = Field(
+        default_factory=ValidatePluginModel,
+        title="Validate Render Camera Is Set",
+        section="Validators"
+    )
     ValidateMeshHasUvs: ValidatePluginModel = Field(
         default_factory=ValidatePluginModel,
         title="Validate Mesh Has Uvs"
@@ -118,6 +138,17 @@ DEFAULT_BLENDER_PUBLISH_SETTINGS = {
         "optional": True,
         "active": True
     },
+    "ValidateFileSaved": {
+        "enabled": True,
+        "optional": False,
+        "active": True,
+        "exclude_families": []
+    },
+    "ValidateRenderCameraIsSet": {
+        "enabled": True,
+        "optional": False,
+        "active": True
+    },
     "ValidateMeshHasUvs": {
         "enabled": True,
         "optional": True,
diff --git a/server_addon/blender/server/settings/render_settings.py b/server_addon/blender/server/settings/render_settings.py
new file mode 100644
index 0000000000..bef16328d6
--- /dev/null
+++ b/server_addon/blender/server/settings/render_settings.py
@@ -0,0 +1,106 @@
+"""Providing models and values for Blender Render Settings."""
+from pydantic import Field
+
+from ayon_server.settings import BaseSettingsModel
+
+
+def aov_separators_enum():
+    return [
+        {"value": "dash", "label": "- (dash)"},
+        {"value": "underscore", "label": "_ (underscore)"},
+        {"value": "dot", "label": ". (dot)"}
+    ]
+
+
+def image_format_enum():
+    return [
+        {"value": "exr", "label": "OpenEXR"},
+        {"value": "bmp", "label": "BMP"},
+        {"value": "rgb", "label": "Iris"},
+        {"value": "png", "label": "PNG"},
+        {"value": "jpg", "label": "JPEG"},
+        {"value": "jp2", "label": "JPEG 2000"},
+        {"value": "tga", "label": "Targa"},
+        {"value": "tif", "label": "TIFF"},
+    ]
+
+
+def aov_list_enum():
+    return [
+        {"value": "empty", "label": "< none >"},
+        {"value": "combined", "label": "Combined"},
+        {"value": "z", "label": "Z"},
+        {"value": "mist", "label": "Mist"},
+        {"value": "normal", "label": "Normal"},
+        {"value": "diffuse_light", "label": "Diffuse Light"},
+        {"value": "diffuse_color", "label": "Diffuse Color"},
+        {"value": "specular_light", "label": "Specular Light"},
+        {"value": "specular_color", "label": "Specular Color"},
+        {"value": "volume_light", "label": "Volume Light"},
+        {"value": "emission", "label": "Emission"},
+        {"value": "environment", "label": "Environment"},
+        {"value": "shadow", "label": "Shadow"},
+        {"value": "ao", "label": "Ambient Occlusion"}
+    ]
+
+
+def custom_passes_types_enum():
+    return [
+        {"value": "COLOR", "label": "Color"},
+        {"value": "VALUE", "label": "Value"},
+    ]
+
+
+class CustomPassesModel(BaseSettingsModel):
+    """Custom Passes"""
+    _layout = "compact"
+
+    attribute: str = Field("", title="Attribute name")
+    value: str = Field(
+        "Color",
+        title="Type",
+        enum_resolver=custom_passes_types_enum
+    )
+
+
+class RenderSettingsModel(BaseSettingsModel):
+    default_render_image_folder: str = Field(
+        title="Default Render Image Folder"
+    )
+    aov_separator: str = Field(
+        "underscore",
+        title="AOV Separator Character",
+        enum_resolver=aov_separators_enum
+    )
+    image_format: str = Field(
+        "exr",
+        title="Image Format",
+        enum_resolver=image_format_enum
+    )
+    multilayer_exr: bool = Field(
+        title="Multilayer (EXR)"
+    )
+    aov_list: list[str] = Field(
+        default_factory=list,
+        enum_resolver=aov_list_enum,
+        title="AOVs to create"
+    )
+    custom_passes: list[CustomPassesModel] = Field(
+        default_factory=list,
+        title="Custom Passes",
+        description=(
+            "Add custom AOVs. They are added to the view layer and in the "
+            "Compositing Nodetree,\nbut they need to be added manually to "
+            "the Shader Nodetree."
+        )
+    )
+
+
+DEFAULT_RENDER_SETTINGS = {
+    "default_render_image_folder": "renders/blender",
+    "aov_separator": "underscore",
+    "image_format": "exr",
+    "multilayer_exr": True,
+    "aov_list": [],
+    "custom_passes": []
+}
diff --git a/server_addon/blender/server/version.py b/server_addon/blender/server/version.py
index 485f44ac21..b3f4756216 100644
--- a/server_addon/blender/server/version.py
+++ b/server_addon/blender/server/version.py
@@ -1 +1 @@
-__version__ = "0.1.1"
+__version__ = "0.1.2"
diff --git a/server_addon/deadline/server/settings/publish_plugins.py b/server_addon/deadline/server/settings/publish_plugins.py
index 8d1b667345..a29caa7ba1 100644
--- a/server_addon/deadline/server/settings/publish_plugins.py
+++ b/server_addon/deadline/server/settings/publish_plugins.py
@@ -208,6 +208,16 @@ class CelactionSubmitDeadlineModel(BaseSettingsModel):
     )
 
 
+class BlenderSubmitDeadlineModel(BaseSettingsModel):
+    enabled: bool = Field(True)
+    optional: bool = Field(title="Optional")
+    active: bool = Field(title="Active")
+    use_published: bool = Field(title="Use Published scene")
+    priority: int = Field(title="Priority")
+    chunk_size: int = Field(title="Frame per Task")
+    group: str = Field("", title="Group Name")
+
+
 class AOVFilterSubmodel(BaseSettingsModel):
     _layout = "expanded"
     name: str = Field(title="Host")
@@ -276,8 +286,10 @@ class PublishPluginsModel(BaseSettingsModel):
         title="After Effects to deadline")
     CelactionSubmitDeadline: CelactionSubmitDeadlineModel = Field(
         default_factory=CelactionSubmitDeadlineModel,
-        title="Celaction Submit Deadline"
-    )
+        title="Celaction Submit Deadline")
+    BlenderSubmitDeadline: BlenderSubmitDeadlineModel = Field(
+        default_factory=BlenderSubmitDeadlineModel,
+        title="Blender Submit Deadline")
     ProcessSubmittedJobOnFarm: ProcessSubmittedJobOnFarmModel = Field(
         default_factory=ProcessSubmittedJobOnFarmModel,
         title="Process submitted job on farm.")
@@ -384,6 +396,15 @@ DEFAULT_DEADLINE_PLUGINS_SETTINGS = {
         "deadline_chunk_size": 10,
         "deadline_job_delay": "00:00:00:00"
     },
+    "BlenderSubmitDeadline": {
+        "enabled": True,
+        "optional": False,
+        "active": True,
+        "use_published": True,
+        "priority": 50,
+        "chunk_size": 10,
+        "group": "none"
+    },
     "ProcessSubmittedJobOnFarm": {
         "enabled": True,
         "deadline_department": "",

From 1ee944d03c07172d5dd6919eab7b4a974ab52369 Mon Sep 17 00:00:00 2001
From: Simone Barbieri <simone.barbieri@hey.com>
Date: Thu, 24 Aug 2023 15:33:53 +0100
Subject: [PATCH 103/366] Increase workfile version after render publish

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

diff --git a/openpype/hosts/blender/plugins/publish/increment_workfile_version.py b/openpype/hosts/blender/plugins/publish/increment_workfile_version.py
index 27fa4baf28..5f49ad7185 100644
--- a/openpype/hosts/blender/plugins/publish/increment_workfile_version.py
+++ b/openpype/hosts/blender/plugins/publish/increment_workfile_version.py
@@ -9,7 +9,8 @@ class IncrementWorkfileVersion(pyblish.api.ContextPlugin):
     label = "Increment Workfile Version"
     optional = True
     hosts = ["blender"]
-    families = ["animation", "model", "rig", "action", "layout", "blendScene"]
+    families = ["animation", "model", "rig", "action", "layout", "blendScene",
+                "renderlayer"]
 
     def process(self, context):
 

From 481e814858e9c90e4b8308707d341387cb151fd9 Mon Sep 17 00:00:00 2001
From: Simone Barbieri <simone.barbieri@hey.com>
Date: Thu, 24 Aug 2023 16:39:50 +0100
Subject: [PATCH 104/366] Save the workfile after creating the render instance

Blender, by design, doesn't set the file as dirty if modifications happen by script. So, when creating the instance and setting the render settings, the file is not marked as dirty. This means that there is the risk of sending to deadline a file without the right settings. Even the validator to check that the file is saved will detect the file as saved, even if it isn't. The only solution for now it is to force the file to be saved.
---
 .../hosts/blender/plugins/create/create_render.py     | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/openpype/hosts/blender/plugins/create/create_render.py b/openpype/hosts/blender/plugins/create/create_render.py
index 2952baafd3..62700cb55c 100644
--- a/openpype/hosts/blender/plugins/create/create_render.py
+++ b/openpype/hosts/blender/plugins/create/create_render.py
@@ -288,4 +288,15 @@ class CreateRenderlayer(plugin.Creator):
             bpy.data.collections.remove(asset_group)
             raise
 
+        # TODO: this is undesiderable, but it's the only way to be sure that
+        # the file is saved before the render starts.
+        # Blender, by design, doesn't set the file as dirty if modifications
+        # happen by script. So, when creating the instance and setting the
+        # render settings, the file is not marked as dirty. This means that
+        # there is the risk of sending to deadline a file without the right
+        # settings. Even the validator to check that the file is saved will
+        # detect the file as saved, even if it isn't. The only solution for
+        # now it is to force the file to be saved.
+        bpy.ops.wm.save_as_mainfile(filepath=bpy.data.filepath)
+
         return asset_group

From e1f2a77089f406dfa7ebb8bfc22102155f1a3f1b Mon Sep 17 00:00:00 2001
From: Mustafa-Zarkash <mustafataherzaky@outlook.com>
Date: Fri, 25 Aug 2023 22:36:38 +0300
Subject: [PATCH 105/366] Introduce houdini unreal static mesh

---
 .../create/create_unreal_staticmesh.py        |  36 +++--
 .../houdini/plugins/publish/extract_fbx.py    |   2 +-
 .../publish/validate_fbx_hierarchy_path.py    |  14 +-
 .../publish/validate_mesh_is_static.py        | 133 ++++++++++++++++++
 .../defaults/project_settings/houdini.json    |   2 +-
 .../schemas/schema_houdini_create.json        |   2 +-
 .../server/settings/publish_plugins.py        |   8 +-
 7 files changed, 169 insertions(+), 28 deletions(-)
 create mode 100644 openpype/hosts/houdini/plugins/publish/validate_mesh_is_static.py

diff --git a/openpype/hosts/houdini/plugins/create/create_unreal_staticmesh.py b/openpype/hosts/houdini/plugins/create/create_unreal_staticmesh.py
index 2a284f7979..479392f231 100644
--- a/openpype/hosts/houdini/plugins/create/create_unreal_staticmesh.py
+++ b/openpype/hosts/houdini/plugins/create/create_unreal_staticmesh.py
@@ -1,13 +1,15 @@
 # -*- coding: utf-8 -*-
-"""Creator plugin for creating fbx.
+"""Creator plugin for creating Unreal Static Meshes.
 
-It was made to pratice publish process.
+Unreal Static Meshes will be published as FBX.
 
 Filmbox by default expects an ObjNode
 however, we set the sop node explictly
 to eleminate any confusion.
 
-This creator by default will select
+This will make Filmbox to ignore any object transformations!
+
+get_obj_output selects
 the output sop with mimimum idx
 or the node with render flag isntead.
 
@@ -15,13 +17,13 @@ This plugin is part of publish process guide.
 """
 
 from openpype.hosts.houdini.api import plugin
-from openpype.lib import EnumDef
+from openpype.lib import BoolDef, EnumDef
 
 import hou
 
 
-class HouCreateUnrealStaticMesh(plugin.HoudiniCreator):
-    """Filmbox FBX Driver."""
+class CreateUnrealStaticMesh(plugin.HoudiniCreator):
+    """Unreal Static Meshes with collisions. """
 
     # you should set
     identifier = "io.openpype.creators.houdini.unrealstaticmesh"
@@ -41,7 +43,7 @@ class HouCreateUnrealStaticMesh(plugin.HoudiniCreator):
         instance_data.update({"node_type": "filmboxfbx"})
 
         # create instance (calls HoudiniCreator.create())
-        instance = super(HouCreateUnrealStaticMesh, self).create(
+        instance = super(CreateUnrealStaticMesh, self).create(
             subset_name,
             instance_data,
             pre_create_data)
@@ -78,8 +80,15 @@ class HouCreateUnrealStaticMesh(plugin.HoudiniCreator):
                            },
                            default=0,
                            label="Vertex Cache Format")
+        convert_units = BoolDef("convertunits",
+                                tooltip="When on, the FBX is converted"
+                                        "from the current Houdini "
+                                        "system units to the native "
+                                        "FBX unit of centimeters.",
+                                default=False,
+                                label="Convert Units")
 
-        return attrs + [vcformat]
+        return attrs + [vcformat, convert_units]
 
     def get_parms(self, subset_name, pre_create_data):
         """Get parameters values for this specific node."""
@@ -94,15 +103,18 @@ class HouCreateUnrealStaticMesh(plugin.HoudiniCreator):
         # 3. get Vertex Cache Format
         vcformat = pre_create_data.get("vcformat")
 
-        # 4. Valid Frame Range
-        # It should publish the current frame.
-        trange = 0
+        # 4. get convert_units
+        convertunits = pre_create_data.get("convertunits")
+
+        # 5. get Valid Frame Range
+        trange = 1
 
         # parms dictionary
         parms = {
             "startnode": selection,
             "sopoutput": output_path,
             "vcformat": vcformat,
+            "convertunits": convertunits,
             "trange": trange
         }
 
@@ -166,7 +178,7 @@ class HouCreateUnrealStaticMesh(plugin.HoudiniCreator):
 
     def get_obj_output(self, obj_node):
         """Find output node with the smallest 'outputidx'
-        or return tje node with the render flag instead.
+        or return the node with the render flag instead.
         """
 
         outputs = obj_node.subnetOutputs()
diff --git a/openpype/hosts/houdini/plugins/publish/extract_fbx.py b/openpype/hosts/houdini/plugins/publish/extract_fbx.py
index 8e45a554c0..c0e84c00c8 100644
--- a/openpype/hosts/houdini/plugins/publish/extract_fbx.py
+++ b/openpype/hosts/houdini/plugins/publish/extract_fbx.py
@@ -16,7 +16,7 @@ from openpype.hosts.houdini.api.lib import render_rop
 import hou
 
 
-class ExtractRedshiftProxy(publish.Extractor):
+class ExtractFBX(publish.Extractor):
 
     label = "Extract FBX"
     families = ["fbx"]
diff --git a/openpype/hosts/houdini/plugins/publish/validate_fbx_hierarchy_path.py b/openpype/hosts/houdini/plugins/publish/validate_fbx_hierarchy_path.py
index 01cb01f497..be73ccd223 100644
--- a/openpype/hosts/houdini/plugins/publish/validate_fbx_hierarchy_path.py
+++ b/openpype/hosts/houdini/plugins/publish/validate_fbx_hierarchy_path.py
@@ -65,8 +65,8 @@ class ValidateFBXPrimitiveHierarchyPaths(pyblish.api.InstancePlugin,
     actions = [SelectInvalidAction, AddDefaultPathAction,
                SelectROPAction]
 
-    # 'OptionalPyblishPluginMixin' where logic for 'optional' is implemented.
-    #  It requires updating project settings
+    # 'OptionalPyblishPluginMixin' adds the functionality to
+    # enable/disable plugins, It requires adding new settings.
     optional = True
 
     # overrides InstancePlugin.process()
@@ -116,13 +116,9 @@ class ValidateFBXPrimitiveHierarchyPaths(pyblish.api.InstancePlugin,
 
         cls.log.debug("Checking for attribute: %s", path_attr)
 
-        # Get frame
-        frame = hou.intFrame()
-        trange = rop_node.parm("trange").eval()
-        if trange:
-            frame = int(hou.playbar.frameRange()[0])
-
-        frame = instance.data.get("frameStart", frame)
+        # Use current frame if "frameStart" doesn't exist
+        # This only happens when ""trange" is 0
+        frame = instance.data.get("frameStart", hou.intFrame())
 
         # Get Geo at that frame
         geo = output_node.geometryAtFrame(frame)
diff --git a/openpype/hosts/houdini/plugins/publish/validate_mesh_is_static.py b/openpype/hosts/houdini/plugins/publish/validate_mesh_is_static.py
new file mode 100644
index 0000000000..fa6442d0d4
--- /dev/null
+++ b/openpype/hosts/houdini/plugins/publish/validate_mesh_is_static.py
@@ -0,0 +1,133 @@
+# -*- coding: utf-8 -*-
+"""Validate mesh is static.
+
+This plugin is part of publish process guide.
+"""
+
+import pyblish.api
+from openpype.pipeline import PublishValidationError
+from openpype.pipeline.publish import (
+    ValidateContentsOrder,
+    RepairAction,
+)
+from openpype.hosts.houdini.api.action import (
+    SelectInvalidAction,
+    SelectROPAction,
+)
+
+import hou
+
+
+# Each validation can have a single repair action
+# which calls the repair method
+class FreezeTimeAction(RepairAction):
+    label = "Freeze Time"
+    icon = "ei.pause-alt"
+
+
+class ValidateMeshIsStatic(pyblish.api.InstancePlugin):
+    """Validate mesh is static.
+
+    It checks if node is time dependant.
+    """
+
+    families = ["staticMesh"]
+    hosts = ["houdini"]
+    label = "Validate mesh is static"
+
+    # Usually you will use this value as default
+    order = ValidateContentsOrder + 0.1
+
+    # Validation can have as many actions as you want
+    # all of these actions are defined in a seperate place
+    # unlike the repair action
+    actions = [FreezeTimeAction, SelectInvalidAction,
+               SelectROPAction]
+
+    # overrides InstancePlugin.process()
+    def process(self, instance):
+        invalid = self.get_invalid(instance)
+        if invalid:
+            nodes = [n.path() for n in invalid]
+            raise PublishValidationError(
+                "See log for details. "
+                "Invalid nodes: {0}".format(nodes),
+                title=self.label
+            )
+
+    # This method was named get_invalid as a convention
+    # it's also used by SelectInvalidAction to select
+    # the returned nodes
+    @classmethod
+    def get_invalid(cls, instance):
+
+        output_node = instance.data.get("output_node")
+        if output_node.isTimeDependent():
+            cls.log.info("Mesh is not static!")
+            return [output_node]
+
+
+
+    # what repair action expects to find and call
+    @classmethod
+    def repair(cls, instance):
+        """Adds a time shift node.
+
+        It should kill time dependency.
+        """
+
+        rop_node = hou.node(instance.data["instance_node"])
+        # I'm doing so because an artist may change output node
+        # before clicking the button.
+        output_node = rop_node.parm("startnode").evalAsNode()
+
+        if not output_node:
+            cls.log.debug(
+                "Action isn't performed, invalid SOP Path on %s",
+                rop_node
+            )
+            return
+
+        # This check to prevent the action from running multiple times.
+        # git_invalid only returns [output_node] when
+        #   path attribute is the problem
+        if cls.get_invalid(instance) != [output_node]:
+            return
+
+
+
+        time_shift = output_node.parent().createNode("timeshift",
+                                                     "freeze_time")
+        time_shift.parm("frame").deleteAllKeyframes()
+
+        frame = instance.data.get("frameStart", hou.intFrame())
+        time_shift.parm("frame").set(frame)
+
+        cls.log.debug(
+            "'%s' was created. It will kill time dependency."
+            , time_shift
+        )
+
+        time_shift.setGenericFlag(hou.nodeFlag.DisplayComment, True)
+        time_shift.setComment(
+            'This node was created automatically by '
+            '"Freeze Time" Action'
+            '\nFeel free to modify or replace it.'
+        )
+
+        if output_node.type().name() in ["null", "output"]:
+            # Connect before
+            time_shift.setFirstInput(output_node.input(0))
+            time_shift.moveToGoodPosition()
+            output_node.setFirstInput(time_shift)
+            output_node.moveToGoodPosition()
+        else:
+            # Connect after
+            time_shift.setFirstInput(output_node)
+            rop_node.parm("startnode").set(time_shift.path())
+            time_shift.moveToGoodPosition()
+
+            cls.log.debug(
+                "SOP path on '%s' updated to new output node '%s'",
+                rop_node, time_shift
+            )
diff --git a/openpype/settings/defaults/project_settings/houdini.json b/openpype/settings/defaults/project_settings/houdini.json
index e19e71de17..c39eb717fd 100644
--- a/openpype/settings/defaults/project_settings/houdini.json
+++ b/openpype/settings/defaults/project_settings/houdini.json
@@ -19,7 +19,7 @@
             ],
             "ext": ".ass"
         },
-        "HouCreateUnrealStaticMesh": {
+        "CreateUnrealStaticMesh": {
             "enabled": true,
             "default_variants": [
                 "Main"
diff --git a/openpype/settings/entities/schemas/projects_schema/schemas/schema_houdini_create.json b/openpype/settings/entities/schemas/projects_schema/schemas/schema_houdini_create.json
index 3d55bd834f..b19761df91 100644
--- a/openpype/settings/entities/schemas/projects_schema/schemas/schema_houdini_create.json
+++ b/openpype/settings/entities/schemas/projects_schema/schemas/schema_houdini_create.json
@@ -42,7 +42,7 @@
         {
             "type": "dict",
             "collapsible": true,
-            "key": "HouCreateUnrealStaticMesh",
+            "key": "CreateUnrealStaticMesh",
             "label": "Create Unreal - Static Mesh",
             "checkbox_key": "enabled",
             "children": [
diff --git a/server_addon/houdini/server/settings/publish_plugins.py b/server_addon/houdini/server/settings/publish_plugins.py
index aaa1d0ba1d..1e5cd7f551 100644
--- a/server_addon/houdini/server/settings/publish_plugins.py
+++ b/server_addon/houdini/server/settings/publish_plugins.py
@@ -21,7 +21,7 @@ class CreateArnoldAssModel(BaseSettingsModel):
     ext: str = Field(Title="Extension")
 
 
-class HouCreateUnrealStaticMeshModel(BaseSettingsModel):
+class CreateUnrealStaticMeshModel(BaseSettingsModel):
     enabled: bool = Field(title="Enabled")
     default_variants: list[str] = Field(
         default_factory=list,
@@ -39,8 +39,8 @@ class CreatePluginsModel(BaseSettingsModel):
         default_factory=CreateArnoldAssModel,
         title="Create Alembic Camera")
     # "-" is not compatible in the new model
-    HouCreateUnrealStaticMesh: HouCreateUnrealStaticMeshModel = Field(
-        default_factory=HouCreateUnrealStaticMeshModel,
+    CreateUnrealStaticMesh: CreateUnrealStaticMeshModel = Field(
+        default_factory=CreateUnrealStaticMeshModel,
         title="Create Unreal_Static Mesh"
     )
     CreateAlembicCamera: CreatorModel = Field(
@@ -81,7 +81,7 @@ DEFAULT_HOUDINI_CREATE_SETTINGS = {
         "default_variants": ["Main"],
         "ext": ".ass"
     },
-    "HouCreateUnrealStaticMesh": {
+    "CreateUnrealStaticMesh": {
         "enabled": True,
         "default_variants": [
             "Main"

From 3d658bb3f23aa9bf50f0a46a62f810b01bc06139 Mon Sep 17 00:00:00 2001
From: Mustafa-Zarkash <mustafataherzaky@outlook.com>
Date: Fri, 25 Aug 2023 22:39:10 +0300
Subject: [PATCH 106/366] resolve hound conversations

---
 .../houdini/plugins/publish/validate_mesh_is_static.py    | 8 ++------
 1 file changed, 2 insertions(+), 6 deletions(-)

diff --git a/openpype/hosts/houdini/plugins/publish/validate_mesh_is_static.py b/openpype/hosts/houdini/plugins/publish/validate_mesh_is_static.py
index fa6442d0d4..ac80fda537 100644
--- a/openpype/hosts/houdini/plugins/publish/validate_mesh_is_static.py
+++ b/openpype/hosts/houdini/plugins/publish/validate_mesh_is_static.py
@@ -66,8 +66,6 @@ class ValidateMeshIsStatic(pyblish.api.InstancePlugin):
             cls.log.info("Mesh is not static!")
             return [output_node]
 
-
-
     # what repair action expects to find and call
     @classmethod
     def repair(cls, instance):
@@ -94,8 +92,6 @@ class ValidateMeshIsStatic(pyblish.api.InstancePlugin):
         if cls.get_invalid(instance) != [output_node]:
             return
 
-
-
         time_shift = output_node.parent().createNode("timeshift",
                                                      "freeze_time")
         time_shift.parm("frame").deleteAllKeyframes()
@@ -104,8 +100,8 @@ class ValidateMeshIsStatic(pyblish.api.InstancePlugin):
         time_shift.parm("frame").set(frame)
 
         cls.log.debug(
-            "'%s' was created. It will kill time dependency."
-            , time_shift
+            "'%s' was created. It will kill time dependency.",
+            time_shift
         )
 
         time_shift.setGenericFlag(hou.nodeFlag.DisplayComment, True)

From c610a850b9e12023b2a6e5f92769b2a971b7b2d1 Mon Sep 17 00:00:00 2001
From: Mustafa-Zarkash <mustafataherzaky@outlook.com>
Date: Sat, 26 Aug 2023 01:23:20 +0300
Subject: [PATCH 107/366] dynamic subset name

---
 .../plugins/create/create_unreal_staticmesh.py     | 14 ++++++++++++++
 .../settings/defaults/project_settings/global.json |  3 ++-
 server_addon/core/server/settings/tools.py         |  3 ++-
 3 files changed, 18 insertions(+), 2 deletions(-)

diff --git a/openpype/hosts/houdini/plugins/create/create_unreal_staticmesh.py b/openpype/hosts/houdini/plugins/create/create_unreal_staticmesh.py
index 479392f231..179c81510a 100644
--- a/openpype/hosts/houdini/plugins/create/create_unreal_staticmesh.py
+++ b/openpype/hosts/houdini/plugins/create/create_unreal_staticmesh.py
@@ -90,6 +90,20 @@ class CreateUnrealStaticMesh(plugin.HoudiniCreator):
 
         return attrs + [vcformat, convert_units]
 
+    # Overrides BaseCreator.get_dynamic_data()
+    def get_dynamic_data(
+        self, variant, task_name, asset_doc, project_name, host_name, instance
+    ):
+        """
+        The default subset name templates for Unreal include {asset} and thus
+        we should pass that along as dynamic data.
+        """
+        dynamic_data = super(CreateUnrealStaticMesh, self).get_dynamic_data(
+            variant, task_name, asset_doc, project_name, host_name, instance
+        )
+        dynamic_data["asset"] = asset_doc["name"]
+        return dynamic_data
+
     def get_parms(self, subset_name, pre_create_data):
         """Get parameters values for this specific node."""
 
diff --git a/openpype/settings/defaults/project_settings/global.json b/openpype/settings/defaults/project_settings/global.json
index 06a595d1c5..52ac745f6d 100644
--- a/openpype/settings/defaults/project_settings/global.json
+++ b/openpype/settings/defaults/project_settings/global.json
@@ -429,7 +429,8 @@
                         "staticMesh"
                     ],
                     "hosts": [
-                        "maya"
+                        "maya",
+                        "houdini"
                     ],
                     "task_types": [],
                     "tasks": [],
diff --git a/server_addon/core/server/settings/tools.py b/server_addon/core/server/settings/tools.py
index 7befc795e4..5dbe6ab215 100644
--- a/server_addon/core/server/settings/tools.py
+++ b/server_addon/core/server/settings/tools.py
@@ -370,7 +370,8 @@ DEFAULT_TOOLS_VALUES = {
                     "staticMesh"
                 ],
                 "hosts": [
-                    "maya"
+                    "maya",
+                    "houdini"
                 ],
                 "task_types": [],
                 "tasks": [],

From 3a43806a5b30496c44b0adb469f1b1a52355b66d Mon Sep 17 00:00:00 2001
From: Mustafa-Zarkash <mustafataherzaky@outlook.com>
Date: Sat, 26 Aug 2023 01:23:52 +0300
Subject: [PATCH 108/366] dynamic subset name

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

diff --git a/server_addon/core/server/version.py b/server_addon/core/server/version.py
index 485f44ac21..b3f4756216 100644
--- a/server_addon/core/server/version.py
+++ b/server_addon/core/server/version.py
@@ -1 +1 @@
-__version__ = "0.1.1"
+__version__ = "0.1.2"

From 44d8327aa9c92246c3aec2e588034bad9d83c27c Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Mon, 28 Aug 2023 12:43:28 +0200
Subject: [PATCH 109/366] adding deprecated decorators

---
 openpype/pipeline/colorspace.py | 53 ++++++++++++++++++++++++++++++++-
 1 file changed, 52 insertions(+), 1 deletion(-)

diff --git a/openpype/pipeline/colorspace.py b/openpype/pipeline/colorspace.py
index 02a6b90f25..c90fb299f9 100644
--- a/openpype/pipeline/colorspace.py
+++ b/openpype/pipeline/colorspace.py
@@ -2,9 +2,12 @@ from copy import deepcopy
 import re
 import os
 import json
-import platform
 import contextlib
+import functools
+import platform
 import tempfile
+import warnings
+
 from openpype import PACKAGE_DIR
 from openpype.settings import get_project_settings
 from openpype.lib import (
@@ -22,6 +25,51 @@ class CashedData:
     python3compatible = None
 
 
+class DeprecatedWarning(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", DeprecatedWarning)
+            warnings.warn(
+                (
+                    "Call to deprecated function '{}'"
+                    "\nFunction was moved or removed.{}"
+                ).format(decorated_func.__name__, warning_message),
+                category=DeprecatedWarning,
+                stacklevel=4
+            )
+            return decorated_func(*args, **kwargs)
+        return wrapper
+
+    if func is None:
+        return _decorator
+    return _decorator(func)
+
+
 @contextlib.contextmanager
 def _make_temp_json_file():
     """Wrapping function for json temp file
@@ -252,6 +300,7 @@ def validate_imageio_colorspace_in_config(config_path, colorspace_name):
 
 
 # TODO: remove this in future - backward compatibility
+@deprecated("get_wrapped_with_subprocess")
 def get_data_subprocess(config_path, data_type):
     """[Deprecated] Get data via subprocess
 
@@ -386,6 +435,7 @@ def get_ocio_config_colorspaces(config_path):
 
 
 # TODO: remove this in future - backward compatibility
+@deprecated("get_wrapped_with_subprocess")
 def get_colorspace_data_subprocess(config_path):
     """[Deprecated] Get colorspace data via subprocess
 
@@ -427,6 +477,7 @@ def get_ocio_config_views(config_path):
 
 
 # TODO: remove this in future - backward compatibility
+@deprecated("get_wrapped_with_subprocess")
 def get_views_data_subprocess(config_path):
     """[Deprecated] Get viewers data via subprocess
 

From 1157971186c8b364afa03a6081246b8bca41abb9 Mon Sep 17 00:00:00 2001
From: Kayla Man <moonyuet2008@hotmail.com>
Date: Mon, 28 Aug 2023 18:55:49 +0800
Subject: [PATCH 110/366] ornatrix is a fur modifier so no loading model for
 ornatrix abc

---
 .../max/plugins/load/load_model_ornatrix.py   | 78 -------------------
 1 file changed, 78 deletions(-)
 delete mode 100644 openpype/hosts/max/plugins/load/load_model_ornatrix.py

diff --git a/openpype/hosts/max/plugins/load/load_model_ornatrix.py b/openpype/hosts/max/plugins/load/load_model_ornatrix.py
deleted file mode 100644
index 07633ec55d..0000000000
--- a/openpype/hosts/max/plugins/load/load_model_ornatrix.py
+++ /dev/null
@@ -1,78 +0,0 @@
-import os
-from openpype.pipeline import load, get_representation_path
-from openpype.hosts.max.api.pipeline import containerise
-from openpype.hosts.max.api import lib
-
-
-class OxModelAbcLoader(load.LoaderPlugin):
-    """Loading model with the Ornatrix Alembic loader."""
-
-    families = ["model"]
-    label = "Load Model with Ornatrix Alembic"
-    representations = ["abc"]
-    order = -10
-    icon = "code-fork"
-    color = "orange"
-
-    def load(self, context, name=None, namespace=None, data=None):
-        from pymxs import runtime as rt
-
-        file_path = os.path.normpath(self.filepath_from_context(context))
-        scene_object_before = [obj for obj in rt.rootNode.Children]
-        rt.AlembicImport.ImportToRoot = True
-        rt.AlembicImport.CustomAttributes = True
-        rt.AlembicImport.UVs = True
-        rt.AlembicImport.VertexColors = True
-        rt.importFile(
-            file_path, rt.name("noPrompt"),
-            using=rt.Ornatrix_Alembic_Importer)
-        scene_object_after = [obj for obj in rt.rootNode.Children]
-        for scene_object in scene_object_before:
-            scene_object_after = scene_object_after.remove(scene_object)
-
-        abc_container = rt.Container(name=name)
-        for abc in scene_object_after:
-            abc.Parent = abc_container
-
-        return containerise(
-            name, [abc_container], context, loader=self.__class__.__name__
-        )
-
-    def update(self, container, representation):
-        from pymxs import runtime as rt
-
-        path = get_representation_path(representation)
-        node_name = container["instance_node"]
-        instance_name, _ = os.path.splitext(node_name)
-        container = rt.getNodeByName(instance_name)
-        for children in container.Children:
-            rt.Delete(children)
-
-        scene_object_before = [obj for obj in rt.rootNode.Children]
-        rt.AlembicImport.ImportToRoot = True
-        rt.AlembicImport.CustomAttributes = True
-        rt.AlembicImport.UVs = True
-        rt.AlembicImport.VertexColors = True
-        rt.importFile(
-            path, rt.name("noPrompt"),
-            using=rt.Ornatrix_Alembic_Importer)
-        scene_object_after = [obj for obj in rt.rootNode.Children]
-        for scene_object in scene_object_before:
-            scene_object_after = scene_object_after.remove(scene_object)
-
-        for scene_object in scene_object_after:
-            scene_object.Parent = container
-
-        lib.imprint(
-            container["instance_node"],
-            {"representation": str(representation["_id"])},
-        )
-
-    def switch(self, container, representation):
-        self.update(container, representation)
-
-    def remove(self, container):
-        from pymxs import runtime as rt
-
-        node = rt.GetNodeByName(container["instance_node"])
-        rt.Delete(node)

From c2212a6cc111f9499b41701dcbad0e1b5809ae07 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Mon, 28 Aug 2023 13:21:24 +0200
Subject: [PATCH 111/366] revert unreal submodule

---
 openpype/hosts/unreal/integration | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/hosts/unreal/integration b/openpype/hosts/unreal/integration
index ff15c70077..63266607ce 160000
--- a/openpype/hosts/unreal/integration
+++ b/openpype/hosts/unreal/integration
@@ -1 +1 @@
-Subproject commit ff15c700771e719cc5f3d561ac5d6f7590623986
+Subproject commit 63266607ceb972a61484f046634ddfc9eb0b5757

From e10ca74b1b93ddebb9786b04e22dde1d6de137c4 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Mon, 28 Aug 2023 14:00:52 +0200
Subject: [PATCH 112/366] changing signature of
 `parse_colorspace_from_filepath`

---
 openpype/pipeline/colorspace.py               | 47 ++++++++++---------
 .../unit/openpype/pipeline/test_colorspace.py |  4 +-
 2 files changed, 27 insertions(+), 24 deletions(-)

diff --git a/openpype/pipeline/colorspace.py b/openpype/pipeline/colorspace.py
index c90fb299f9..9ea9d1f888 100644
--- a/openpype/pipeline/colorspace.py
+++ b/openpype/pipeline/colorspace.py
@@ -171,8 +171,6 @@ def get_imageio_colorspace_from_filepath(
     # from filepath with OCIO v2 way
     # QUESTION: should we override file rules from our settings and
     #           in ocio v2 only focus on file rules set in config file?
-    # TODO: do the ocio v compatibility check inside of wrapper script
-    #       because of implementation `parseColorSpaceFromString`
     if (
         compatibility_check_config_version(config_data["path"], major=2)
         and not colorspace_name
@@ -226,51 +224,56 @@ def get_colorspace_from_filepath(config_path, filepath):
 
 
 def parse_colorspace_from_filepath(
-    path, host_name, project_name,
-    config_data=None,
-    project_settings=None
+    filepath, colorspaces=None, config_path=None
 ):
-    """Parse colorspace name from filepath
+    """Parse colorspace name from list of filepaths
 
     An input path can have colorspace name used as part of name
     or as folder name.
 
+    # add example python code block
+
+    Example:
+        >>> config_path = "path/to/config.ocio"
+        >>> colorspaces = get_ocio_config_colorspaces(config_path)
+        >>> colorspace = parse_colorspace_from_filepath(
+                "path/to/file/acescg/file.exr",
+                colorspaces=colorspaces
+            )
+        >>> print(colorspace)
+        acescg
+
     Args:
-        path (str): path string
-        host_name (str): host name
-        project_name (str): project name
-        config_data (dict, optional): config path and template in dict.
-                                      Defaults to None.
-        project_settings (dict, optional): project settings. Defaults to None.
+        filepath (str): path string
+        colorspaces (Optional[dict[str]]): list of colorspaces
+        config_path (Optional[str]): path to config.ocio file
 
     Returns:
         str: name of colorspace
     """
-    if not config_data:
-        project_settings = project_settings or get_project_settings(
-            project_name
+    if not colorspaces and not config_path:
+        raise ValueError(
+            "You need to provide `config_path` if you don't "
+            "want to provide input `colorspaces`."
         )
-        config_data = get_imageio_config(
-            project_name, host_name, project_settings)
 
-    config_path = config_data["path"]
+    colorspaces = colorspaces or get_ocio_config_colorspaces(config_path)
 
     # match file rule from path
     colorspace_name = None
-    colorspaces = get_ocio_config_colorspaces(config_path)
     for colorspace_key in colorspaces:
         # check underscored variant of colorspace name
         # since we are reformatting it in integrate.py
-        if colorspace_key.replace(" ", "_") in path:
+        if colorspace_key.replace(" ", "_") in filepath:
             colorspace_name = colorspace_key
             break
-        if colorspace_key in path:
+        if colorspace_key in filepath:
             colorspace_name = colorspace_key
             break
 
     if not colorspace_name:
         log.info("No matching colorspace in config '{}' for path: '{}'".format(
-            config_path, path
+            config_path, filepath
         ))
         return None
 
diff --git a/tests/unit/openpype/pipeline/test_colorspace.py b/tests/unit/openpype/pipeline/test_colorspace.py
index e63ca510f2..8ae98f7cf8 100644
--- a/tests/unit/openpype/pipeline/test_colorspace.py
+++ b/tests/unit/openpype/pipeline/test_colorspace.py
@@ -132,14 +132,14 @@ class TestPipelineColorspace(TestPipeline):
         path_1 = "renderCompMain_ACES2065-1.####.exr"
         expected_1 = "ACES2065-1"
         ret_1 = colorspace.parse_colorspace_from_filepath(
-            path_1, "nuke", "test_project", project_settings=project_settings
+            path_1, config_path=config_path_asset
         )
         assert ret_1 == expected_1, f"Not matching colorspace {expected_1}"
 
         path_2 = "renderCompMain_BMDFilm_WideGamut_Gen5.mov"
         expected_2 = "BMDFilm WideGamut Gen5"
         ret_2 = colorspace.parse_colorspace_from_filepath(
-            path_2, "nuke", "test_project", project_settings=project_settings
+            path_2, config_path=config_path_asset
         )
         assert ret_2 == expected_2, f"Not matching colorspace {expected_2}"
 

From c99aa746a2d63b092593fd24f0cda9caa397cd50 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Mon, 28 Aug 2023 14:01:36 +0200
Subject: [PATCH 113/366] docstring update

---
 openpype/pipeline/colorspace.py | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/openpype/pipeline/colorspace.py b/openpype/pipeline/colorspace.py
index 9ea9d1f888..e675bdb2e1 100644
--- a/openpype/pipeline/colorspace.py
+++ b/openpype/pipeline/colorspace.py
@@ -226,13 +226,11 @@ def get_colorspace_from_filepath(config_path, filepath):
 def parse_colorspace_from_filepath(
     filepath, colorspaces=None, config_path=None
 ):
-    """Parse colorspace name from list of filepaths
+    """Parse colorspace name from filepath
 
     An input path can have colorspace name used as part of name
     or as folder name.
 
-    # add example python code block
-
     Example:
         >>> config_path = "path/to/config.ocio"
         >>> colorspaces = get_ocio_config_colorspaces(config_path)

From ba237487a65176f2ee58e08533c65115b5a9c19d Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Mon, 28 Aug 2023 15:53:36 +0200
Subject: [PATCH 114/366] cashing OCIO config version data

---
 openpype/pipeline/colorspace.py | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

diff --git a/openpype/pipeline/colorspace.py b/openpype/pipeline/colorspace.py
index e675bdb2e1..30bd685b13 100644
--- a/openpype/pipeline/colorspace.py
+++ b/openpype/pipeline/colorspace.py
@@ -23,6 +23,7 @@ log = Logger.get_logger(__name__)
 class CashedData:
     remapping = None
     python3compatible = None
+    config_version_data = None
 
 
 class DeprecatedWarning(DeprecationWarning):
@@ -395,16 +396,17 @@ def compatibility_check_config_version(config_path, major=1, minor=None):
             "config", "get_version", config_path=config_path
         )
 
-    from openpype.scripts.ocio_wrapper import _get_version_data
+    if not CashedData.config_version_data:
+        from openpype.scripts.ocio_wrapper import _get_version_data
 
-    version_data = _get_version_data(config_path)
+        CashedData.config_version_data = _get_version_data(config_path)
 
     # check major version
-    if version_data["major"] != major:
+    if CashedData.config_version_data["major"] != major:
         return False
 
     # check minor version
-    if minor and version_data["minor"] != minor:
+    if minor and CashedData.config_version_data["minor"] != minor:
         return False
 
     # compatible

From 06930318c2762b0f80d60ef07dd3d38a79e7b318 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Mon, 28 Aug 2023 16:01:25 +0200
Subject: [PATCH 115/366] fixing logic of the cashing

---
 openpype/pipeline/colorspace.py | 20 +++++++++++---------
 1 file changed, 11 insertions(+), 9 deletions(-)

diff --git a/openpype/pipeline/colorspace.py b/openpype/pipeline/colorspace.py
index 30bd685b13..c1dc47245a 100644
--- a/openpype/pipeline/colorspace.py
+++ b/openpype/pipeline/colorspace.py
@@ -389,17 +389,19 @@ def compatibility_check():
 def compatibility_check_config_version(config_path, major=1, minor=None):
     """Making sure PyOpenColorIO config version is compatible"""
 
-    if not compatibility_check():
-        # python environment is not compatible with PyOpenColorIO
-        # needs to be run in subprocess
-        version_data = get_wrapped_with_subprocess(
-            "config", "get_version", config_path=config_path
-        )
-
     if not CashedData.config_version_data:
-        from openpype.scripts.ocio_wrapper import _get_version_data
+        if compatibility_check():
+            from openpype.scripts.ocio_wrapper import _get_version_data
+
+            CashedData.config_version_data = _get_version_data(config_path)
+
+        else:
+            # python environment is not compatible with PyOpenColorIO
+            # needs to be run in subprocess
+            CashedData.config_version_data = get_wrapped_with_subprocess(
+                "config", "get_version", config_path=config_path
+            )
 
-        CashedData.config_version_data = _get_version_data(config_path)
 
     # check major version
     if CashedData.config_version_data["major"] != major:

From 6a36d713139ccd4e21b44c0c247a6adda236c863 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Mon, 28 Aug 2023 16:26:36 +0200
Subject: [PATCH 116/366] adding colorspace parsing form filepath as fallback

---
 openpype/pipeline/colorspace.py | 10 +++++++---
 1 file changed, 7 insertions(+), 3 deletions(-)

diff --git a/openpype/pipeline/colorspace.py b/openpype/pipeline/colorspace.py
index c1dc47245a..eb3c4c3b94 100644
--- a/openpype/pipeline/colorspace.py
+++ b/openpype/pipeline/colorspace.py
@@ -170,8 +170,6 @@ def get_imageio_colorspace_from_filepath(
 
     # if no file rule matched, try to get colorspace
     # from filepath with OCIO v2 way
-    # QUESTION: should we override file rules from our settings and
-    #           in ocio v2 only focus on file rules set in config file?
     if (
         compatibility_check_config_version(config_data["path"], major=2)
         and not colorspace_name
@@ -179,6 +177,11 @@ def get_imageio_colorspace_from_filepath(
         colorspace_name = get_colorspace_from_filepath(
             config_data["path"], path)
 
+    # use parse colorspace from filepath as fallback
+    colorspace_name = colorspace_name or parse_colorspace_from_filepath(
+        path, config_path=config_data["path"]
+    )
+
     if not colorspace_name:
         log.info("No imageio file rule matched input path: '{}'".format(
             path
@@ -196,7 +199,8 @@ def get_imageio_colorspace_from_filepath(
 def get_colorspace_from_filepath(config_path, filepath):
     """Get colorspace from file path wrapper.
 
-    Wrapper function for getting colorspace from file path.
+    Wrapper function for getting colorspace from file path
+    with use of OCIO v2 file-rules.
 
     Args:
         config_path (str): path leading to config.ocio file

From 7bb23b1bc0d7af7e6260d135a1ef9c77c0f35810 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Mon, 28 Aug 2023 16:35:03 +0200
Subject: [PATCH 117/366] utilising Cache for config colorspaces

---
 openpype/pipeline/colorspace.py | 25 ++++++++++++++++---------
 1 file changed, 16 insertions(+), 9 deletions(-)

diff --git a/openpype/pipeline/colorspace.py b/openpype/pipeline/colorspace.py
index eb3c4c3b94..70b82d6be2 100644
--- a/openpype/pipeline/colorspace.py
+++ b/openpype/pipeline/colorspace.py
@@ -24,6 +24,7 @@ class CashedData:
     remapping = None
     python3compatible = None
     config_version_data = None
+    ocio_config_colorspaces = {}
 
 
 class DeprecatedWarning(DeprecationWarning):
@@ -155,7 +156,7 @@ def get_imageio_colorspace_from_filepath(
 
     # match file rule from path
     colorspace_name = None
-    for _frule_name, file_rule in file_rules.items():
+    for _, file_rule in file_rules.items():
         pattern = file_rule["pattern"]
         extension = file_rule["ext"]
         ext_match = re.match(
@@ -431,16 +432,22 @@ def get_ocio_config_colorspaces(config_path):
     Returns:
         dict: colorspace and family in couple
     """
-    if not compatibility_check():
-        # python environment is not compatible with PyOpenColorIO
-        # needs to be run in subprocess
-        return get_wrapped_with_subprocess(
-            "config", "get_colorspace", in_path=config_path
-        )
+    if not CashedData.ocio_config_colorspaces.get(config_path):
+        if not compatibility_check():
+            # python environment is not compatible with PyOpenColorIO
+            # needs to be run in subprocess
+            CashedData.ocio_config_colorspaces[config_path] = \
+                get_wrapped_with_subprocess(
+                    "config", "get_colorspace", in_path=config_path
+            )
+        else:
+            from openpype.scripts.ocio_wrapper import _get_colorspace_data
 
-    from openpype.scripts.ocio_wrapper import _get_colorspace_data
+            CashedData.ocio_config_colorspaces[config_path] = \
+                _get_colorspace_data(config_path)
+
+    return CashedData.ocio_config_colorspaces[config_path]
 
-    return _get_colorspace_data(config_path)
 
 
 # TODO: remove this in future - backward compatibility

From ab872146a9bc52068dd4abb6c009160e1a79120c Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Mon, 28 Aug 2023 16:36:01 +0200
Subject: [PATCH 118/366] removing line

---
 openpype/pipeline/colorspace.py | 1 -
 1 file changed, 1 deletion(-)

diff --git a/openpype/pipeline/colorspace.py b/openpype/pipeline/colorspace.py
index 70b82d6be2..8378da5b98 100644
--- a/openpype/pipeline/colorspace.py
+++ b/openpype/pipeline/colorspace.py
@@ -449,7 +449,6 @@ def get_ocio_config_colorspaces(config_path):
     return CashedData.ocio_config_colorspaces[config_path]
 
 
-
 # TODO: remove this in future - backward compatibility
 @deprecated("get_wrapped_with_subprocess")
 def get_colorspace_data_subprocess(config_path):

From b60043e94589b0a1dfdb7853deb6560b5255827b Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Mon, 28 Aug 2023 16:38:34 +0200
Subject: [PATCH 119/366] hound

---
 openpype/pipeline/colorspace.py | 1 -
 1 file changed, 1 deletion(-)

diff --git a/openpype/pipeline/colorspace.py b/openpype/pipeline/colorspace.py
index 8378da5b98..1251308eb3 100644
--- a/openpype/pipeline/colorspace.py
+++ b/openpype/pipeline/colorspace.py
@@ -407,7 +407,6 @@ def compatibility_check_config_version(config_path, major=1, minor=None):
                 "config", "get_version", config_path=config_path
             )
 
-
     # check major version
     if CashedData.config_version_data["major"] != major:
         return False

From 749e8911f5f1a8ce00ce8e3d024004d3fb13c832 Mon Sep 17 00:00:00 2001
From: Kayla Man <moonyuet2008@hotmail.com>
Date: Mon, 28 Aug 2023 23:20:43 +0800
Subject: [PATCH 120/366] make sure ornatrix loader would raise runtime error
 if the user doesn't have the plugin installed

---
 .../plugins/load/load_pointcache_ornatrix.py  | 23 ++++++++++++++-----
 1 file changed, 17 insertions(+), 6 deletions(-)

diff --git a/openpype/hosts/max/plugins/load/load_pointcache_ornatrix.py b/openpype/hosts/max/plugins/load/load_pointcache_ornatrix.py
index f783583ff1..1dce9aaa65 100644
--- a/openpype/hosts/max/plugins/load/load_pointcache_ornatrix.py
+++ b/openpype/hosts/max/plugins/load/load_pointcache_ornatrix.py
@@ -2,7 +2,7 @@ import os
 from openpype.pipeline import load, get_representation_path
 from openpype.hosts.max.api.pipeline import containerise
 from openpype.hosts.max.api import lib
-
+from pymxs import runtime as rt
 
 class OxAbcLoader(load.LoaderPlugin):
     """Ornatrix Alembic loader."""
@@ -15,7 +15,10 @@ class OxAbcLoader(load.LoaderPlugin):
     color = "orange"
 
     def load(self, context, name=None, namespace=None, data=None):
-        from pymxs import runtime as rt
+        plugin_list = get_plugins()
+        if "ornatrix.dlo" not in plugin_list:
+            raise RuntimeError("Ornatrix plugin not "
+                               "found/installed in Max yet..")
 
         file_path = os.path.normpath(self.filepath_from_context(context))
         scene_object_before = [obj for obj in rt.rootNode.Children]
@@ -37,8 +40,6 @@ class OxAbcLoader(load.LoaderPlugin):
         )
 
     def update(self, container, representation):
-        from pymxs import runtime as rt
-
         path = get_representation_path(representation)
         node_name = container["instance_node"]
         instance_name, _ = os.path.splitext(node_name)
@@ -68,7 +69,17 @@ class OxAbcLoader(load.LoaderPlugin):
         self.update(container, representation)
 
     def remove(self, container):
-        from pymxs import runtime as rt
-
         node = rt.GetNodeByName(container["instance_node"])
         rt.Delete(node)
+
+
+def get_plugins() -> list:
+    """Get plugin list from 3ds max."""
+    manager = rt.PluginManager
+    count = manager.pluginDllCount
+    plugin_info_list = []
+    for p in range(1, count + 1):
+        plugin_info = manager.pluginDllName(p)
+        plugin_info_list.append(plugin_info)
+
+    return plugin_info_list

From d92f2bac2f0c4115500d48b3223f65eb7c052e7f Mon Sep 17 00:00:00 2001
From: Kayla Man <moonyuet2008@hotmail.com>
Date: Mon, 28 Aug 2023 23:21:54 +0800
Subject: [PATCH 121/366] hound

---
 openpype/hosts/max/plugins/load/load_pointcache_ornatrix.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/openpype/hosts/max/plugins/load/load_pointcache_ornatrix.py b/openpype/hosts/max/plugins/load/load_pointcache_ornatrix.py
index 1dce9aaa65..5f7e0a05f8 100644
--- a/openpype/hosts/max/plugins/load/load_pointcache_ornatrix.py
+++ b/openpype/hosts/max/plugins/load/load_pointcache_ornatrix.py
@@ -4,6 +4,7 @@ from openpype.hosts.max.api.pipeline import containerise
 from openpype.hosts.max.api import lib
 from pymxs import runtime as rt
 
+
 class OxAbcLoader(load.LoaderPlugin):
     """Ornatrix Alembic loader."""
 

From ad6d03cedae5c5b7bf8ed3ea8261383045f9383d Mon Sep 17 00:00:00 2001
From: Kayla Man <moonyuet2008@hotmail.com>
Date: Tue, 29 Aug 2023 17:30:15 +0800
Subject: [PATCH 122/366] fix the playbacktype

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

diff --git a/openpype/hosts/max/plugins/load/load_pointcache.py b/openpype/hosts/max/plugins/load/load_pointcache.py
index f250377cfd..3f8b241351 100644
--- a/openpype/hosts/max/plugins/load/load_pointcache.py
+++ b/openpype/hosts/max/plugins/load/load_pointcache.py
@@ -52,7 +52,7 @@ class AbcLoader(load.LoaderPlugin):
 
         for abc in rt.GetCurrentSelection():
             for cam_shape in abc.Children:
-                cam_shape.playbackType = 2
+                cam_shape.playbackType = 0
 
         return containerise(
             name, [abc_container], context, loader=self.__class__.__name__

From 42d0b19b46d6c30e18b9dbaee00bba87fc7ea5fc Mon Sep 17 00:00:00 2001
From: Kayla Man <moonyuet2008@hotmail.com>
Date: Tue, 29 Aug 2023 17:37:12 +0800
Subject: [PATCH 123/366] add correct plugin name

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

diff --git a/openpype/hosts/max/plugins/load/load_pointcache_ornatrix.py b/openpype/hosts/max/plugins/load/load_pointcache_ornatrix.py
index 5f7e0a05f8..a3c9d94f83 100644
--- a/openpype/hosts/max/plugins/load/load_pointcache_ornatrix.py
+++ b/openpype/hosts/max/plugins/load/load_pointcache_ornatrix.py
@@ -17,7 +17,7 @@ class OxAbcLoader(load.LoaderPlugin):
 
     def load(self, context, name=None, namespace=None, data=None):
         plugin_list = get_plugins()
-        if "ornatrix.dlo" not in plugin_list:
+        if "ephere.plugins.autodesk.max.ornatrix.dlo" not in plugin_list:
             raise RuntimeError("Ornatrix plugin not "
                                "found/installed in Max yet..")
 

From 7be680190f0cf97da06e02747b4a4c8ea9ff46fc Mon Sep 17 00:00:00 2001
From: Kayla Man <moonyuet2008@hotmail.com>
Date: Wed, 30 Aug 2023 17:29:53 +0800
Subject: [PATCH 124/366] bug fix on the ornatrix loader

---
 .../plugins/load/load_pointcache_ornatrix.py  | 26 +++++++++++--------
 1 file changed, 15 insertions(+), 11 deletions(-)

diff --git a/openpype/hosts/max/plugins/load/load_pointcache_ornatrix.py b/openpype/hosts/max/plugins/load/load_pointcache_ornatrix.py
index a3c9d94f83..56cac00aeb 100644
--- a/openpype/hosts/max/plugins/load/load_pointcache_ornatrix.py
+++ b/openpype/hosts/max/plugins/load/load_pointcache_ornatrix.py
@@ -22,18 +22,20 @@ class OxAbcLoader(load.LoaderPlugin):
                                "found/installed in Max yet..")
 
         file_path = os.path.normpath(self.filepath_from_context(context))
-        scene_object_before = [obj for obj in rt.rootNode.Children]
         rt.AlembicImport.ImportToRoot = True
         rt.AlembicImport.CustomAttributes = True
         rt.importFile(
             file_path, rt.name("noPrompt"),
             using=rt.Ornatrix_Alembic_Importer)
-        scene_object_after = [obj for obj in rt.rootNode.Children]
-        for scene_object in scene_object_before:
-            scene_object_after = scene_object_after.remove(scene_object)
+
+        scene_object = []
+        for obj in rt.rootNode.Children:
+            obj_type = rt.ClassOf(obj)
+            if str(obj_type).startswith("Ox_"):
+                scene_object.append(obj)
 
         abc_container = rt.Container(name=name)
-        for abc in scene_object_after:
+        for abc in scene_object:
             abc.Parent = abc_container
 
         return containerise(
@@ -48,18 +50,20 @@ class OxAbcLoader(load.LoaderPlugin):
         for children in container.Children:
             rt.Delete(children)
 
-        scene_object_before = [obj for obj in rt.rootNode.Children]
         rt.AlembicImport.ImportToRoot = False
         rt.AlembicImport.CustomAttributes = True
         rt.importFile(
             path, rt.name("noPrompt"),
             using=rt.Ornatrix_Alembic_Importer)
-        scene_object_after = [obj for obj in rt.rootNode.Children]
-        for scene_object in scene_object_before:
-            scene_object_after = scene_object_after.remove(scene_object)
 
-        for scene_object in scene_object_after:
-            scene_object.Parent = container
+        scene_object = []
+        for obj in rt.rootNode.Children:
+            obj_type = rt.ClassOf(obj)
+            if str(obj_type).startswith("Ox_"):
+                scene_object.append(obj)
+
+        for abc in scene_object:
+            abc.Parent = container
 
         lib.imprint(
             container["instance_node"],

From a4e876792a28709a398433a7e047e40c865c4244 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Wed, 30 Aug 2023 15:42:05 +0200
Subject: [PATCH 125/366] typo fix

---
 openpype/pipeline/colorspace.py | 46 ++++++++++++++++-----------------
 1 file changed, 23 insertions(+), 23 deletions(-)

diff --git a/openpype/pipeline/colorspace.py b/openpype/pipeline/colorspace.py
index 1251308eb3..8025022c59 100644
--- a/openpype/pipeline/colorspace.py
+++ b/openpype/pipeline/colorspace.py
@@ -20,7 +20,7 @@ from openpype.pipeline import Anatomy
 log = Logger.get_logger(__name__)
 
 
-class CashedData:
+class CachedData:
     remapping = None
     python3compatible = None
     config_version_data = None
@@ -378,41 +378,41 @@ def get_wrapped_with_subprocess(command_group, command, **kwargs):
 
 def compatibility_check():
     """Making sure PyOpenColorIO is importable"""
-    if CashedData.python3compatible is not None:
-        return CashedData.python3compatible
+    if CachedData.python3compatible is not None:
+        return CachedData.python3compatible
 
     try:
         import PyOpenColorIO  # noqa: F401
-        CashedData.python3compatible = True
+        CachedData.python3compatible = True
     except ImportError:
-        CashedData.python3compatible = False
+        CachedData.python3compatible = False
 
     # compatible
-    return CashedData.python3compatible
+    return CachedData.python3compatible
 
 
 def compatibility_check_config_version(config_path, major=1, minor=None):
     """Making sure PyOpenColorIO config version is compatible"""
 
-    if not CashedData.config_version_data:
+    if not CachedData.config_version_data:
         if compatibility_check():
             from openpype.scripts.ocio_wrapper import _get_version_data
 
-            CashedData.config_version_data = _get_version_data(config_path)
+            CachedData.config_version_data = _get_version_data(config_path)
 
         else:
             # python environment is not compatible with PyOpenColorIO
             # needs to be run in subprocess
-            CashedData.config_version_data = get_wrapped_with_subprocess(
+            CachedData.config_version_data = get_wrapped_with_subprocess(
                 "config", "get_version", config_path=config_path
             )
 
     # check major version
-    if CashedData.config_version_data["major"] != major:
+    if CachedData.config_version_data["major"] != major:
         return False
 
     # check minor version
-    if minor and CashedData.config_version_data["minor"] != minor:
+    if minor and CachedData.config_version_data["minor"] != minor:
         return False
 
     # compatible
@@ -431,21 +431,21 @@ def get_ocio_config_colorspaces(config_path):
     Returns:
         dict: colorspace and family in couple
     """
-    if not CashedData.ocio_config_colorspaces.get(config_path):
+    if not CachedData.ocio_config_colorspaces.get(config_path):
         if not compatibility_check():
             # python environment is not compatible with PyOpenColorIO
             # needs to be run in subprocess
-            CashedData.ocio_config_colorspaces[config_path] = \
+            CachedData.ocio_config_colorspaces[config_path] = \
                 get_wrapped_with_subprocess(
                     "config", "get_colorspace", in_path=config_path
             )
         else:
             from openpype.scripts.ocio_wrapper import _get_colorspace_data
 
-            CashedData.ocio_config_colorspaces[config_path] = \
+            CachedData.ocio_config_colorspaces[config_path] = \
                 _get_colorspace_data(config_path)
 
-    return CashedData.ocio_config_colorspaces[config_path]
+    return CachedData.ocio_config_colorspaces[config_path]
 
 
 # TODO: remove this in future - backward compatibility
@@ -730,15 +730,15 @@ def get_remapped_colorspace_to_native(
         Union[str, None]: native colorspace name defined in remapping or None
     """
 
-    CashedData.remapping.setdefault(host_name, {})
-    if CashedData.remapping[host_name].get("to_native") is None:
+    CachedData.remapping.setdefault(host_name, {})
+    if CachedData.remapping[host_name].get("to_native") is None:
         remapping_rules = imageio_host_settings["remapping"]["rules"]
-        CashedData.remapping[host_name]["to_native"] = {
+        CachedData.remapping[host_name]["to_native"] = {
             rule["ocio_name"]: rule["host_native_name"]
             for rule in remapping_rules
         }
 
-    return CashedData.remapping[host_name]["to_native"].get(
+    return CachedData.remapping[host_name]["to_native"].get(
         ocio_colorspace_name)
 
 
@@ -756,15 +756,15 @@ def get_remapped_colorspace_from_native(
         Union[str, None]: Ocio colorspace name defined in remapping or None.
     """
 
-    CashedData.remapping.setdefault(host_name, {})
-    if CashedData.remapping[host_name].get("from_native") is None:
+    CachedData.remapping.setdefault(host_name, {})
+    if CachedData.remapping[host_name].get("from_native") is None:
         remapping_rules = imageio_host_settings["remapping"]["rules"]
-        CashedData.remapping[host_name]["from_native"] = {
+        CachedData.remapping[host_name]["from_native"] = {
             rule["host_native_name"]: rule["ocio_name"]
             for rule in remapping_rules
         }
 
-    return CashedData.remapping[host_name]["from_native"].get(
+    return CachedData.remapping[host_name]["from_native"].get(
         host_native_colorspace_name)
 
 

From 3292114e2109656e3fb92d6443db52838007181c Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Wed, 30 Aug 2023 15:46:59 +0200
Subject: [PATCH 126/366] better error message

---
 openpype/pipeline/colorspace.py | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/openpype/pipeline/colorspace.py b/openpype/pipeline/colorspace.py
index 8025022c59..9c77723d12 100644
--- a/openpype/pipeline/colorspace.py
+++ b/openpype/pipeline/colorspace.py
@@ -257,8 +257,7 @@ def parse_colorspace_from_filepath(
     """
     if not colorspaces and not config_path:
         raise ValueError(
-            "You need to provide `config_path` if you don't "
-            "want to provide input `colorspaces`."
+            "Must provide `config_path` if `colorspaces` is not provided."
         )
 
     colorspaces = colorspaces or get_ocio_config_colorspaces(config_path)

From c89d384e5a0033d436763751d3be9c85ea639ce2 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Wed, 30 Aug 2023 16:55:36 +0200
Subject: [PATCH 127/366] optimisation of regex search

suggestion from https://github.com/ynput/OpenPype/pull/5273#discussion_r1309372596
---
 openpype/pipeline/colorspace.py | 49 +++++++++++++++++++++++++--------
 1 file changed, 37 insertions(+), 12 deletions(-)

diff --git a/openpype/pipeline/colorspace.py b/openpype/pipeline/colorspace.py
index 9c77723d12..47227a0e3b 100644
--- a/openpype/pipeline/colorspace.py
+++ b/openpype/pipeline/colorspace.py
@@ -255,24 +255,49 @@ def parse_colorspace_from_filepath(
     Returns:
         str: name of colorspace
     """
+    def _get_colorspace_match_regex(colorspaces):
+        """Return a regex patter
+
+        Allows to search a colorspace match in a filename
+
+        Args:
+            colorspaces (list): List of colorspace names
+
+        Returns:
+            re.Pattern: regex pattern
+        """
+        pattern = "|".join(
+            # Allow to match spaces also as underscores because the
+            # integrator replaces spaces with underscores in filenames
+            re.escape(colorspace).replace(r"\ ", r"[_ ]") for colorspace in
+            # Sort by longest first so the regex matches longer matches
+            # over smaller matches, e.g. matching 'Output - sRGB' over 'sRGB'
+            sorted(colorspaces, key=len, reverse=True)
+        )
+        return re.compile(pattern)
+
     if not colorspaces and not config_path:
         raise ValueError(
             "Must provide `config_path` if `colorspaces` is not provided."
         )
 
-    colorspaces = colorspaces or get_ocio_config_colorspaces(config_path)
-
-    # match file rule from path
     colorspace_name = None
-    for colorspace_key in colorspaces:
-        # check underscored variant of colorspace name
-        # since we are reformatting it in integrate.py
-        if colorspace_key.replace(" ", "_") in filepath:
-            colorspace_name = colorspace_key
-            break
-        if colorspace_key in filepath:
-            colorspace_name = colorspace_key
-            break
+    colorspaces = colorspaces or get_ocio_config_colorspaces(config_path)
+    underscored_colorspaces = {
+        key.replace(" ", "_"): key for key in colorspaces
+        if " " in key
+    }
+
+    # match colorspace from  filepath
+    regex_pattern = _get_colorspace_match_regex(colorspaces)
+    match = regex_pattern.search(filepath)
+    colorspace = match.group(0) if match else None
+
+    if colorspace:
+        colorspace_name = colorspace
+
+    if colorspace in underscored_colorspaces:
+        colorspace_name = underscored_colorspaces[colorspace]
 
     if not colorspace_name:
         log.info("No matching colorspace in config '{}' for path: '{}'".format(

From 3928e26c45f91b1d2113268c8d0c4a889db93cbf Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Wed, 30 Aug 2023 17:02:59 +0200
Subject: [PATCH 128/366] turn public to non-public function

---
 openpype/pipeline/colorspace.py | 20 ++++++++++----------
 1 file changed, 10 insertions(+), 10 deletions(-)

diff --git a/openpype/pipeline/colorspace.py b/openpype/pipeline/colorspace.py
index 47227a0e3b..118466bc92 100644
--- a/openpype/pipeline/colorspace.py
+++ b/openpype/pipeline/colorspace.py
@@ -213,7 +213,7 @@ def get_colorspace_from_filepath(config_path, filepath):
     if not compatibility_check():
         # python environment is not compatible with PyOpenColorIO
         # needs to be run in subprocess
-        result_data = get_wrapped_with_subprocess(
+        result_data = _get_wrapped_with_subprocess(
             "colorspace", "get_colorspace_from_filepath",
             config_path=config_path,
             filepath=filepath
@@ -331,7 +331,7 @@ def validate_imageio_colorspace_in_config(config_path, colorspace_name):
 
 
 # TODO: remove this in future - backward compatibility
-@deprecated("get_wrapped_with_subprocess")
+@deprecated("_get_wrapped_with_subprocess")
 def get_data_subprocess(config_path, data_type):
     """[Deprecated] Get data via subprocess
 
@@ -361,7 +361,7 @@ def get_data_subprocess(config_path, data_type):
         return json.loads(return_json_data)
 
 
-def get_wrapped_with_subprocess(command_group, command, **kwargs):
+def _get_wrapped_with_subprocess(command_group, command, **kwargs):
     """Get data via subprocess
 
     Wrapper for Python 2 hosts.
@@ -427,7 +427,7 @@ def compatibility_check_config_version(config_path, major=1, minor=None):
         else:
             # python environment is not compatible with PyOpenColorIO
             # needs to be run in subprocess
-            CachedData.config_version_data = get_wrapped_with_subprocess(
+            CachedData.config_version_data = _get_wrapped_with_subprocess(
                 "config", "get_version", config_path=config_path
             )
 
@@ -460,7 +460,7 @@ def get_ocio_config_colorspaces(config_path):
             # python environment is not compatible with PyOpenColorIO
             # needs to be run in subprocess
             CachedData.ocio_config_colorspaces[config_path] = \
-                get_wrapped_with_subprocess(
+                _get_wrapped_with_subprocess(
                     "config", "get_colorspace", in_path=config_path
             )
         else:
@@ -473,7 +473,7 @@ def get_ocio_config_colorspaces(config_path):
 
 
 # TODO: remove this in future - backward compatibility
-@deprecated("get_wrapped_with_subprocess")
+@deprecated("_get_wrapped_with_subprocess")
 def get_colorspace_data_subprocess(config_path):
     """[Deprecated] Get colorspace data via subprocess
 
@@ -485,7 +485,7 @@ def get_colorspace_data_subprocess(config_path):
     Returns:
         dict: colorspace and family in couple
     """
-    return get_wrapped_with_subprocess(
+    return _get_wrapped_with_subprocess(
         "config", "get_colorspace", in_path=config_path
     )
 
@@ -505,7 +505,7 @@ def get_ocio_config_views(config_path):
     if not compatibility_check():
         # python environment is not compatible with PyOpenColorIO
         # needs to be run in subprocess
-        return get_wrapped_with_subprocess(
+        return _get_wrapped_with_subprocess(
             "config", "get_views", in_path=config_path
         )
 
@@ -515,7 +515,7 @@ def get_ocio_config_views(config_path):
 
 
 # TODO: remove this in future - backward compatibility
-@deprecated("get_wrapped_with_subprocess")
+@deprecated("_get_wrapped_with_subprocess")
 def get_views_data_subprocess(config_path):
     """[Deprecated] Get viewers data via subprocess
 
@@ -527,7 +527,7 @@ def get_views_data_subprocess(config_path):
     Returns:
         dict: `display/viewer` and viewer data
     """
-    return get_wrapped_with_subprocess(
+    return _get_wrapped_with_subprocess(
         "config", "get_views", in_path=config_path
     )
 

From 7db4be1a482bbe63e24f1a0176ed35e260cc7bf4 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jakub=20Je=C5=BEek?= <jakubjezek001@gmail.com>
Date: Wed, 30 Aug 2023 17:04:24 +0200
Subject: [PATCH 129/366] Update openpype/pipeline/colorspace.py

Co-authored-by: Roy Nieterau <roy_nieterau@hotmail.com>
---
 openpype/pipeline/colorspace.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/pipeline/colorspace.py b/openpype/pipeline/colorspace.py
index 118466bc92..fa9f124130 100644
--- a/openpype/pipeline/colorspace.py
+++ b/openpype/pipeline/colorspace.py
@@ -156,7 +156,7 @@ def get_imageio_colorspace_from_filepath(
 
     # match file rule from path
     colorspace_name = None
-    for _, file_rule in file_rules.items():
+    for file_rule in file_rules.values():
         pattern = file_rule["pattern"]
         extension = file_rule["ext"]
         ext_match = re.match(

From d570a2bff19fdaa6f0af909c5e450275684f1ab2 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jakub=20Je=C5=BEek?= <jakubjezek001@gmail.com>
Date: Wed, 30 Aug 2023 17:05:48 +0200
Subject: [PATCH 130/366] Update openpype/pipeline/colorspace.py

Co-authored-by: Roy Nieterau <roy_nieterau@hotmail.com>
---
 openpype/pipeline/colorspace.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/openpype/pipeline/colorspace.py b/openpype/pipeline/colorspace.py
index fa9f124130..20ca60b10e 100644
--- a/openpype/pipeline/colorspace.py
+++ b/openpype/pipeline/colorspace.py
@@ -357,8 +357,8 @@ def get_data_subprocess(config_path, data_type):
         run_openpype_process(*args, **process_kwargs)
 
         # return all colorspaces
-        return_json_data = open(tmp_json_path).read()
-        return json.loads(return_json_data)
+        with open(tmp_json_path, "r") as f:
+            return json.load(f)
 
 
 def _get_wrapped_with_subprocess(command_group, command, **kwargs):

From e8c58f13d7a1b394aae3ad60a7ec2bc290b38511 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Wed, 30 Aug 2023 17:08:42 +0200
Subject: [PATCH 131/366] suggestion for json return from file

---
 openpype/pipeline/colorspace.py | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/openpype/pipeline/colorspace.py b/openpype/pipeline/colorspace.py
index 20ca60b10e..c7eb778fa2 100644
--- a/openpype/pipeline/colorspace.py
+++ b/openpype/pipeline/colorspace.py
@@ -357,8 +357,8 @@ def get_data_subprocess(config_path, data_type):
         run_openpype_process(*args, **process_kwargs)
 
         # return all colorspaces
-        with open(tmp_json_path, "r") as f:
-            return json.load(f)
+        with open(tmp_json_path, "r") as f_:
+            return json.load(f_)
 
 
 def _get_wrapped_with_subprocess(command_group, command, **kwargs):
@@ -396,8 +396,8 @@ def _get_wrapped_with_subprocess(command_group, command, **kwargs):
         run_openpype_process(*args, **process_kwargs)
 
         # return all colorspaces
-        return_json_data = open(tmp_json_path).read()
-        return json.loads(return_json_data)
+        with open(tmp_json_path, "r") as f_:
+            return json.load(f_)
 
 
 def compatibility_check():

From f1cf4fcda6a205f8c89573f3f5892acb8c5d51e0 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Wed, 30 Aug 2023 17:23:01 +0200
Subject: [PATCH 132/366] removing deprecated code with backward compatibility

---
 openpype/pipeline/colorspace.py | 22 +++-------------------
 1 file changed, 3 insertions(+), 19 deletions(-)

diff --git a/openpype/pipeline/colorspace.py b/openpype/pipeline/colorspace.py
index c7eb778fa2..9f1c297188 100644
--- a/openpype/pipeline/colorspace.py
+++ b/openpype/pipeline/colorspace.py
@@ -340,25 +340,9 @@ def get_data_subprocess(config_path, data_type):
     Args:
         config_path (str): path leading to config.ocio file
     """
-    with _make_temp_json_file() as tmp_json_path:
-        # Prepare subprocess arguments
-        args = [
-            "run", get_ocio_config_script_path(),
-            "config", data_type,
-            "--in_path", config_path,
-            "--out_path", tmp_json_path
-        ]
-        log.info("Executing: {}".format(" ".join(args)))
-
-        process_kwargs = {
-            "logger": log
-        }
-
-        run_openpype_process(*args, **process_kwargs)
-
-        # return all colorspaces
-        with open(tmp_json_path, "r") as f_:
-            return json.load(f_)
+    return _get_wrapped_with_subprocess(
+        "config", data_type, in_path=config_path,
+    )
 
 
 def _get_wrapped_with_subprocess(command_group, command, **kwargs):

From a6b8fdfe33dc5dcf1eb1120a65f5ad264b3b1ef4 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Wed, 30 Aug 2023 22:43:06 +0200
Subject: [PATCH 133/366] refactor function names and code logic for colorspace
 from filepath

---
 openpype/pipeline/colorspace.py  | 118 +++++++++++++++++++++----------
 openpype/scripts/ocio_wrapper.py |  10 +--
 2 files changed, 84 insertions(+), 44 deletions(-)

diff --git a/openpype/pipeline/colorspace.py b/openpype/pipeline/colorspace.py
index 9f1c297188..f1acd18a70 100644
--- a/openpype/pipeline/colorspace.py
+++ b/openpype/pipeline/colorspace.py
@@ -115,27 +115,92 @@ def get_ocio_config_script_path():
     )
 
 
-def get_imageio_colorspace_from_filepath(
-    path, host_name, project_name,
+def get_colorspace_name_from_filepath(
+    filepath, host_name, project_name,
     config_data=None, file_rules=None,
     project_settings=None,
     validate=True
 ):
     """Get colorspace name from filepath
 
+    Args:
+        filepath (str): path string, file rule pattern is tested on it
+        host_name (str): host name
+        project_name (str): project name
+        config_data (Optional[dict]): config path and template in dict.
+                                      Defaults to None.
+        file_rules (Optional[dict]): file rule data from settings.
+                                     Defaults to None.
+        project_settings (Optional[dict]): project settings. Defaults to None.
+        validate (Optional[bool]): should resulting colorspace be validated
+                                with config file? Defaults to True.
+
+    Returns:
+        str: name of colorspace
+    """
+    # use ImageIO file rules
+    colorspace_name = get_imageio_file_rules_colorspace_from_filepath(
+        filepath, host_name, project_name,
+        config_data=config_data, file_rules=file_rules,
+        project_settings=project_settings
+    )
+
+    # try to get colorspace from OCIO v2 file rules
+    if (
+        not colorspace_name
+        and compatibility_check_config_version(config_data["path"], major=2)
+    ):
+        colorspace_name = get_config_file_rules_colorspace_from_filepath(
+            config_data["path"], filepath)
+
+    # use parse colorspace from filepath as fallback
+    colorspace_name = colorspace_name or parse_colorspace_from_filepath(
+        filepath, config_path=config_data["path"]
+    )
+
+    if not colorspace_name:
+        log.info("No imageio file rule matched input path: '{}'".format(
+            filepath
+        ))
+        return None
+
+    # validate matching colorspace with config
+    if validate and config_data:
+        validate_imageio_colorspace_in_config(
+            config_data["path"], colorspace_name)
+
+    return colorspace_name
+
+
+# TODO: remove this in future - backward compatibility
+@deprecated("get_imageio_file_rules_colorspace_from_filepath")
+def get_imageio_colorspace_from_filepath(*args, **kwargs):
+    return get_imageio_file_rules_colorspace_from_filepath(*args, **kwargs)
+
+# TODO: remove this in future - backward compatibility
+@deprecated("get_imageio_file_rules_colorspace_from_filepath")
+def get_colorspace_from_filepath(*args, **kwargs):
+    return get_imageio_file_rules_colorspace_from_filepath(*args, **kwargs)
+
+
+def get_imageio_file_rules_colorspace_from_filepath(
+    filepath, host_name, project_name,
+    config_data=None, file_rules=None,
+    project_settings=None
+):
+    """Get colorspace name from filepath
+
     ImageIO Settings file rules are tested for matching rule.
 
     Args:
-        path (str): path string, file rule pattern is tested on it
+        filepath (str): path string, file rule pattern is tested on it
         host_name (str): host name
         project_name (str): project name
-        config_data (dict, optional): config path and template in dict.
+        config_data (Optional[dict]): config path and template in dict.
                                       Defaults to None.
-        file_rules (dict, optional): file rule data from settings.
+        file_rules (Optional[dict]): file rule data from settings.
                                      Defaults to None.
-        project_settings (dict, optional): project settings. Defaults to None.
-        validate (bool, optional): should resulting colorspace be validated
-                                   with config file? Defaults to True.
+        project_settings (Optional[dict]): project settings. Defaults to None.
 
     Returns:
         str: name of colorspace
@@ -160,44 +225,19 @@ def get_imageio_colorspace_from_filepath(
         pattern = file_rule["pattern"]
         extension = file_rule["ext"]
         ext_match = re.match(
-            r".*(?=.{})".format(extension), path
+            r".*(?=.{})".format(extension), filepath
         )
         file_match = re.search(
-            pattern, path
+            pattern, filepath
         )
 
         if ext_match and file_match:
             colorspace_name = file_rule["colorspace"]
 
-    # if no file rule matched, try to get colorspace
-    # from filepath with OCIO v2 way
-    if (
-        compatibility_check_config_version(config_data["path"], major=2)
-        and not colorspace_name
-    ):
-        colorspace_name = get_colorspace_from_filepath(
-            config_data["path"], path)
-
-    # use parse colorspace from filepath as fallback
-    colorspace_name = colorspace_name or parse_colorspace_from_filepath(
-        path, config_path=config_data["path"]
-    )
-
-    if not colorspace_name:
-        log.info("No imageio file rule matched input path: '{}'".format(
-            path
-        ))
-        return None
-
-    # validate matching colorspace with config
-    if validate and config_data:
-        validate_imageio_colorspace_in_config(
-            config_data["path"], colorspace_name)
-
     return colorspace_name
 
 
-def get_colorspace_from_filepath(config_path, filepath):
+def get_config_file_rules_colorspace_from_filepath(config_path, filepath):
     """Get colorspace from file path wrapper.
 
     Wrapper function for getting colorspace from file path
@@ -214,16 +254,16 @@ def get_colorspace_from_filepath(config_path, filepath):
         # python environment is not compatible with PyOpenColorIO
         # needs to be run in subprocess
         result_data = _get_wrapped_with_subprocess(
-            "colorspace", "get_colorspace_from_filepath",
+            "colorspace", "get_config_file_rules_colorspace_from_filepath",
             config_path=config_path,
             filepath=filepath
         )
         if result_data:
             return result_data[0]
 
-    from openpype.scripts.ocio_wrapper import _get_colorspace_from_filepath
+    from openpype.scripts.ocio_wrapper import _get_config_file_rules_colorspace_from_filepath
 
-    result_data = _get_colorspace_from_filepath(config_path, filepath)
+    result_data = _get_config_file_rules_colorspace_from_filepath(config_path, filepath)
 
     if result_data:
         return result_data[0]
diff --git a/openpype/scripts/ocio_wrapper.py b/openpype/scripts/ocio_wrapper.py
index 1feedde627..1515cb4e40 100644
--- a/openpype/scripts/ocio_wrapper.py
+++ b/openpype/scripts/ocio_wrapper.py
@@ -247,7 +247,7 @@ def _get_version_data(config_path):
 
 
 @colorspace.command(
-    name="get_colorspace_from_filepath",
+    name="get_config_file_rules_colorspace_from_filepath",
     help=(
         "return colorspace from filepath "
         "--config_path - ocio config file path (input arg is required) "
@@ -264,7 +264,7 @@ def _get_version_data(config_path):
 @click.option("--out_path", required=True,
               help="path where to write output json file",
               type=click.Path())
-def get_colorspace_from_filepath(config_path, filepath, out_path):
+def get_config_file_rules_colorspace_from_filepath(config_path, filepath, out_path):
     """Get colorspace from file path wrapper.
 
     Python 2 wrapped console command
@@ -275,12 +275,12 @@ def get_colorspace_from_filepath(config_path, filepath, out_path):
         out_path (str): temp json file path string
 
     Example of use:
-    > pyton.exe ./ocio_wrapper.py colorspace get_colorspace_from_filepath \
+    > pyton.exe ./ocio_wrapper.py colorspace get_config_file_rules_colorspace_from_filepath \
         --config_path=<path> --filepath=<path> --out_path=<path>
     """
     json_path = Path(out_path)
 
-    colorspace = _get_colorspace_from_filepath(config_path, filepath)
+    colorspace = _get_config_file_rules_colorspace_from_filepath(config_path, filepath)
 
     with open(json_path, "w") as f_:
         json.dump(colorspace, f_)
@@ -288,7 +288,7 @@ def get_colorspace_from_filepath(config_path, filepath, out_path):
     print(f"Colorspace name is saved to '{json_path}'")
 
 
-def _get_colorspace_from_filepath(config_path, filepath):
+def _get_config_file_rules_colorspace_from_filepath(config_path, filepath):
     """Return found colorspace data found in v2 file rules.
 
     Args:

From f5d145ea23eb6b6463e1fea0ed07b4b1e0ffe934 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Thu, 31 Aug 2023 10:42:57 +0200
Subject: [PATCH 134/366] hound and todos

---
 openpype/pipeline/colorspace.py  | 11 +++++++++--
 openpype/scripts/ocio_wrapper.py | 10 +++++++---
 2 files changed, 16 insertions(+), 5 deletions(-)

diff --git a/openpype/pipeline/colorspace.py b/openpype/pipeline/colorspace.py
index f1acd18a70..e315633d41 100644
--- a/openpype/pipeline/colorspace.py
+++ b/openpype/pipeline/colorspace.py
@@ -261,9 +261,11 @@ def get_config_file_rules_colorspace_from_filepath(config_path, filepath):
         if result_data:
             return result_data[0]
 
-    from openpype.scripts.ocio_wrapper import _get_config_file_rules_colorspace_from_filepath
+    # TODO: refactor this so it is not imported but part of this file
+    from openpype.scripts.ocio_wrapper import _get_config_file_rules_colorspace_from_filepath  # noqa: E501
 
-    result_data = _get_config_file_rules_colorspace_from_filepath(config_path, filepath)
+    result_data = _get_config_file_rules_colorspace_from_filepath(
+        config_path, filepath)
 
     if result_data:
         return result_data[0]
@@ -424,6 +426,7 @@ def _get_wrapped_with_subprocess(command_group, command, **kwargs):
             return json.load(f_)
 
 
+# TODO: this should be part of ocio_wrapper.py
 def compatibility_check():
     """Making sure PyOpenColorIO is importable"""
     if CachedData.python3compatible is not None:
@@ -439,11 +442,13 @@ def compatibility_check():
     return CachedData.python3compatible
 
 
+# TODO: this should be part of ocio_wrapper.py
 def compatibility_check_config_version(config_path, major=1, minor=None):
     """Making sure PyOpenColorIO config version is compatible"""
 
     if not CachedData.config_version_data:
         if compatibility_check():
+            # TODO: refactor this so it is not imported but part of this file
             from openpype.scripts.ocio_wrapper import _get_version_data
 
             CachedData.config_version_data = _get_version_data(config_path)
@@ -488,6 +493,7 @@ def get_ocio_config_colorspaces(config_path):
                     "config", "get_colorspace", in_path=config_path
             )
         else:
+            # TODO: refactor this so it is not imported but part of this file
             from openpype.scripts.ocio_wrapper import _get_colorspace_data
 
             CachedData.ocio_config_colorspaces[config_path] = \
@@ -533,6 +539,7 @@ def get_ocio_config_views(config_path):
             "config", "get_views", in_path=config_path
         )
 
+    # TODO: refactor this so it is not imported but part of this file
     from openpype.scripts.ocio_wrapper import _get_views_data
 
     return _get_views_data(config_path)
diff --git a/openpype/scripts/ocio_wrapper.py b/openpype/scripts/ocio_wrapper.py
index 1515cb4e40..56399f10a2 100644
--- a/openpype/scripts/ocio_wrapper.py
+++ b/openpype/scripts/ocio_wrapper.py
@@ -264,7 +264,9 @@ def _get_version_data(config_path):
 @click.option("--out_path", required=True,
               help="path where to write output json file",
               type=click.Path())
-def get_config_file_rules_colorspace_from_filepath(config_path, filepath, out_path):
+def get_config_file_rules_colorspace_from_filepath(
+    config_path, filepath, out_path
+):
     """Get colorspace from file path wrapper.
 
     Python 2 wrapped console command
@@ -275,12 +277,14 @@ def get_config_file_rules_colorspace_from_filepath(config_path, filepath, out_pa
         out_path (str): temp json file path string
 
     Example of use:
-    > pyton.exe ./ocio_wrapper.py colorspace get_config_file_rules_colorspace_from_filepath \
+    > pyton.exe ./ocio_wrapper.py \
+        colorspace get_config_file_rules_colorspace_from_filepath \
         --config_path=<path> --filepath=<path> --out_path=<path>
     """
     json_path = Path(out_path)
 
-    colorspace = _get_config_file_rules_colorspace_from_filepath(config_path, filepath)
+    colorspace = _get_config_file_rules_colorspace_from_filepath(
+        config_path, filepath)
 
     with open(json_path, "w") as f_:
         json.dump(colorspace, f_)

From abedafaff808a02088ef09ef748fa64e8604abaa Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Thu, 31 Aug 2023 10:56:56 +0200
Subject: [PATCH 135/366] fixing name of variable in tests

---
 tests/unit/openpype/pipeline/test_colorspace.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/tests/unit/openpype/pipeline/test_colorspace.py b/tests/unit/openpype/pipeline/test_colorspace.py
index 8ae98f7cf8..338627098c 100644
--- a/tests/unit/openpype/pipeline/test_colorspace.py
+++ b/tests/unit/openpype/pipeline/test_colorspace.py
@@ -227,7 +227,7 @@ class TestPipelineColorspace(TestPipeline):
         expected_hiero = "Gamma 2.2 Rec.709 - Texture"
 
         # switch to python 2 compatibility mode
-        colorspace.CashedData.python3compatible = False
+        colorspace.CachedData.python3compatible = False
 
         nuke_colorspace = colorspace.get_imageio_colorspace_from_filepath(
             nuke_filepath,
@@ -248,7 +248,7 @@ class TestPipelineColorspace(TestPipeline):
             f"Not matching colorspace {expected_hiero}")
 
         # return to python 3 compatibility mode
-        colorspace.CashedData.python3compatible = None
+        colorspace.CachedData.python3compatible = None
 
 
 test_case = TestPipelineColorspace()

From f7ce6406f94703dab8c47850c49dc6bd8c2d4920 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Thu, 31 Aug 2023 11:46:05 +0200
Subject: [PATCH 136/366] adding contextual settings method to be shared
 between two functions

---
 openpype/pipeline/colorspace.py | 52 +++++++++++++++++++++++++--------
 1 file changed, 40 insertions(+), 12 deletions(-)

diff --git a/openpype/pipeline/colorspace.py b/openpype/pipeline/colorspace.py
index e315633d41..a4901b7dfd 100644
--- a/openpype/pipeline/colorspace.py
+++ b/openpype/pipeline/colorspace.py
@@ -138,6 +138,16 @@ def get_colorspace_name_from_filepath(
     Returns:
         str: name of colorspace
     """
+    project_settings, config_data, file_rules = _get_context_settings(
+        host_name, project_name,
+        config_data=config_data, file_rules=file_rules,
+        project_settings=project_settings
+    )
+
+    if not config_data:
+        # in case global or host color management is not enabled
+        return None
+
     # use ImageIO file rules
     colorspace_name = get_imageio_file_rules_colorspace_from_filepath(
         filepath, host_name, project_name,
@@ -183,6 +193,28 @@ def get_colorspace_from_filepath(*args, **kwargs):
     return get_imageio_file_rules_colorspace_from_filepath(*args, **kwargs)
 
 
+def _get_context_settings(
+    host_name, project_name,
+    config_data=None, file_rules=None,
+    project_settings=None
+):
+    project_settings = project_settings or get_project_settings(
+        project_name
+    )
+
+    config_data = config_data or get_imageio_config(
+        project_name, host_name, project_settings)
+
+    # in case host color management is not enabled
+    if not config_data:
+        return (None, None, None)
+
+    file_rules = file_rules or get_imageio_file_rules(
+        project_name, host_name, project_settings)
+
+    return project_settings, config_data, file_rules
+
+
 def get_imageio_file_rules_colorspace_from_filepath(
     filepath, host_name, project_name,
     config_data=None, file_rules=None,
@@ -205,19 +237,15 @@ def get_imageio_file_rules_colorspace_from_filepath(
     Returns:
         str: name of colorspace
     """
-    if not any([config_data, file_rules]):
-        project_settings = project_settings or get_project_settings(
-            project_name
-        )
-        config_data = get_imageio_config(
-            project_name, host_name, project_settings)
+    project_settings, config_data, file_rules = _get_context_settings(
+        host_name, project_name,
+        config_data=config_data, file_rules=file_rules,
+        project_settings=project_settings
+    )
 
-        # in case host color management is not enabled
-        if not config_data:
-            return None
-
-        file_rules = get_imageio_file_rules(
-            project_name, host_name, project_settings)
+    if not config_data:
+        # in case global or host color management is not enabled
+        return None
 
     # match file rule from path
     colorspace_name = None

From 1e6f855e7420a123539b37afa5cc5c580412c09c Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Thu, 31 Aug 2023 11:46:48 +0200
Subject: [PATCH 137/366] fixing tests

---
 tests/unit/openpype/pipeline/test_colorspace.py | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/tests/unit/openpype/pipeline/test_colorspace.py b/tests/unit/openpype/pipeline/test_colorspace.py
index 338627098c..435ea709ab 100644
--- a/tests/unit/openpype/pipeline/test_colorspace.py
+++ b/tests/unit/openpype/pipeline/test_colorspace.py
@@ -196,7 +196,7 @@ class TestPipelineColorspace(TestPipeline):
         expected_nuke = "Camera Rec.709"
         expected_hiero = "Gamma 2.2 Rec.709 - Texture"
 
-        nuke_colorspace = colorspace.get_imageio_colorspace_from_filepath(
+        nuke_colorspace = colorspace.get_colorspace_name_from_filepath(
             nuke_filepath,
             "nuke",
             "test_project",
@@ -205,7 +205,7 @@ class TestPipelineColorspace(TestPipeline):
         assert expected_nuke == nuke_colorspace, (
             f"Not matching colorspace {expected_nuke}")
 
-        hiero_colorspace = colorspace.get_imageio_colorspace_from_filepath(
+        hiero_colorspace = colorspace.get_colorspace_name_from_filepath(
             hiero_filepath,
             "hiero",
             "test_project",
@@ -229,7 +229,7 @@ class TestPipelineColorspace(TestPipeline):
         # switch to python 2 compatibility mode
         colorspace.CachedData.python3compatible = False
 
-        nuke_colorspace = colorspace.get_imageio_colorspace_from_filepath(
+        nuke_colorspace = colorspace.get_colorspace_name_from_filepath(
             nuke_filepath,
             "nuke",
             "test_project",
@@ -238,7 +238,7 @@ class TestPipelineColorspace(TestPipeline):
         assert expected_nuke == nuke_colorspace, (
             f"Not matching colorspace {expected_nuke}")
 
-        hiero_colorspace = colorspace.get_imageio_colorspace_from_filepath(
+        hiero_colorspace = colorspace.get_colorspace_name_from_filepath(
             hiero_filepath,
             "hiero",
             "test_project",

From e4819fc952a8711e013c5e473933559219014483 Mon Sep 17 00:00:00 2001
From: Mustafa-Zarkash <mustafataherzaky@outlook.com>
Date: Fri, 1 Sep 2023 01:02:32 +0300
Subject: [PATCH 138/366] Kayla's and BigRoy's comments

---
 .../create/create_unreal_staticmesh.py        |  4 +-
 .../hosts/houdini/plugins/load/load_fbx.py    | 58 ++++++++-----------
 .../plugins/publish/collect_fbx_type.py       | 32 +---------
 .../plugins/publish/collect_output_node.py    |  7 ++-
 4 files changed, 34 insertions(+), 67 deletions(-)

diff --git a/openpype/hosts/houdini/plugins/create/create_unreal_staticmesh.py b/openpype/hosts/houdini/plugins/create/create_unreal_staticmesh.py
index 179c81510a..a048965364 100644
--- a/openpype/hosts/houdini/plugins/create/create_unreal_staticmesh.py
+++ b/openpype/hosts/houdini/plugins/create/create_unreal_staticmesh.py
@@ -26,8 +26,8 @@ class CreateUnrealStaticMesh(plugin.HoudiniCreator):
     """Unreal Static Meshes with collisions. """
 
     # you should set
-    identifier = "io.openpype.creators.houdini.unrealstaticmesh"
-    label = "Unreal - Static Mesh"
+    identifier = "io.openpype.creators.houdini.unrealstaticmesh.fbx"
+    label = "Unreal - Static Mesh (FBX)"
     family = "staticMesh"
     icon = "fa5s.cubes"
 
diff --git a/openpype/hosts/houdini/plugins/load/load_fbx.py b/openpype/hosts/houdini/plugins/load/load_fbx.py
index d661f84eeb..2e4dafc2d8 100644
--- a/openpype/hosts/houdini/plugins/load/load_fbx.py
+++ b/openpype/hosts/houdini/plugins/load/load_fbx.py
@@ -31,7 +31,7 @@ class FbxLoader(load.LoaderPlugin):
     def load(self, context, name=None, namespace=None, data=None):
 
         # get file path
-        file_path = self.get_file_path(context)
+        file_path = self.get_file_path(context=context)
 
         # get necessary data
         namespace, node_name = self.get_node_name(context, name, namespace)
@@ -41,10 +41,15 @@ class FbxLoader(load.LoaderPlugin):
 
         self[:] = nodes
 
-        # Call containerise function which does some
-        # automations for you
-        containerised_nodes = self.get_containerised_nodes(
-            nodes, context, node_name, namespace
+        # Call containerise function which does some automations for you
+        #  like moving created nodes to the AVALON_CONTAINERS subnetwork
+        containerised_nodes = pipeline.containerise(
+            node_name,
+            namespace,
+            nodes,
+            context,
+            self.__class__.__name__,
+            suffix="",
         )
 
         return containerised_nodes
@@ -61,8 +66,7 @@ class FbxLoader(load.LoaderPlugin):
             return
 
         # Update the file path
-        file_path = get_representation_path(representation)
-        file_path = self.format_path(file_path, representation)
+        file_path = self.get_file_path(representation=representation)
 
         file_node.setParms({"file": file_path})
 
@@ -77,15 +81,18 @@ class FbxLoader(load.LoaderPlugin):
     def switch(self, container, representation):
         self.update(container, representation)
 
-    def get_file_path(self, context):
+    def get_file_path(self, context=None, representation=None):
         """Return formatted file path."""
 
         # Format file name, Houdini only wants forward slashes
-        file_path = self.filepath_from_context(context)
-        file_path = os.path.normpath(file_path)
-        file_path = file_path.replace("\\", "/")
+        if context:
+            file_path = self.filepath_from_context(context)
+        elif representation:
+            file_path = get_representation_path(representation)
+        else:
+            return ""
 
-        return file_path
+        return file_path.replace("\\", "/")
 
     def get_node_name(self, context, name=None, namespace=None):
         """Define node name."""
@@ -145,27 +152,8 @@ class FbxLoader(load.LoaderPlugin):
         # node to optimize "debug" displaying in the viewport.
         file_node.setDisplayFlag(True)
 
-        # Set new position for unpack node else it gets cluttered
-        nodes = [parent_node, file_node, attribdelete, null]
-        for nr, node in enumerate(nodes):
-            node.setPosition([0, (0 - nr)])
+        # Set new position for children nodes
+        parent_node.layoutChildren()
 
-        return nodes
-
-    def get_containerised_nodes(self, nodes, context, node_name, namespace):
-        """Call containerise function.
-
-        It does some automations that you don't have to worry about, e.g.
-            1. It moves created nodes to the AVALON_CONTAINERS  subnetwork
-            2. Add extra parameters
-        """
-        containerised_nodes = pipeline.containerise(
-            node_name,
-            namespace,
-            nodes,
-            context,
-            self.__class__.__name__,
-            suffix="",
-        )
-
-        return containerised_nodes
+        # Retrun all the nodes
+        return [parent_node, file_node, attribdelete, null]
diff --git a/openpype/hosts/houdini/plugins/publish/collect_fbx_type.py b/openpype/hosts/houdini/plugins/publish/collect_fbx_type.py
index 4c83829c67..6ac40a4f50 100644
--- a/openpype/hosts/houdini/plugins/publish/collect_fbx_type.py
+++ b/openpype/hosts/houdini/plugins/publish/collect_fbx_type.py
@@ -16,7 +16,7 @@ class CollectFilmboxfbxType(pyblish.api.InstancePlugin):
     """Collect data type for fbx instance."""
 
     hosts = ["houdini"]
-    families = ["fbx", "staticMesh"]
+    families = ["staticMesh"]
     label = "Collect type of fbx"
 
     # Usually you will use this value as default
@@ -25,35 +25,9 @@ class CollectFilmboxfbxType(pyblish.api.InstancePlugin):
     # overrides InstancePlugin.process()
     def process(self, instance):
 
-        if instance.data["creator_identifier"] == "io.openpype.creators.houdini.unrealstaticmesh":  # noqa: E501
+        if instance.data["creator_identifier"] == "io.openpype.creators.houdini.unrealstaticmesh.fbx":  # noqa: E501
             # such a condition can be used to differentiate between
-            #  instances by identifier becuase sometimes instances
+            #  instances by identifier because sometimes instances
             #  may have the same family but different identifier
             #  e.g. bgeo and alembic
             instance.data["families"] += ["fbx"]
-
-        # Update instance.data with ouptut_node
-        out_node = self.get_output_node(instance)
-
-        if out_node:
-            instance.data["output_node"] = out_node
-
-        # Disclaimer : As a convntin we use collect_output_node.py
-        #   to Update instance.data with ouptut_node of different types
-        #   however, this collector is used for demonstration
-
-    def get_output_node(self, instance):
-        """Getting output_node Logic."""
-
-        import hou
-
-        # get output node
-        node = hou.node(instance.data["instance_node"])
-        out_node = node.parm("startnode").evalAsNode()
-
-        if not out_node:
-            self.log.warning("No output node collected.")
-            return
-
-        self.log.debug("Output node: %s" % out_node.path())
-        return out_node
diff --git a/openpype/hosts/houdini/plugins/publish/collect_output_node.py b/openpype/hosts/houdini/plugins/publish/collect_output_node.py
index 601ed17b39..91bd5fdb15 100644
--- a/openpype/hosts/houdini/plugins/publish/collect_output_node.py
+++ b/openpype/hosts/houdini/plugins/publish/collect_output_node.py
@@ -12,7 +12,8 @@ class CollectOutputSOPPath(pyblish.api.InstancePlugin):
         "imagesequence",
         "usd",
         "usdrender",
-        "redshiftproxy"
+        "redshiftproxy",
+        "staticMesh"
     ]
 
     hosts = ["houdini"]
@@ -57,6 +58,10 @@ class CollectOutputSOPPath(pyblish.api.InstancePlugin):
 
         elif node_type == "Redshift_Proxy_Output":
             out_node = node.parm("RS_archive_sopPath").evalAsNode()
+
+        elif node_type == "filmboxfbx":
+            out_node = node.parm("startnode").evalAsNode()
+
         else:
             raise ValueError(
                 "ROP node type '%s' is" " not supported." % node_type

From 127c63eb94b98af297287833e81f0ec9b2a8c5e7 Mon Sep 17 00:00:00 2001
From: Mustafa-Zarkash <mustafataherzaky@outlook.com>
Date: Fri, 1 Sep 2023 01:04:11 +0300
Subject: [PATCH 139/366] hound comments

---
 openpype/hosts/houdini/plugins/load/load_fbx.py | 2 --
 1 file changed, 2 deletions(-)

diff --git a/openpype/hosts/houdini/plugins/load/load_fbx.py b/openpype/hosts/houdini/plugins/load/load_fbx.py
index 2e4dafc2d8..681837e046 100644
--- a/openpype/hosts/houdini/plugins/load/load_fbx.py
+++ b/openpype/hosts/houdini/plugins/load/load_fbx.py
@@ -7,8 +7,6 @@ however this one includes extra comments for demonstration.
 
 This plugin is part of publish process guide.
 """
-import os
-
 from openpype.pipeline import (
     load,
     get_representation_path,

From d1e82ceb7ed7e0681a9856b6376cc8831f1c2d2a Mon Sep 17 00:00:00 2001
From: Mustafa-Zarkash <mustafataherzaky@outlook.com>
Date: Fri, 1 Sep 2023 15:00:45 +0300
Subject: [PATCH 140/366] allow publishing  sop and obj nodes

---
 .../create/create_unreal_staticmesh.py        | 70 ++++++-------------
 .../publish/validate_sop_output_node.py       |  2 +-
 2 files changed, 24 insertions(+), 48 deletions(-)

diff --git a/openpype/hosts/houdini/plugins/create/create_unreal_staticmesh.py b/openpype/hosts/houdini/plugins/create/create_unreal_staticmesh.py
index a048965364..0b5b313d9e 100644
--- a/openpype/hosts/houdini/plugins/create/create_unreal_staticmesh.py
+++ b/openpype/hosts/houdini/plugins/create/create_unreal_staticmesh.py
@@ -73,6 +73,13 @@ class CreateUnrealStaticMesh(plugin.HoudiniCreator):
         """Add settings for users. """
 
         attrs = super().get_pre_create_attr_defs()
+        createsubnetroot = BoolDef("createsubnetroot",
+                                     tooltip="Create an extra root for the Export node "
+                                             "when it’s a subnetwork. This causes the "
+                                             "exporting subnetwork node to be "
+                                             "represented in the FBX file.",
+                                     default=False,
+                                     label="Create Root for Subnet")
         vcformat = EnumDef("vcformat",
                            items={
                                0: "Maya Compatible (MC)",
@@ -88,7 +95,7 @@ class CreateUnrealStaticMesh(plugin.HoudiniCreator):
                                 default=False,
                                 label="Convert Units")
 
-        return attrs + [vcformat, convert_units]
+        return attrs + [createsubnetroot, vcformat, convert_units]
 
     # Overrides BaseCreator.get_dynamic_data()
     def get_dynamic_data(
@@ -123,13 +130,17 @@ class CreateUnrealStaticMesh(plugin.HoudiniCreator):
         # 5. get Valid Frame Range
         trange = 1
 
+        # 6. get createsubnetroot
+        createsubnetroot = pre_create_data.get("createsubnetroot")
+
         # parms dictionary
         parms = {
             "startnode": selection,
             "sopoutput": output_path,
             "vcformat": vcformat,
             "convertunits": convertunits,
-            "trange": trange
+            "trange": trange,
+            "createsubnetroot": createsubnetroot
         }
 
         return parms
@@ -149,36 +160,23 @@ class CreateUnrealStaticMesh(plugin.HoudiniCreator):
         if self.selected_nodes:
             selected_node = self.selected_nodes[0]
 
-            # Although Houdini allows ObjNode path on `startnode` for the
-            # the ROP node we prefer it set to the SopNode path explicitly
-
-            # Allow sop level paths (e.g. /obj/geo1/box1)
+            # Accept sop level nodes (e.g. /obj/geo1/box1)
             if isinstance(selected_node, hou.SopNode):
                 selection = selected_node.path()
                 self.log.debug(
                     "Valid SopNode selection, 'Export' in filmboxfbx"
-                    " will be set to '%s'."
-                    % selected_node
+                    " will be set to '%s'.", selected_node
                 )
 
-            # Allow object level paths to Geometry nodes (e.g. /obj/geo1)
-            # but do not allow other object level nodes types like cameras.
-            elif isinstance(selected_node, hou.ObjNode) and \
-                    selected_node.type().name() in ["geo"]:
+            # Accept object level nodes (e.g. /obj/geo1)
+            elif isinstance(selected_node, hou.ObjNode):
+                selection = selected_node.path()
+                self.log.debug(
+                    "Valid ObjNode selection, 'Export' in filmboxfbx "
+                    "will be set to the child path '%s'.", selection
+                )
 
-                # get the output node with the minimum
-                # 'outputidx' or the node with display flag
-                sop_path = self.get_obj_output(selected_node)
-
-                if sop_path:
-                    selection = sop_path.path()
-                    self.log.debug(
-                        "Valid ObjNode selection, 'Export' in filmboxfbx "
-                        "will be set to the child path '%s'."
-                        % sop_path
-                    )
-
-            if not selection:
+            else:
                 self.log.debug(
                     "Selection isn't valid. 'Export' in "
                     "filmboxfbx will be empty."
@@ -189,25 +187,3 @@ class CreateUnrealStaticMesh(plugin.HoudiniCreator):
             )
 
         return selection
-
-    def get_obj_output(self, obj_node):
-        """Find output node with the smallest 'outputidx'
-        or return the node with the render flag instead.
-        """
-
-        outputs = obj_node.subnetOutputs()
-
-        # if obj_node is empty
-        if not outputs:
-            return
-
-        # if obj_node has one output child whether its
-        # sop output node or a node with the render flag
-        elif len(outputs) == 1:
-            return outputs[0]
-
-        # if there are more than one, then it have multiple ouput nodes
-        # return the one with the minimum 'outputidx'
-        else:
-            return min(outputs,
-                       key=lambda node: node.evalParm('outputidx'))
diff --git a/openpype/hosts/houdini/plugins/publish/validate_sop_output_node.py b/openpype/hosts/houdini/plugins/publish/validate_sop_output_node.py
index 2b426d96dd..d9dee38680 100644
--- a/openpype/hosts/houdini/plugins/publish/validate_sop_output_node.py
+++ b/openpype/hosts/houdini/plugins/publish/validate_sop_output_node.py
@@ -22,7 +22,7 @@ class ValidateSopOutputNode(pyblish.api.InstancePlugin):
     """
 
     order = pyblish.api.ValidatorOrder
-    families = ["pointcache", "vdbcache", "fbx"]
+    families = ["pointcache", "vdbcache"]
     hosts = ["houdini"]
     label = "Validate Output Node"
     actions = [SelectROPAction, SelectInvalidAction]

From e6b9a7d0381a6325100c65537dd744d0796c3b31 Mon Sep 17 00:00:00 2001
From: Mustafa-Zarkash <mustafataherzaky@outlook.com>
Date: Fri, 1 Sep 2023 17:04:22 +0300
Subject: [PATCH 141/366] validate mesh name

---
 .../publish/validate_fbx_hierarchy_path.py    | 235 ------------------
 .../publish/validate_mesh_is_static.py        | 129 ----------
 .../validate_unreal_staticmesh_naming.py      | 102 ++++++++
 3 files changed, 102 insertions(+), 364 deletions(-)
 delete mode 100644 openpype/hosts/houdini/plugins/publish/validate_fbx_hierarchy_path.py
 delete mode 100644 openpype/hosts/houdini/plugins/publish/validate_mesh_is_static.py
 create mode 100644 openpype/hosts/houdini/plugins/publish/validate_unreal_staticmesh_naming.py

diff --git a/openpype/hosts/houdini/plugins/publish/validate_fbx_hierarchy_path.py b/openpype/hosts/houdini/plugins/publish/validate_fbx_hierarchy_path.py
deleted file mode 100644
index be73ccd223..0000000000
--- a/openpype/hosts/houdini/plugins/publish/validate_fbx_hierarchy_path.py
+++ /dev/null
@@ -1,235 +0,0 @@
-# -*- coding: utf-8 -*-
-"""Validate path attribute for all primitives.
-
-Validators are used to verify the work of artists,
-by running some checks which automates the approval process.
-
-It's almost the same as
-'validate_primitive_hierarchy_paths.py'
-however this one includes extra comments for demonstration.
-
-FYI, path for fbx behaves a little differently.
-In maya terms:
-in Filmbox FBX: it sets the name of the object
-in Alembic ROP: it sets the name of the shape
-
-This plugin is part of publish process guide.
-"""
-
-import pyblish.api
-from openpype.pipeline import (
-    PublishValidationError,
-    OptionalPyblishPluginMixin
-)
-from openpype.pipeline.publish import (
-    ValidateContentsOrder,
-    RepairAction,
-)
-from openpype.hosts.houdini.api.action import (
-    SelectInvalidAction,
-    SelectROPAction,
-)
-
-import hou
-
-
-# Each validation can have a single repair action
-# which calls the repair method
-class AddDefaultPathAction(RepairAction):
-    label = "Add a default path"
-    icon = "mdi.pencil-plus-outline"
-
-
-class ValidateFBXPrimitiveHierarchyPaths(pyblish.api.InstancePlugin,
-                                         OptionalPyblishPluginMixin):
-    """Validate all primitives build hierarchy from attribute
-    when enabled.
-
-    The name of the attribute must exist on the prims and have the
-    same name as Build Hierarchy from Attribute's `Path Attribute`
-    value on the FilmBox node.
-    This validation enables 'Build Hierarchy from Attribute'
-    by default.
-    """
-
-    families = ["fbx"]
-    hosts = ["houdini"]
-    label = "Validate Prims Hierarchy Path (FBX)"
-
-    # Usually you will use this value as default
-    order = ValidateContentsOrder + 0.1
-
-    # Validation can have as many actions as you want
-    # all of these actions are defined in a seperate place
-    # unlike the repair action
-    actions = [SelectInvalidAction, AddDefaultPathAction,
-               SelectROPAction]
-
-    # 'OptionalPyblishPluginMixin' adds the functionality to
-    # enable/disable plugins, It requires adding new settings.
-    optional = True
-
-    # overrides InstancePlugin.process()
-    def process(self, instance):
-        invalid = self.get_invalid(instance)
-        if invalid:
-            nodes = [n.path() for n in invalid]
-            raise PublishValidationError(
-                "See log for details. "
-                "Invalid nodes: {0}".format(nodes),
-                title=self.label
-            )
-
-    # This method was named get_invalid as a convention
-    # it's also used by SelectInvalidAction to select
-    # the returned nodes
-    @classmethod
-    def get_invalid(cls, instance):
-
-        output_node = instance.data.get("output_node")
-        rop_node = hou.node(instance.data["instance_node"])
-
-        if output_node is None:
-            cls.log.error(
-                "SOP Output node in '%s' does not exist. "
-                "Ensure a valid SOP output path is set.",
-                rop_node.path()
-            )
-
-            return [rop_node]
-
-        build_from_path = rop_node.parm("buildfrompath").eval()
-        if not build_from_path:
-            cls.log.debug(
-                "Filmbox FBX has 'Build from Path' disabled. "
-                "Enbaling it as default."
-            )
-            rop_node.parm("buildfrompath").set(1)
-
-        path_attr = rop_node.parm("pathattrib").eval()
-        if not path_attr:
-            cls.log.debug(
-                "Filmbox FBX node has no Path Attribute"
-                "value set, setting it to 'path' as default."
-            )
-            rop_node.parm("pathattrib").set("path")
-
-        cls.log.debug("Checking for attribute: %s", path_attr)
-
-        # Use current frame if "frameStart" doesn't exist
-        # This only happens when ""trange" is 0
-        frame = instance.data.get("frameStart", hou.intFrame())
-
-        # Get Geo at that frame
-        geo = output_node.geometryAtFrame(frame)
-        if not geo:
-            cls.log.warning("No geometry found,"
-                            " skipping check..")
-            return
-
-        # If there are no primitives on the current frame then
-        # we can't check whether the path names are correct.
-        # So we'll just issue a warning that the check can't
-        # be done consistently and skip validation.
-
-        if len(geo.iterPrims()) == 0:
-            cls.log.warning(
-                "No primitives found on current frame."
-                " Validation for primitive hierarchy"
-                " paths will be skipped,"
-                " thus can't be validated."
-            )
-            return
-
-        # Check if there are any values for the primitives
-        attrib = geo.findPrimAttrib(path_attr)
-        if not attrib:
-            cls.log.info(
-                "Geometry Primitives are missing "
-                "path attribute: `%s`", path_attr
-            )
-            return [output_node]
-
-        # Ensure at least a single string value is present
-        if not attrib.strings():
-            cls.log.info(
-                "Primitive path attribute has no "
-                "string values: %s", path_attr
-            )
-            return [output_node]
-
-        paths = geo.primStringAttribValues(path_attr)
-        # Ensure all primitives are set to a valid path
-        # Collect all invalid primitive numbers
-        invalid_prims = [i for i, path in enumerate(paths) if not path]
-        if invalid_prims:
-            num_prims = len(geo.iterPrims())  # faster than len(geo.prims())
-            cls.log.info(
-                "Prims have no value for attribute `%s` "
-                "(%s of %s prims)",
-                path_attr, len(invalid_prims), num_prims
-            )
-            return [output_node]
-
-    # what repair action expects to find and call
-    @classmethod
-    def repair(cls, instance):
-        """Add a default path attribute Action.
-
-        It is a helper action more than a repair action,
-        used to add a default single value for the path.
-        """
-
-        rop_node = hou.node(instance.data["instance_node"])
-        # I'm doing so because an artist may change output node
-        # before clicking the button.
-        output_node = rop_node.parm("startnode").evalAsNode()
-
-        if not output_node:
-            cls.log.debug(
-                "Action isn't performed, invalid SOP Path on %s",
-                rop_node
-            )
-            return
-
-        # This check to prevent the action from running multiple times.
-        # git_invalid only returns [output_node] when
-        #   path attribute is the problem
-        if cls.get_invalid(instance) != [output_node]:
-            return
-
-        path_attr = rop_node.parm("pathattrib").eval()
-
-        path_node = output_node.parent().createNode("name",
-                                                    "AUTO_PATH")
-        path_node.parm("attribname").set(path_attr)
-        path_node.parm("name1").set('`opname("..")`_GEO')
-
-        cls.log.debug(
-            "'%s' was created. It adds '%s' with a default"
-            " single value", path_node, path_attr
-        )
-
-        path_node.setGenericFlag(hou.nodeFlag.DisplayComment, True)
-        path_node.setComment(
-            'Auto path node was created automatically by '
-            '"Add a default path attribute"'
-            '\nFeel free to modify or replace it.'
-        )
-
-        if output_node.type().name() in ["null", "output"]:
-            # Connect before
-            path_node.setFirstInput(output_node.input(0))
-            path_node.moveToGoodPosition()
-            output_node.setFirstInput(path_node)
-            output_node.moveToGoodPosition()
-        else:
-            # Connect after
-            path_node.setFirstInput(output_node)
-            rop_node.parm("startnode").set(path_node.path())
-            path_node.moveToGoodPosition()
-
-            cls.log.debug(
-                "SOP path on '%s' updated to new output node '%s'",
-                rop_node, path_node
-            )
diff --git a/openpype/hosts/houdini/plugins/publish/validate_mesh_is_static.py b/openpype/hosts/houdini/plugins/publish/validate_mesh_is_static.py
deleted file mode 100644
index ac80fda537..0000000000
--- a/openpype/hosts/houdini/plugins/publish/validate_mesh_is_static.py
+++ /dev/null
@@ -1,129 +0,0 @@
-# -*- coding: utf-8 -*-
-"""Validate mesh is static.
-
-This plugin is part of publish process guide.
-"""
-
-import pyblish.api
-from openpype.pipeline import PublishValidationError
-from openpype.pipeline.publish import (
-    ValidateContentsOrder,
-    RepairAction,
-)
-from openpype.hosts.houdini.api.action import (
-    SelectInvalidAction,
-    SelectROPAction,
-)
-
-import hou
-
-
-# Each validation can have a single repair action
-# which calls the repair method
-class FreezeTimeAction(RepairAction):
-    label = "Freeze Time"
-    icon = "ei.pause-alt"
-
-
-class ValidateMeshIsStatic(pyblish.api.InstancePlugin):
-    """Validate mesh is static.
-
-    It checks if node is time dependant.
-    """
-
-    families = ["staticMesh"]
-    hosts = ["houdini"]
-    label = "Validate mesh is static"
-
-    # Usually you will use this value as default
-    order = ValidateContentsOrder + 0.1
-
-    # Validation can have as many actions as you want
-    # all of these actions are defined in a seperate place
-    # unlike the repair action
-    actions = [FreezeTimeAction, SelectInvalidAction,
-               SelectROPAction]
-
-    # overrides InstancePlugin.process()
-    def process(self, instance):
-        invalid = self.get_invalid(instance)
-        if invalid:
-            nodes = [n.path() for n in invalid]
-            raise PublishValidationError(
-                "See log for details. "
-                "Invalid nodes: {0}".format(nodes),
-                title=self.label
-            )
-
-    # This method was named get_invalid as a convention
-    # it's also used by SelectInvalidAction to select
-    # the returned nodes
-    @classmethod
-    def get_invalid(cls, instance):
-
-        output_node = instance.data.get("output_node")
-        if output_node.isTimeDependent():
-            cls.log.info("Mesh is not static!")
-            return [output_node]
-
-    # what repair action expects to find and call
-    @classmethod
-    def repair(cls, instance):
-        """Adds a time shift node.
-
-        It should kill time dependency.
-        """
-
-        rop_node = hou.node(instance.data["instance_node"])
-        # I'm doing so because an artist may change output node
-        # before clicking the button.
-        output_node = rop_node.parm("startnode").evalAsNode()
-
-        if not output_node:
-            cls.log.debug(
-                "Action isn't performed, invalid SOP Path on %s",
-                rop_node
-            )
-            return
-
-        # This check to prevent the action from running multiple times.
-        # git_invalid only returns [output_node] when
-        #   path attribute is the problem
-        if cls.get_invalid(instance) != [output_node]:
-            return
-
-        time_shift = output_node.parent().createNode("timeshift",
-                                                     "freeze_time")
-        time_shift.parm("frame").deleteAllKeyframes()
-
-        frame = instance.data.get("frameStart", hou.intFrame())
-        time_shift.parm("frame").set(frame)
-
-        cls.log.debug(
-            "'%s' was created. It will kill time dependency.",
-            time_shift
-        )
-
-        time_shift.setGenericFlag(hou.nodeFlag.DisplayComment, True)
-        time_shift.setComment(
-            'This node was created automatically by '
-            '"Freeze Time" Action'
-            '\nFeel free to modify or replace it.'
-        )
-
-        if output_node.type().name() in ["null", "output"]:
-            # Connect before
-            time_shift.setFirstInput(output_node.input(0))
-            time_shift.moveToGoodPosition()
-            output_node.setFirstInput(time_shift)
-            output_node.moveToGoodPosition()
-        else:
-            # Connect after
-            time_shift.setFirstInput(output_node)
-            rop_node.parm("startnode").set(time_shift.path())
-            time_shift.moveToGoodPosition()
-
-            cls.log.debug(
-                "SOP path on '%s' updated to new output node '%s'",
-                rop_node, time_shift
-            )
diff --git a/openpype/hosts/houdini/plugins/publish/validate_unreal_staticmesh_naming.py b/openpype/hosts/houdini/plugins/publish/validate_unreal_staticmesh_naming.py
new file mode 100644
index 0000000000..be450a0410
--- /dev/null
+++ b/openpype/hosts/houdini/plugins/publish/validate_unreal_staticmesh_naming.py
@@ -0,0 +1,102 @@
+# -*- coding: utf-8 -*-
+"""Validator for correct naming of Static Meshes."""
+import pyblish.api
+from openpype.pipeline import (
+    PublishValidationError,
+    OptionalPyblishPluginMixin
+)
+from openpype.pipeline.publish import ValidateContentsOrder
+
+from openpype.hosts.houdini.api.action import SelectInvalidAction
+
+import hou
+
+
+class ValidateUnrealStaticMeshName(pyblish.api.InstancePlugin,
+                                   OptionalPyblishPluginMixin):
+    """Validate name of Unreal Static Mesh
+
+    This validator checks if output node name has a collision prefix:
+            - UBX
+            - UCP
+            - USP
+            - UCX
+
+    This validator also checks if subset name is correct
+            - {static mesh prefix}_{Asset-Name}{Variant}.
+
+    """
+
+    families = ["staticMesh"]
+    hosts = ["houdini"]
+    label = "Unreal Static Mesh Name (FBX)"
+    order = ValidateContentsOrder + 0.1
+    actions = [SelectInvalidAction]
+
+    optional = True
+
+    @classmethod
+    def apply_settings(cls, project_settings, system_settings):
+        settings = (
+            project_settings["houdini"]["create"]["CreateUnrealStaticMesh"]
+        )
+        cls.collision_prefixes = settings["collision_prefixes"]
+        cls.static_mesh_prefix = settings["static_mesh_prefix"]
+
+    def process(self, instance):
+        invalid = self.get_invalid(instance)
+        if invalid:
+            nodes = [n.path() for n in invalid if isinstance(n, hou.Node)]
+            raise PublishValidationError(
+                "See log for details. "
+                "Invalid nodes: {0}".format(nodes),
+                title=self.label
+            )
+
+    @classmethod
+    def get_invalid(cls, instance):
+
+        invalid = []
+
+        rop_node = hou.node(instance.data["instance_node"])
+        output_node = instance.data.get("output_node")
+        cls.log.debug(cls.collision_prefixes)
+
+        # Check nodes names
+        if output_node.childTypeCategory() == hou.objNodeTypeCategory():
+            for child in output_node.children():
+                for prefix in cls.collision_prefixes:
+                    if child.name().startswith(prefix):
+                        invalid.append(child)
+                        cls.log.error(
+                            "Invalid name: Child node '%s' in '%s' "
+                            "has a collision prefix '%s'"
+                            , child.name(), output_node.path(), prefix
+                        )
+                        break
+        else:
+            cls.log.debug(output_node.name())
+            for prefix in cls.collision_prefixes:
+                if output_node.name().startswith(prefix):
+                    invalid.append(output_node)
+                    cls.log.error(
+                        "Invalid name: output node '%s' "
+                        "has a collision prefix '%s'"
+                        , output_node.name(), prefix
+                    )
+
+        # Check subset name
+        subset_name = "{}_{}{}".format(
+            cls.static_mesh_prefix,
+            instance.data["asset"],
+            instance.data.get("variant", "")
+        )
+
+        if instance.data.get("subset") != subset_name:
+            invalid.append(rop_node)
+            cls.log.error(
+                    "Invalid subset name on rop node '%s' should be '%s'."
+                    , rop_node.path(), subset_name
+            )
+
+        return invalid

From 128939068084b3b5af50db7812d1a9b8021a471c Mon Sep 17 00:00:00 2001
From: Mustafa-Zarkash <mustafataherzaky@outlook.com>
Date: Fri, 1 Sep 2023 17:23:53 +0300
Subject: [PATCH 142/366] update settings

---
 .../plugins/publish/validate_unreal_staticmesh_naming.py    | 6 +++++-
 openpype/settings/defaults/project_settings/houdini.json    | 2 +-
 .../projects_schema/schemas/schema_houdini_publish.json     | 4 ++--
 server_addon/houdini/server/settings/publish_plugins.py     | 6 +++---
 4 files changed, 11 insertions(+), 7 deletions(-)

diff --git a/openpype/hosts/houdini/plugins/publish/validate_unreal_staticmesh_naming.py b/openpype/hosts/houdini/plugins/publish/validate_unreal_staticmesh_naming.py
index be450a0410..24ef304185 100644
--- a/openpype/hosts/houdini/plugins/publish/validate_unreal_staticmesh_naming.py
+++ b/openpype/hosts/houdini/plugins/publish/validate_unreal_staticmesh_naming.py
@@ -14,7 +14,7 @@ import hou
 
 class ValidateUnrealStaticMeshName(pyblish.api.InstancePlugin,
                                    OptionalPyblishPluginMixin):
-    """Validate name of Unreal Static Mesh
+    """Validate name of Unreal Static Mesh.
 
     This validator checks if output node name has a collision prefix:
             - UBX
@@ -44,6 +44,10 @@ class ValidateUnrealStaticMeshName(pyblish.api.InstancePlugin,
         cls.static_mesh_prefix = settings["static_mesh_prefix"]
 
     def process(self, instance):
+
+        if not self.is_active(instance.data):
+            return
+
         invalid = self.get_invalid(instance)
         if invalid:
             nodes = [n.path() for n in invalid if isinstance(n, hou.Node)]
diff --git a/openpype/settings/defaults/project_settings/houdini.json b/openpype/settings/defaults/project_settings/houdini.json
index c39eb717fd..65f13fa1ab 100644
--- a/openpype/settings/defaults/project_settings/houdini.json
+++ b/openpype/settings/defaults/project_settings/houdini.json
@@ -111,7 +111,7 @@
             "optional": true,
             "active": true
         },
-        "ValidateFBXPrimitiveHierarchyPaths": {
+        "ValidateUnrealStaticMeshName": {
             "enabled": true,
             "optional": true,
             "active": true
diff --git a/openpype/settings/entities/schemas/projects_schema/schemas/schema_houdini_publish.json b/openpype/settings/entities/schemas/projects_schema/schemas/schema_houdini_publish.json
index d58b36eff1..4339f86db6 100644
--- a/openpype/settings/entities/schemas/projects_schema/schemas/schema_houdini_publish.json
+++ b/openpype/settings/entities/schemas/projects_schema/schemas/schema_houdini_publish.json
@@ -45,8 +45,8 @@
               "label": "ValidateContainers"
           },
           {
-            "key": "ValidateFBXPrimitiveHierarchyPaths",
-            "label": "Validate Path Attribute for FBX"
+            "key": "ValidateUnrealStaticMeshName",
+            "label": "Validate Unreal Static Mesh Name"
           }
       ]
     }
diff --git a/server_addon/houdini/server/settings/publish_plugins.py b/server_addon/houdini/server/settings/publish_plugins.py
index 1e5cd7f551..335751e5f9 100644
--- a/server_addon/houdini/server/settings/publish_plugins.py
+++ b/server_addon/houdini/server/settings/publish_plugins.py
@@ -164,9 +164,9 @@ class PublishPluginsModel(BaseSettingsModel):
     ValidateContainers: ValidateContainersModel = Field(
         default_factory=ValidateContainersModel,
         title="Validate Latest Containers.")
-    ValidateFBXPrimitiveHierarchyPaths: ValidateContainersModel = Field(
+    ValidateUnrealStaticMeshName: ValidateContainersModel = Field(
         default_factory=ValidateContainersModel,
-        title="Validate Path Attribute for FBX.")
+        title="Validate Unreal Static Mesh Name.")
 
 
 DEFAULT_HOUDINI_PUBLISH_SETTINGS = {
@@ -187,7 +187,7 @@ DEFAULT_HOUDINI_PUBLISH_SETTINGS = {
         "optional": True,
         "active": True
     },
-    "ValidateFBXPrimitiveHierarchyPaths": {
+    "ValidateUnrealStaticMeshName": {
         "enabled": True,
         "optional": True,
         "active": True

From c73d76ef15289f868d016c689ecaa880c3144262 Mon Sep 17 00:00:00 2001
From: Mustafa-Zarkash <mustafataherzaky@outlook.com>
Date: Fri, 1 Sep 2023 17:33:54 +0300
Subject: [PATCH 143/366] resolve houn

---
 .../plugins/create/create_unreal_staticmesh.py      | 13 +++++++------
 .../publish/validate_unreal_staticmesh_naming.py    | 12 ++++++------
 2 files changed, 13 insertions(+), 12 deletions(-)

diff --git a/openpype/hosts/houdini/plugins/create/create_unreal_staticmesh.py b/openpype/hosts/houdini/plugins/create/create_unreal_staticmesh.py
index 0b5b313d9e..6002f7b1d7 100644
--- a/openpype/hosts/houdini/plugins/create/create_unreal_staticmesh.py
+++ b/openpype/hosts/houdini/plugins/create/create_unreal_staticmesh.py
@@ -74,12 +74,13 @@ class CreateUnrealStaticMesh(plugin.HoudiniCreator):
 
         attrs = super().get_pre_create_attr_defs()
         createsubnetroot = BoolDef("createsubnetroot",
-                                     tooltip="Create an extra root for the Export node "
-                                             "when it’s a subnetwork. This causes the "
-                                             "exporting subnetwork node to be "
-                                             "represented in the FBX file.",
-                                     default=False,
-                                     label="Create Root for Subnet")
+                                   tooltip="Create an extra root for the "
+                                           "Export node when it’s a "
+                                           "subnetwork. This causes the "
+                                           "exporting subnetwork node to be "
+                                           "represented in the FBX file.",
+                                   default=False,
+                                   label="Create Root for Subnet")
         vcformat = EnumDef("vcformat",
                            items={
                                0: "Maya Compatible (MC)",
diff --git a/openpype/hosts/houdini/plugins/publish/validate_unreal_staticmesh_naming.py b/openpype/hosts/houdini/plugins/publish/validate_unreal_staticmesh_naming.py
index 24ef304185..a3426d2f19 100644
--- a/openpype/hosts/houdini/plugins/publish/validate_unreal_staticmesh_naming.py
+++ b/openpype/hosts/houdini/plugins/publish/validate_unreal_staticmesh_naming.py
@@ -74,8 +74,8 @@ class ValidateUnrealStaticMeshName(pyblish.api.InstancePlugin,
                         invalid.append(child)
                         cls.log.error(
                             "Invalid name: Child node '%s' in '%s' "
-                            "has a collision prefix '%s'"
-                            , child.name(), output_node.path(), prefix
+                            "has a collision prefix '%s'",
+                            child.name(), output_node.path(), prefix
                         )
                         break
         else:
@@ -85,8 +85,8 @@ class ValidateUnrealStaticMeshName(pyblish.api.InstancePlugin,
                     invalid.append(output_node)
                     cls.log.error(
                         "Invalid name: output node '%s' "
-                        "has a collision prefix '%s'"
-                        , output_node.name(), prefix
+                        "has a collision prefix '%s'",
+                        output_node.name(), prefix
                     )
 
         # Check subset name
@@ -99,8 +99,8 @@ class ValidateUnrealStaticMeshName(pyblish.api.InstancePlugin,
         if instance.data.get("subset") != subset_name:
             invalid.append(rop_node)
             cls.log.error(
-                    "Invalid subset name on rop node '%s' should be '%s'."
-                    , rop_node.path(), subset_name
+                    "Invalid subset name on rop node '%s' should be '%s'.",
+                    rop_node.path(), subset_name
             )
 
         return invalid

From 1f452510d8e4fb38deaebe59eb5f4d970d2b5aa1 Mon Sep 17 00:00:00 2001
From: Mustafa-Zarkash <mustafataherzaky@outlook.com>
Date: Fri, 1 Sep 2023 17:35:57 +0300
Subject: [PATCH 144/366] resolve hound

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

diff --git a/openpype/hosts/houdini/plugins/publish/validate_unreal_staticmesh_naming.py b/openpype/hosts/houdini/plugins/publish/validate_unreal_staticmesh_naming.py
index a3426d2f19..7820be4009 100644
--- a/openpype/hosts/houdini/plugins/publish/validate_unreal_staticmesh_naming.py
+++ b/openpype/hosts/houdini/plugins/publish/validate_unreal_staticmesh_naming.py
@@ -99,8 +99,8 @@ class ValidateUnrealStaticMeshName(pyblish.api.InstancePlugin,
         if instance.data.get("subset") != subset_name:
             invalid.append(rop_node)
             cls.log.error(
-                    "Invalid subset name on rop node '%s' should be '%s'.",
-                    rop_node.path(), subset_name
+                "Invalid subset name on rop node '%s' should be '%s'.",
+                rop_node.path(), subset_name
             )
 
         return invalid

From 938dc72d9179ee8938a98f0ce326c4dfadda5657 Mon Sep 17 00:00:00 2001
From: Mustafa-Zarkash <mustafataherzaky@outlook.com>
Date: Mon, 4 Sep 2023 11:56:10 +0300
Subject: [PATCH 145/366] revise creator and collector

---
 .../create/create_unreal_staticmesh.py        | 36 +++----------------
 .../plugins/publish/collect_fbx_type.py       | 33 -----------------
 .../publish/collect_staticmesh_type.py        | 20 +++++++++++
 .../validate_primitive_hierarchy_paths.py     |  2 +-
 4 files changed, 26 insertions(+), 65 deletions(-)
 delete mode 100644 openpype/hosts/houdini/plugins/publish/collect_fbx_type.py
 create mode 100644 openpype/hosts/houdini/plugins/publish/collect_staticmesh_type.py

diff --git a/openpype/hosts/houdini/plugins/create/create_unreal_staticmesh.py b/openpype/hosts/houdini/plugins/create/create_unreal_staticmesh.py
index 6002f7b1d7..ca5e2e8fb4 100644
--- a/openpype/hosts/houdini/plugins/create/create_unreal_staticmesh.py
+++ b/openpype/hosts/houdini/plugins/create/create_unreal_staticmesh.py
@@ -1,21 +1,5 @@
 # -*- coding: utf-8 -*-
-"""Creator plugin for creating Unreal Static Meshes.
-
-Unreal Static Meshes will be published as FBX.
-
-Filmbox by default expects an ObjNode
-however, we set the sop node explictly
-to eleminate any confusion.
-
-This will make Filmbox to ignore any object transformations!
-
-get_obj_output selects
-the output sop with mimimum idx
-or the node with render flag isntead.
-
-This plugin is part of publish process guide.
-"""
-
+"""Creator for Unreal Static Meshes."""
 from openpype.hosts.houdini.api import plugin
 from openpype.lib import BoolDef, EnumDef
 
@@ -25,30 +9,23 @@ import hou
 class CreateUnrealStaticMesh(plugin.HoudiniCreator):
     """Unreal Static Meshes with collisions. """
 
-    # you should set
     identifier = "io.openpype.creators.houdini.unrealstaticmesh.fbx"
     label = "Unreal - Static Mesh (FBX)"
     family = "staticMesh"
     icon = "fa5s.cubes"
 
-    # optional to set
-    default_variant = "Main"
-    # 'default_variants' will be overriden by settings.
-    default_variants = ["Main", "Test"]
+    default_variants = ["Main"]
 
-    # Overrides HoudiniCreator.create()
     def create(self, subset_name, instance_data, pre_create_data):
 
-        # set node type
         instance_data.update({"node_type": "filmboxfbx"})
 
-        # create instance (calls HoudiniCreator.create())
         instance = super(CreateUnrealStaticMesh, self).create(
             subset_name,
             instance_data,
             pre_create_data)
 
-        # get the created node
+        # get the created rop node
         instance_node = hou.node(instance.get("instance_node"))
 
         # get parms
@@ -61,21 +38,19 @@ class CreateUnrealStaticMesh(plugin.HoudiniCreator):
         to_lock = ["family", "id"]
         self.lock_parameters(instance_node, to_lock)
 
-    # Overrides HoudiniCreator.get_network_categories()
     def get_network_categories(self):
         return [
             hou.ropNodeTypeCategory(),
             hou.sopNodeTypeCategory()
         ]
 
-    # Overrides HoudiniCreator.get_pre_create_attr_defs()
     def get_pre_create_attr_defs(self):
         """Add settings for users. """
 
         attrs = super().get_pre_create_attr_defs()
         createsubnetroot = BoolDef("createsubnetroot",
                                    tooltip="Create an extra root for the "
-                                           "Export node when it’s a "
+                                           "Export node when it's a "
                                            "subnetwork. This causes the "
                                            "exporting subnetwork node to be "
                                            "represented in the FBX file.",
@@ -98,7 +73,6 @@ class CreateUnrealStaticMesh(plugin.HoudiniCreator):
 
         return attrs + [createsubnetroot, vcformat, convert_units]
 
-    # Overrides BaseCreator.get_dynamic_data()
     def get_dynamic_data(
         self, variant, task_name, asset_doc, project_name, host_name, instance
     ):
@@ -113,7 +87,7 @@ class CreateUnrealStaticMesh(plugin.HoudiniCreator):
         return dynamic_data
 
     def get_parms(self, subset_name, pre_create_data):
-        """Get parameters values for this specific node."""
+        """Get parameters values. """
 
         # 1. get output path
         output_path = hou.text.expandString(
diff --git a/openpype/hosts/houdini/plugins/publish/collect_fbx_type.py b/openpype/hosts/houdini/plugins/publish/collect_fbx_type.py
deleted file mode 100644
index 6ac40a4f50..0000000000
--- a/openpype/hosts/houdini/plugins/publish/collect_fbx_type.py
+++ /dev/null
@@ -1,33 +0,0 @@
-"""Collector for filmboxfbx types.
-
-Collectors act as a pre process for the validation stage.
-It is used mainly to update instance.data
-
-P.S.
-    There are some collectors that run by default
-    for all types.
-
-This plugin is part of publish process guide.
-"""
-import pyblish.api
-
-
-class CollectFilmboxfbxType(pyblish.api.InstancePlugin):
-    """Collect data type for fbx instance."""
-
-    hosts = ["houdini"]
-    families = ["staticMesh"]
-    label = "Collect type of fbx"
-
-    # Usually you will use this value as default
-    order = pyblish.api.CollectorOrder
-
-    # overrides InstancePlugin.process()
-    def process(self, instance):
-
-        if instance.data["creator_identifier"] == "io.openpype.creators.houdini.unrealstaticmesh.fbx":  # noqa: E501
-            # such a condition can be used to differentiate between
-            #  instances by identifier because sometimes instances
-            #  may have the same family but different identifier
-            #  e.g. bgeo and alembic
-            instance.data["families"] += ["fbx"]
diff --git a/openpype/hosts/houdini/plugins/publish/collect_staticmesh_type.py b/openpype/hosts/houdini/plugins/publish/collect_staticmesh_type.py
new file mode 100644
index 0000000000..8fb07c1c5c
--- /dev/null
+++ b/openpype/hosts/houdini/plugins/publish/collect_staticmesh_type.py
@@ -0,0 +1,20 @@
+# -*- coding: utf-8 -*-
+"""Collector for staticMesh types. """
+
+import pyblish.api
+
+
+class CollectStaticMeshType(pyblish.api.InstancePlugin):
+    """Collect data type for fbx instance."""
+
+    hosts = ["houdini"]
+    families = ["staticMesh"]
+    label = "Collect type of staticMesh"
+
+    order = pyblish.api.CollectorOrder
+
+    def process(self, instance):
+
+        if instance.data["creator_identifier"] == "io.openpype.creators.houdini.unrealstaticmesh.fbx":  # noqa: E501
+            # Marking this instance as FBX which triggers the FBX extractor.
+            instance.data["families"] += ["fbx"]
diff --git a/openpype/hosts/houdini/plugins/publish/validate_primitive_hierarchy_paths.py b/openpype/hosts/houdini/plugins/publish/validate_primitive_hierarchy_paths.py
index 930978ef16..471fa5b6d1 100644
--- a/openpype/hosts/houdini/plugins/publish/validate_primitive_hierarchy_paths.py
+++ b/openpype/hosts/houdini/plugins/publish/validate_primitive_hierarchy_paths.py
@@ -26,7 +26,7 @@ class ValidatePrimitiveHierarchyPaths(pyblish.api.InstancePlugin):
     order = ValidateContentsOrder + 0.1
     families = ["abc"]
     hosts = ["houdini"]
-    label = "Validate Prims Hierarchy Path (ABC)"
+    label = "Validate Prims Hierarchy Path"
     actions = [AddDefaultPathAction]
 
     def process(self, instance):

From ad62e1fd469fe122b9b7490a5d68b49db26741b2 Mon Sep 17 00:00:00 2001
From: Mustafa-Zarkash <mustafataherzaky@outlook.com>
Date: Mon, 4 Sep 2023 15:06:42 +0300
Subject: [PATCH 146/366] revise collect-validators-extract

---
 .../hosts/houdini/plugins/load/load_fbx.py    | 21 ++----
 .../publish/collect_staticmesh_type.py        |  2 +-
 .../houdini/plugins/publish/extract_fbx.py    | 13 +---
 .../publish/validate_mesh_is_static.py        | 70 +++++++++++++++++++
 .../plugins/publish/validate_output_node.py   | 55 +++++++++++++++
 .../publish/validate_sop_output_node.py       |  2 +-
 .../validate_unreal_staticmesh_naming.py      |  9 ++-
 7 files changed, 142 insertions(+), 30 deletions(-)
 create mode 100644 openpype/hosts/houdini/plugins/publish/validate_mesh_is_static.py
 create mode 100644 openpype/hosts/houdini/plugins/publish/validate_output_node.py

diff --git a/openpype/hosts/houdini/plugins/load/load_fbx.py b/openpype/hosts/houdini/plugins/load/load_fbx.py
index 681837e046..9c7dbf578e 100644
--- a/openpype/hosts/houdini/plugins/load/load_fbx.py
+++ b/openpype/hosts/houdini/plugins/load/load_fbx.py
@@ -1,12 +1,5 @@
 # -*- coding: utf-8 -*-
-"""Fbx Loader for houdini.
-
-It's almost a copy of
-'load_bgeo.py'and 'load_alembic.py'
-however this one includes extra comments for demonstration.
-
-This plugin is part of publish process guide.
-"""
+"""Fbx Loader for houdini. """
 from openpype.pipeline import (
     load,
     get_representation_path,
@@ -15,17 +8,17 @@ from openpype.hosts.houdini.api import pipeline
 
 
 class FbxLoader(load.LoaderPlugin):
-    """Load fbx files to Houdini."""
+    """Load fbx files. """
 
     label = "Load FBX"
-    families = ["staticMesh", "fbx"]
-    representations = ["fbx"]
-
-    # Usually you will use these value as default
-    order = -10
     icon = "code-fork"
     color = "orange"
 
+    order = -10
+
+    families = ["staticMesh", "fbx"]
+    representations = ["fbx"]
+
     def load(self, context, name=None, namespace=None, data=None):
 
         # get file path
diff --git a/openpype/hosts/houdini/plugins/publish/collect_staticmesh_type.py b/openpype/hosts/houdini/plugins/publish/collect_staticmesh_type.py
index 8fb07c1c5c..263d7c1001 100644
--- a/openpype/hosts/houdini/plugins/publish/collect_staticmesh_type.py
+++ b/openpype/hosts/houdini/plugins/publish/collect_staticmesh_type.py
@@ -16,5 +16,5 @@ class CollectStaticMeshType(pyblish.api.InstancePlugin):
     def process(self, instance):
 
         if instance.data["creator_identifier"] == "io.openpype.creators.houdini.unrealstaticmesh.fbx":  # noqa: E501
-            # Marking this instance as FBX which triggers the FBX extractor.
+            # Marking this instance as FBX triggers the FBX extractor.
             instance.data["families"] += ["fbx"]
diff --git a/openpype/hosts/houdini/plugins/publish/extract_fbx.py b/openpype/hosts/houdini/plugins/publish/extract_fbx.py
index c0e84c00c8..2a95734ece 100644
--- a/openpype/hosts/houdini/plugins/publish/extract_fbx.py
+++ b/openpype/hosts/houdini/plugins/publish/extract_fbx.py
@@ -1,15 +1,8 @@
-"""Extract FilmBox FBX.
-
-Extractors are used to generate output and
-update representation dictionary.
-
-This plugin is part of publish process guide.
-"""
+# -*- coding: utf-8 -*-
+"""Fbx Extractor for houdini. """
 
 import os
-
 import pyblish.api
-
 from openpype.pipeline import publish
 from openpype.hosts.houdini.api.lib import render_rop
 
@@ -22,10 +15,8 @@ class ExtractFBX(publish.Extractor):
     families = ["fbx"]
     hosts = ["houdini"]
 
-    # Usually you will use this value as default
     order = pyblish.api.ExtractorOrder + 0.1
 
-    # overrides Extractor.process()
     def process(self, instance):
 
         # get rop node
diff --git a/openpype/hosts/houdini/plugins/publish/validate_mesh_is_static.py b/openpype/hosts/houdini/plugins/publish/validate_mesh_is_static.py
new file mode 100644
index 0000000000..90985b4239
--- /dev/null
+++ b/openpype/hosts/houdini/plugins/publish/validate_mesh_is_static.py
@@ -0,0 +1,70 @@
+# -*- coding: utf-8 -*-
+"""Validator for correct naming of Static Meshes."""
+import pyblish.api
+from openpype.pipeline import (
+    PublishValidationError,
+    OptionalPyblishPluginMixin
+)
+from openpype.pipeline.publish import ValidateContentsOrder
+
+from openpype.hosts.houdini.api.action import SelectInvalidAction
+
+import hou
+
+
+class ValidateMeshIsStatic(pyblish.api.InstancePlugin,
+                                   OptionalPyblishPluginMixin):
+    """Validate mesh is static.
+
+    It checks if output node is time dependant.
+    """
+
+    families = ["staticMesh"]
+    hosts = ["houdini"]
+    label = "Validate Mesh is Static"
+    order = ValidateContentsOrder + 0.1
+    actions = [SelectInvalidAction]
+
+    def process(self, instance):
+
+        invalid = self.get_invalid(instance)
+        if invalid:
+            nodes = [n.path() for n in invalid if isinstance(n, hou.Node)]
+            raise PublishValidationError(
+                "See log for details. "
+                "Invalid nodes: {0}".format(nodes)
+            )
+
+    @classmethod
+    def get_invalid(cls, instance):
+
+        invalid = []
+
+        output_node = instance.data.get("output_node")
+        if output_node is None:
+            cls.log.debug(
+                "No Output Node, skipping check.."
+            )
+            return
+
+
+
+        if output_node.name().isTimeDependent():
+            invalid.append(output_node)
+            cls.log.error(
+                "Output node '%s' is time dependent.",
+                output_node.name()
+            )
+
+        if output_node.childTypeCategory() == hou.objNodeTypeCategory():
+            for child in output_node.children():
+                    if output_node.name().isTimeDependent():
+                        invalid.append(child)
+                        cls.log.error(
+                            "Child node '%s' in '%s' "
+                            "his time dependent.",
+                            child.name(), output_node.path()
+                        )
+                        break
+
+        return invalid
diff --git a/openpype/hosts/houdini/plugins/publish/validate_output_node.py b/openpype/hosts/houdini/plugins/publish/validate_output_node.py
new file mode 100644
index 0000000000..99a6cda077
--- /dev/null
+++ b/openpype/hosts/houdini/plugins/publish/validate_output_node.py
@@ -0,0 +1,55 @@
+# -*- coding: utf-8 -*-
+import pyblish.api
+from openpype.pipeline import PublishValidationError
+from openpype.hosts.houdini.api.action import (
+    SelectInvalidAction,
+    SelectROPAction,
+)
+
+import hou
+
+
+class ValidateOutputNode(pyblish.api.InstancePlugin):
+    """Validate the instance Output Node.
+
+    This will ensure:
+        - The Output Node Path is set.
+        - The Output Node Path refers to an existing object.
+    """
+
+    order = pyblish.api.ValidatorOrder
+    families = ["fbx"]
+    hosts = ["houdini"]
+    label = "Validate Output Node"
+    actions = [SelectROPAction, SelectInvalidAction]
+
+    def process(self, instance):
+
+        invalid = self.get_invalid(instance)
+        if invalid:
+            raise PublishValidationError(
+                "Output node(s) are incorrect",
+                title="Invalid output node(s)"
+            )
+
+    @classmethod
+    def get_invalid(cls, instance):
+        output_node = instance.data.get("output_node")
+
+        if output_node is None:
+            rop_node = hou.node(instance.data["instance_node"])
+            cls.log.error(
+                "Output node in '%s' does not exist. "
+                "Ensure a valid output path is set.", rop_node.path()
+            )
+
+            return [rop_node]
+
+        if output_node.type().category().name() not in ["Sop", "Object"]:
+            cls.log.error(
+                "Output node %s is not a SOP or OBJ node. "
+                "It must point to a SOP or OBJ node, "
+                "instead found category type: %s"
+                % (output_node.path(), output_node.type().category().name())
+            )
+            return [output_node]
diff --git a/openpype/hosts/houdini/plugins/publish/validate_sop_output_node.py b/openpype/hosts/houdini/plugins/publish/validate_sop_output_node.py
index d9dee38680..9590e37d26 100644
--- a/openpype/hosts/houdini/plugins/publish/validate_sop_output_node.py
+++ b/openpype/hosts/houdini/plugins/publish/validate_sop_output_node.py
@@ -24,7 +24,7 @@ class ValidateSopOutputNode(pyblish.api.InstancePlugin):
     order = pyblish.api.ValidatorOrder
     families = ["pointcache", "vdbcache"]
     hosts = ["houdini"]
-    label = "Validate Output Node"
+    label = "Validate Output Node (SOP)"
     actions = [SelectROPAction, SelectInvalidAction]
 
     def process(self, instance):
diff --git a/openpype/hosts/houdini/plugins/publish/validate_unreal_staticmesh_naming.py b/openpype/hosts/houdini/plugins/publish/validate_unreal_staticmesh_naming.py
index 7820be4009..f1ea9b3844 100644
--- a/openpype/hosts/houdini/plugins/publish/validate_unreal_staticmesh_naming.py
+++ b/openpype/hosts/houdini/plugins/publish/validate_unreal_staticmesh_naming.py
@@ -53,8 +53,7 @@ class ValidateUnrealStaticMeshName(pyblish.api.InstancePlugin,
             nodes = [n.path() for n in invalid if isinstance(n, hou.Node)]
             raise PublishValidationError(
                 "See log for details. "
-                "Invalid nodes: {0}".format(nodes),
-                title=self.label
+                "Invalid nodes: {0}".format(nodes)
             )
 
     @classmethod
@@ -64,7 +63,11 @@ class ValidateUnrealStaticMeshName(pyblish.api.InstancePlugin,
 
         rop_node = hou.node(instance.data["instance_node"])
         output_node = instance.data.get("output_node")
-        cls.log.debug(cls.collision_prefixes)
+        if output_node is None:
+            cls.log.debug(
+                "No Output Node, skipping check.."
+            )
+            return
 
         # Check nodes names
         if output_node.childTypeCategory() == hou.objNodeTypeCategory():

From 8440d65949e76dd9aca42206df528a62625ea32b Mon Sep 17 00:00:00 2001
From: Kayla Man <moonyuet2008@hotmail.com>
Date: Mon, 4 Sep 2023 20:32:16 +0800
Subject: [PATCH 147/366] update on the ornatrix laoder

---
 openpype/hosts/max/api/pipeline.py            | 51 -------------------
 .../plugins/load/load_pointcache_ornatrix.py  | 46 ++++++++++++++---
 2 files changed, 38 insertions(+), 59 deletions(-)

diff --git a/openpype/hosts/max/api/pipeline.py b/openpype/hosts/max/api/pipeline.py
index d9a66c60f5..2ce96d16e1 100644
--- a/openpype/hosts/max/api/pipeline.py
+++ b/openpype/hosts/max/api/pipeline.py
@@ -15,10 +15,8 @@ from openpype.pipeline import (
 )
 from openpype.hosts.max.api.menu import OpenPypeMenu
 from openpype.hosts.max.api import lib
-from openpype.hosts.max.api.plugin import MS_CUSTOM_ATTRIB
 from openpype.hosts.max import MAX_HOST_DIR
 
-
 from pymxs import runtime as rt  # noqa
 
 log = logging.getLogger("openpype.hosts.max")
@@ -173,52 +171,3 @@ def containerise(name: str, nodes: list, context,
     if not lib.imprint(container_name, data):
         print(f"imprinting of {container_name} failed.")
     return container
-
-
-def load_custom_attribute_data():
-    """Re-loading the Openpype/AYON custom parameter built by the creator
-
-    Returns:
-        attribute: re-loading the custom OP attributes set in Maxscript
-    """
-    return rt.Execute(MS_CUSTOM_ATTRIB)
-
-
-def import_custom_attribute_data(container: str, selections: list):
-    """Importing the Openpype/AYON custom parameter built by the creator
-
-    Args:
-        container (str): target container which adds custom attributes
-        selections (list): nodes to be added into
-        group in custom attributes
-    """
-    attrs = load_custom_attribute_data()
-    modifier = rt.EmptyModifier()
-    rt.addModifier(container, modifier)
-    container.modifiers[0].name = "OP Data"
-    rt.custAttributes.add(container.modifiers[0], attrs)
-    nodes = {}
-    for i in selections:
-        nodes = {
-            str(i): rt.NodeTransformMonitor(node=i),
-        }
-    # Setting the property
-    rt.setProperty(
-        container.modifiers[0].openPypeData,
-        "all_handles", nodes.values())
-    rt.setProperty(
-        container.modifiers[0].openPypeData,
-        "sel_list", nodes.keys())
-
-
-def update_custom_attribute_data(container: str, selections: list):
-    """Updating the Openpype/AYON custom parameter built by the creator
-
-    Args:
-        container (str): target container which adds custom attributes
-        selections (list): nodes to be added into
-        group in custom attributes
-    """
-    if container.modifiers[0].name == "OP Data":
-        rt.deleteModifier(container, container.modifiers[0])
-    import_custom_attribute_data(container, selections)
diff --git a/openpype/hosts/max/plugins/load/load_pointcache_ornatrix.py b/openpype/hosts/max/plugins/load/load_pointcache_ornatrix.py
index 56cac00aeb..d3b7c61ff8 100644
--- a/openpype/hosts/max/plugins/load/load_pointcache_ornatrix.py
+++ b/openpype/hosts/max/plugins/load/load_pointcache_ornatrix.py
@@ -1,6 +1,15 @@
 import os
 from openpype.pipeline import load, get_representation_path
-from openpype.hosts.max.api.pipeline import containerise
+from openpype.hosts.max.api.pipeline import (
+    containerise,
+    import_custom_attribute_data,
+    update_custom_attribute_data
+)
+from openpype.hosts.max.api.lib import (
+    unique_namespace,
+    get_namespace,
+    object_transform_set
+)
 from openpype.hosts.max.api import lib
 from pymxs import runtime as rt
 
@@ -14,6 +23,7 @@ class OxAbcLoader(load.LoaderPlugin):
     order = -10
     icon = "code-fork"
     color = "orange"
+    postfix = "param"
 
     def load(self, context, name=None, namespace=None, data=None):
         plugin_list = get_plugins()
@@ -34,21 +44,37 @@ class OxAbcLoader(load.LoaderPlugin):
             if str(obj_type).startswith("Ox_"):
                 scene_object.append(obj)
 
-        abc_container = rt.Container(name=name)
+        namespace = unique_namespace(
+            name + "_",
+            suffix="_",
+        )
+
+        abc_container = rt.Container()
         for abc in scene_object:
             abc.Parent = abc_container
+            abc.name = f"{namespace}:{abc.name}"
+        # rename the abc container with namespace
+        abc_container_name = f"{namespace}:{name}_{self.postfix}"
+        abc_container.name = abc_container_name
+        import_custom_attribute_data(
+            abc_container, abc_container.Children)
 
         return containerise(
-            name, [abc_container], context, loader=self.__class__.__name__
+            name, [abc_container], context,
+            namespace, loader=self.__class__.__name__
         )
 
     def update(self, container, representation):
         path = get_representation_path(representation)
         node_name = container["instance_node"]
-        instance_name, _ = os.path.splitext(node_name)
-        container = rt.getNodeByName(instance_name)
-        for children in container.Children:
-            rt.Delete(children)
+        namespace, name = get_namespace(node_name)
+        sub_node_name = f"{namespace}:{name}_{self.postfix}"
+        inst_container = rt.getNodeByName(sub_node_name)
+        rt.Select(inst_container.Children)
+        transform_data = object_transform_set(inst_container.Children)
+        for prev_obj in rt.selection:
+            if rt.isValidNode(prev_obj):
+                rt.Delete(prev_obj)
 
         rt.AlembicImport.ImportToRoot = False
         rt.AlembicImport.CustomAttributes = True
@@ -61,9 +87,13 @@ class OxAbcLoader(load.LoaderPlugin):
             obj_type = rt.ClassOf(obj)
             if str(obj_type).startswith("Ox_"):
                 scene_object.append(obj)
-
+        update_custom_attribute_data(
+            inst_container, scene_object.Children)
         for abc in scene_object:
             abc.Parent = container
+            abc.name = f"{namespace}:{abc.name}"
+            abc.pos = transform_data[f"{abc.name}.transform"]
+            abc.scale = transform_data[f"{abc.name}.scale"]
 
         lib.imprint(
             container["instance_node"],

From 1678bd56032e8975301651c4bcdfb6ae1290dce6 Mon Sep 17 00:00:00 2001
From: Mustafa-Zarkash <mustafataherzaky@outlook.com>
Date: Mon, 4 Sep 2023 19:48:15 +0300
Subject: [PATCH 148/366] update fetch output

---
 .../validate_unreal_staticmesh_naming.py      | 27 +++++++++++++++++++
 1 file changed, 27 insertions(+)

diff --git a/openpype/hosts/houdini/plugins/publish/validate_unreal_staticmesh_naming.py b/openpype/hosts/houdini/plugins/publish/validate_unreal_staticmesh_naming.py
index f1ea9b3844..3c13f081a9 100644
--- a/openpype/hosts/houdini/plugins/publish/validate_unreal_staticmesh_naming.py
+++ b/openpype/hosts/houdini/plugins/publish/validate_unreal_staticmesh_naming.py
@@ -107,3 +107,30 @@ class ValidateUnrealStaticMeshName(pyblish.api.InstancePlugin,
             )
 
         return invalid
+
+    def get_outputs(self, output_node):
+
+        if output_node.childTypeCategory() == hou.objNodeTypeCategory():
+            out_list = [output_node]
+            for child in output_node.children():
+                out_list += self.get_outputs(child)
+
+            return out_list
+
+        elif output_node.childTypeCategory() == hou.sopNodeTypeCategory():
+            return [output_node, self.get_obj_output(output_node)]
+
+    def get_obj_output(self, obj_node):
+        """Find sop output node,   """
+
+        outputs = obj_node.subnetOutputs()
+
+        if not outputs:
+            return
+
+        elif len(outputs) == 1:
+            return outputs[0]
+
+        else:
+            return min(outputs,
+                       key=lambda node: node.evalParm('outputidx'))

From 79aab2534ea53931980b4bb44e52713047898c65 Mon Sep 17 00:00:00 2001
From: Mustafa-Zarkash <mustafataherzaky@outlook.com>
Date: Mon, 4 Sep 2023 21:59:04 +0300
Subject: [PATCH 149/366] update retrieving output nodes

---
 openpype/hosts/houdini/api/lib.py             | 39 ++++++++++++
 .../publish/validate_mesh_is_static.py        | 27 +++-----
 .../validate_unreal_staticmesh_naming.py      | 62 +++++--------------
 3 files changed, 65 insertions(+), 63 deletions(-)

diff --git a/openpype/hosts/houdini/api/lib.py b/openpype/hosts/houdini/api/lib.py
index 75c7ff9fee..0f1cfe0717 100644
--- a/openpype/hosts/houdini/api/lib.py
+++ b/openpype/hosts/houdini/api/lib.py
@@ -649,3 +649,42 @@ def get_color_management_preferences():
         "display": hou.Color.ocio_defaultDisplay(),
         "view": hou.Color.ocio_defaultView()
     }
+
+
+def get_obj_node_output(obj_node):
+    """Find output node.
+
+    get the output node with the minimum 'outputidx'
+     or the node with display flag.
+    """
+
+    outputs = obj_node.subnetOutputs()
+    if not outputs:
+        return
+
+    elif len(outputs) == 1:
+        return outputs[0]
+
+    else:
+        return min(outputs,
+                    key=lambda node: node.evalParm('outputidx'))
+
+
+def get_output_children(output_node, include_sops=True):
+    """Recursively return a list of all output nodes
+    contained in this node including this node.
+
+    It works in a similar manner to output_node.allNodes().
+    """
+    out_list = [output_node]
+
+    if output_node.childTypeCategory() == hou.objNodeTypeCategory():
+        for child in output_node.children():
+            out_list += get_output_children(child, include_sops=include_sops)
+
+    elif include_sops and output_node.childTypeCategory() == hou.sopNodeTypeCategory():
+        out =  get_obj_node_output(output_node)
+        if out:
+            out_list += [out]
+
+    return out_list
diff --git a/openpype/hosts/houdini/plugins/publish/validate_mesh_is_static.py b/openpype/hosts/houdini/plugins/publish/validate_mesh_is_static.py
index 90985b4239..36c8ef6d63 100644
--- a/openpype/hosts/houdini/plugins/publish/validate_mesh_is_static.py
+++ b/openpype/hosts/houdini/plugins/publish/validate_mesh_is_static.py
@@ -8,6 +8,7 @@ from openpype.pipeline import (
 from openpype.pipeline.publish import ValidateContentsOrder
 
 from openpype.hosts.houdini.api.action import SelectInvalidAction
+from openpype.hosts.houdini.api.lib import get_output_children
 
 import hou
 
@@ -47,24 +48,14 @@ class ValidateMeshIsStatic(pyblish.api.InstancePlugin,
             )
             return
 
+        all_outputs = get_output_children(output_node)
 
-
-        if output_node.name().isTimeDependent():
-            invalid.append(output_node)
-            cls.log.error(
-                "Output node '%s' is time dependent.",
-                output_node.name()
-            )
-
-        if output_node.childTypeCategory() == hou.objNodeTypeCategory():
-            for child in output_node.children():
-                    if output_node.name().isTimeDependent():
-                        invalid.append(child)
-                        cls.log.error(
-                            "Child node '%s' in '%s' "
-                            "his time dependent.",
-                            child.name(), output_node.path()
-                        )
-                        break
+        for output in all_outputs:
+            if output.isTimeDependent():
+                invalid.append(output)
+                cls.log.error(
+                    "Output node '%s' is time dependent.",
+                    output.path()
+                )
 
         return invalid
diff --git a/openpype/hosts/houdini/plugins/publish/validate_unreal_staticmesh_naming.py b/openpype/hosts/houdini/plugins/publish/validate_unreal_staticmesh_naming.py
index 3c13f081a9..5558b43258 100644
--- a/openpype/hosts/houdini/plugins/publish/validate_unreal_staticmesh_naming.py
+++ b/openpype/hosts/houdini/plugins/publish/validate_unreal_staticmesh_naming.py
@@ -8,6 +8,7 @@ from openpype.pipeline import (
 from openpype.pipeline.publish import ValidateContentsOrder
 
 from openpype.hosts.houdini.api.action import SelectInvalidAction
+from openpype.hosts.houdini.api.lib import get_output_children
 
 import hou
 
@@ -69,28 +70,26 @@ class ValidateUnrealStaticMeshName(pyblish.api.InstancePlugin,
             )
             return
 
+        if not rop_node.evalParm('buildfrompath'):
+            # This validator doesn't support naming check if
+            # building hierarchy from path' is used
+            cls.log.info(
+                "Using 'Build Hierarchy from Path Attribute', skipping check.."
+            )
+            return
+
         # Check nodes names
-        if output_node.childTypeCategory() == hou.objNodeTypeCategory():
-            for child in output_node.children():
-                for prefix in cls.collision_prefixes:
-                    if child.name().startswith(prefix):
-                        invalid.append(child)
-                        cls.log.error(
-                            "Invalid name: Child node '%s' in '%s' "
-                            "has a collision prefix '%s'",
-                            child.name(), output_node.path(), prefix
-                        )
-                        break
-        else:
-            cls.log.debug(output_node.name())
+        all_outputs = get_output_children(output_node, include_sops=False)
+        for output in all_outputs:
             for prefix in cls.collision_prefixes:
-                if output_node.name().startswith(prefix):
-                    invalid.append(output_node)
+                if output.name().startswith(prefix):
+                    invalid.append(output)
                     cls.log.error(
-                        "Invalid name: output node '%s' "
-                        "has a collision prefix '%s'",
-                        output_node.name(), prefix
+                        "Invalid node name: Node '%s' "
+                        "includes a collision prefix '%s'",
+                        output.path(), prefix
                     )
+                    break
 
         # Check subset name
         subset_name = "{}_{}{}".format(
@@ -107,30 +106,3 @@ class ValidateUnrealStaticMeshName(pyblish.api.InstancePlugin,
             )
 
         return invalid
-
-    def get_outputs(self, output_node):
-
-        if output_node.childTypeCategory() == hou.objNodeTypeCategory():
-            out_list = [output_node]
-            for child in output_node.children():
-                out_list += self.get_outputs(child)
-
-            return out_list
-
-        elif output_node.childTypeCategory() == hou.sopNodeTypeCategory():
-            return [output_node, self.get_obj_output(output_node)]
-
-    def get_obj_output(self, obj_node):
-        """Find sop output node,   """
-
-        outputs = obj_node.subnetOutputs()
-
-        if not outputs:
-            return
-
-        elif len(outputs) == 1:
-            return outputs[0]
-
-        else:
-            return min(outputs,
-                       key=lambda node: node.evalParm('outputidx'))

From 9ea11e7f2d90faf25487ebe2f8f7db4d461da018 Mon Sep 17 00:00:00 2001
From: Mustafa-Zarkash <mustafataherzaky@outlook.com>
Date: Mon, 4 Sep 2023 22:02:23 +0300
Subject: [PATCH 150/366] resolve hound

---
 openpype/hosts/houdini/api/lib.py                          | 7 ++++---
 .../houdini/plugins/publish/validate_mesh_is_static.py     | 2 +-
 2 files changed, 5 insertions(+), 4 deletions(-)

diff --git a/openpype/hosts/houdini/api/lib.py b/openpype/hosts/houdini/api/lib.py
index 0f1cfe0717..3e51912c26 100644
--- a/openpype/hosts/houdini/api/lib.py
+++ b/openpype/hosts/houdini/api/lib.py
@@ -667,7 +667,7 @@ def get_obj_node_output(obj_node):
 
     else:
         return min(outputs,
-                    key=lambda node: node.evalParm('outputidx'))
+                   key=lambda node: node.evalParm('outputidx'))
 
 
 def get_output_children(output_node, include_sops=True):
@@ -682,8 +682,9 @@ def get_output_children(output_node, include_sops=True):
         for child in output_node.children():
             out_list += get_output_children(child, include_sops=include_sops)
 
-    elif include_sops and output_node.childTypeCategory() == hou.sopNodeTypeCategory():
-        out =  get_obj_node_output(output_node)
+    elif include_sops and \
+            output_node.childTypeCategory() == hou.sopNodeTypeCategory():
+        out = get_obj_node_output(output_node)
         if out:
             out_list += [out]
 
diff --git a/openpype/hosts/houdini/plugins/publish/validate_mesh_is_static.py b/openpype/hosts/houdini/plugins/publish/validate_mesh_is_static.py
index 36c8ef6d63..25ab362a88 100644
--- a/openpype/hosts/houdini/plugins/publish/validate_mesh_is_static.py
+++ b/openpype/hosts/houdini/plugins/publish/validate_mesh_is_static.py
@@ -14,7 +14,7 @@ import hou
 
 
 class ValidateMeshIsStatic(pyblish.api.InstancePlugin,
-                                   OptionalPyblishPluginMixin):
+                           OptionalPyblishPluginMixin):
     """Validate mesh is static.
 
     It checks if output node is time dependant.

From 6c1385e2c94e263f9186609c272ab7c0503485d9 Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Mon, 4 Sep 2023 23:49:54 +0200
Subject: [PATCH 151/366] Inherit from correct new style creator

---
 .../hosts/maya/plugins/create/create_multiverse_usd_over.py     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

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 e1534dd68c..166dbf6515 100644
--- a/openpype/hosts/maya/plugins/create/create_multiverse_usd_over.py
+++ b/openpype/hosts/maya/plugins/create/create_multiverse_usd_over.py
@@ -6,7 +6,7 @@ from openpype.lib import (
 )
 
 
-class CreateMultiverseUsdOver(plugin.Creator):
+class CreateMultiverseUsdOver(plugin.MayaCreator):
     """Create Multiverse USD Override"""
 
     identifier = "io.openpype.creators.maya.mvusdoverride"

From 71bd10fffb7e3715108e0253203d28f32441998a Mon Sep 17 00:00:00 2001
From: Toke Jepsen <tokejepsen@gmail.com>
Date: Tue, 5 Sep 2023 08:32:22 +0100
Subject: [PATCH 152/366] Update
 openpype/hosts/maya/plugins/publish/extract_look.py
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/hosts/maya/plugins/publish/extract_look.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/hosts/maya/plugins/publish/extract_look.py b/openpype/hosts/maya/plugins/publish/extract_look.py
index ec01a817b3..043d88db6d 100644
--- a/openpype/hosts/maya/plugins/publish/extract_look.py
+++ b/openpype/hosts/maya/plugins/publish/extract_look.py
@@ -52,7 +52,7 @@ def find_paths_by_hash(texture_hash):
 
     """
     if AYON_SERVER_ENABLED:
-        raise ValueError(
+        raise KnownPublishError(
             "This is a bug. \"find_paths_by_hash\" is not compatible with "
             "AYON."
         )

From 93a9ae2a6fa977b523de16b9f524e76d2d5fbf86 Mon Sep 17 00:00:00 2001
From: Toke Stuart Jepsen <tokejepsen@gmail.com>
Date: Tue, 5 Sep 2023 08:33:49 +0100
Subject: [PATCH 153/366] Add TODO

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

diff --git a/openpype/hosts/maya/plugins/publish/extract_look.py b/openpype/hosts/maya/plugins/publish/extract_look.py
index 043d88db6d..2708a6d916 100644
--- a/openpype/hosts/maya/plugins/publish/extract_look.py
+++ b/openpype/hosts/maya/plugins/publish/extract_look.py
@@ -591,8 +591,8 @@ class ExtractLook(publish.Extractor):
         resources = instance.data["resources"]
         color_management = lib.get_color_management_preferences()
 
-        # Temporary disable all hardlinking, due to the feature not being used
-        # or properly working.
+        # TODO: Temporary disable all hardlinking, due to the feature not being
+        # used or properly working.
         self.log.info(
             "Forcing copy instead of hardlink."
         )

From d54111bd75843c4713cac3409c1770594ce634e2 Mon Sep 17 00:00:00 2001
From: Mustafa Taher <mustafataherzaky@outlook.com>
Date: Tue, 5 Sep 2023 11:59:12 +0300
Subject: [PATCH 154/366] Update docstring

Co-authored-by: Roy Nieterau <roy_nieterau@hotmail.com>
---
 openpype/hosts/houdini/api/lib.py | 15 +++++++++++++--
 1 file changed, 13 insertions(+), 2 deletions(-)

diff --git a/openpype/hosts/houdini/api/lib.py b/openpype/hosts/houdini/api/lib.py
index 3e51912c26..b108d0d881 100644
--- a/openpype/hosts/houdini/api/lib.py
+++ b/openpype/hosts/houdini/api/lib.py
@@ -654,8 +654,19 @@ def get_color_management_preferences():
 def get_obj_node_output(obj_node):
     """Find output node.
 
-    get the output node with the minimum 'outputidx'
-     or the node with display flag.
+    If the node has any output node return the 
+    output node with the minimum `outputidx`.
+    When no output is present return the node
+    with the display flag set. If no output node is
+    detected then None is returned.
+    
+    Arguments:
+        node (hou.Node): The node to retrieve a single
+            the output node for.
+    
+    Returns:
+        Optional[hou.Node]: The child output node.
+        
     """
 
     outputs = obj_node.subnetOutputs()

From 8ceedd7b60c58bf94cc1721f033bff89c0a2b121 Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Tue, 5 Sep 2023 17:56:09 +0200
Subject: [PATCH 155/366] Draft for implementing a native Maya USD creator next
 to the Multiverse USD creator

---
 openpype/hosts/maya/api/plugin.py             |  35 ++++
 .../maya/plugins/create/create_maya_usd.py    | 143 +++++++++++++++
 .../plugins/create/create_multiverse_usd.py   |   4 +
 .../hosts/maya/plugins/load/load_maya_usd.py  | 100 +++++++++++
 .../maya/plugins/publish/extract_maya_usd.py  | 168 ++++++++++++++++++
 .../plugins/publish/extract_multiverse_usd.py |   2 +-
 6 files changed, 451 insertions(+), 1 deletion(-)
 create mode 100644 openpype/hosts/maya/plugins/create/create_maya_usd.py
 create mode 100644 openpype/hosts/maya/plugins/load/load_maya_usd.py
 create mode 100644 openpype/hosts/maya/plugins/publish/extract_maya_usd.py

diff --git a/openpype/hosts/maya/api/plugin.py b/openpype/hosts/maya/api/plugin.py
index 3f383fafb8..058637c8b5 100644
--- a/openpype/hosts/maya/api/plugin.py
+++ b/openpype/hosts/maya/api/plugin.py
@@ -129,12 +129,34 @@ class MayaCreatorBase(object):
             shared_data["maya_cached_legacy_subsets"] = cache_legacy
         return shared_data
 
+    def get_publish_families(self):
+        """Return families for the instances of this creator.
+
+        Allow a Creator to define multiple families so that a creator can
+        e.g. specify `usd` and `usdMaya` and another USD creator can also
+        specify `usd` but apply different extractors like `usdMultiverse`.
+
+        There is no need to override this method if you only have the
+        primary family defined by the `family` property as that will always
+        be set.
+
+        Returns:
+            list: families for instances of this creator
+
+        """
+        return []
+
     def imprint_instance_node(self, node, data):
 
         # We never store the instance_node as value on the node since
         # it's the node name itself
         data.pop("instance_node", None)
 
+        # Don't store `families` since it's up to the creator itself
+        # to define the initial publish families - not a stored attribute of
+        # `families`
+        data.pop("families", None)
+
         # We store creator attributes at the root level and assume they
         # will not clash in names with `subset`, `task`, etc. and other
         # default names. This is just so these attributes in many cases
@@ -186,6 +208,11 @@ class MayaCreatorBase(object):
         # Explicitly re-parse the node name
         node_data["instance_node"] = node
 
+        # If the creator plug-in specifies
+        families = self.get_publish_families()
+        if families:
+            node_data["families"] = families
+
         return node_data
 
     def _default_collect_instances(self):
@@ -230,6 +257,14 @@ class MayaCreator(NewCreator, MayaCreatorBase):
         if pre_create_data.get("use_selection"):
             members = cmds.ls(selection=True)
 
+        # Allow a Creator to define multiple families
+        publish_families = self.get_publish_families()
+        if publish_families:
+            families = instance_data.setdefault("families", [])
+            for family in self.get_publish_families():
+                if family not in families:
+                    families.append(family)
+
         with lib.undo_chunk():
             instance_node = cmds.sets(members, name=subset_name)
             instance_data["instance_node"] = instance_node
diff --git a/openpype/hosts/maya/plugins/create/create_maya_usd.py b/openpype/hosts/maya/plugins/create/create_maya_usd.py
new file mode 100644
index 0000000000..298dc6a24f
--- /dev/null
+++ b/openpype/hosts/maya/plugins/create/create_maya_usd.py
@@ -0,0 +1,143 @@
+from openpype.hosts.maya.api import plugin, lib
+from openpype.lib import (
+    BoolDef,
+    NumberDef,
+    TextDef,
+    EnumDef
+)
+
+
+class CreateMayaUsd(plugin.MayaCreator):
+    """Create Maya USD Export"""
+
+    identifier = "io.openpype.creators.maya.mayausd"
+    label = "Maya USD"
+    family = "usd"
+    icon = "cubes"
+    description = "Create Maya USD Export"
+
+    def get_publish_families(self):
+        return ["usd", "mayaUsd"]
+
+    def get_instance_attr_defs(self):
+
+        defs = lib.collect_animation_defs()
+        defs.extend([
+            EnumDef("defaultUSDFormat",
+                    label="File format",
+                    items={
+                        "usdc": "Binary",
+                        "usda": "ASCII"
+                    },
+                    default="usdc"),
+            BoolDef("stripNamespaces",
+                    label="Strip Namespaces",
+                    default=True),
+            BoolDef("mergeTransformAndShape",
+                    label="Merge Transform and Shape",
+                    default=True),
+            # BoolDef("writeAncestors",
+            #         label="Write Ancestors",
+            #         default=True),
+            # BoolDef("flattenParentXforms",
+            #         label="Flatten Parent Xforms",
+            #         default=False),
+            # BoolDef("writeSparseOverrides",
+            #         label="Write Sparse Overrides",
+            #         default=False),
+            # BoolDef("useMetaPrimPath",
+            #         label="Use Meta Prim Path",
+            #         default=False),
+            # TextDef("customRootPath",
+            #         label="Custom Root Path",
+            #         default=''),
+            # TextDef("customAttributes",
+            #         label="Custom Attributes",
+            #         tooltip="Comma-separated list of attribute names",
+            #         default=''),
+            # TextDef("nodeTypesToIgnore",
+            #         label="Node Types to Ignore",
+            #         tooltip="Comma-separated list of node types to be ignored",
+            #         default=''),
+            # BoolDef("writeMeshes",
+            #         label="Write Meshes",
+            #         default=True),
+            # BoolDef("writeCurves",
+            #         label="Write Curves",
+            #         default=True),
+            # BoolDef("writeParticles",
+            #         label="Write Particles",
+            #         default=True),
+            # BoolDef("writeCameras",
+            #         label="Write Cameras",
+            #         default=False),
+            # BoolDef("writeLights",
+            #         label="Write Lights",
+            #         default=False),
+            # BoolDef("writeJoints",
+            #         label="Write Joints",
+            #         default=False),
+            # BoolDef("writeCollections",
+            #         label="Write Collections",
+            #         default=False),
+            # BoolDef("writePositions",
+            #         label="Write Positions",
+            #         default=True),
+            # BoolDef("writeNormals",
+            #         label="Write Normals",
+            #         default=True),
+            # BoolDef("writeUVs",
+            #         label="Write UVs",
+            #         default=True),
+            # BoolDef("writeColorSets",
+            #         label="Write Color Sets",
+            #         default=False),
+            # BoolDef("writeTangents",
+            #         label="Write Tangents",
+            #         default=False),
+            # BoolDef("writeRefPositions",
+            #         label="Write Ref Positions",
+            #         default=True),
+            # BoolDef("writeBlendShapes",
+            #         label="Write BlendShapes",
+            #         default=False),
+            # BoolDef("writeDisplayColor",
+            #         label="Write Display Color",
+            #         default=True),
+            # BoolDef("writeSkinWeights",
+            #         label="Write Skin Weights",
+            #         default=False),
+            # BoolDef("writeMaterialAssignment",
+            #         label="Write Material Assignment",
+            #         default=False),
+            # BoolDef("writeHardwareShader",
+            #         label="Write Hardware Shader",
+            #         default=False),
+            # BoolDef("writeShadingNetworks",
+            #         label="Write Shading Networks",
+            #         default=False),
+            # BoolDef("writeTransformMatrix",
+            #         label="Write Transform Matrix",
+            #         default=True),
+            # BoolDef("writeUsdAttributes",
+            #         label="Write USD Attributes",
+            #         default=True),
+            # BoolDef("writeInstancesAsReferences",
+            #         label="Write Instances as References",
+            #         default=False),
+            # BoolDef("timeVaryingTopology",
+            #         label="Time Varying Topology",
+            #         default=False),
+            # TextDef("customMaterialNamespace",
+            #         label="Custom Material Namespace",
+            #         default=''),
+            # NumberDef("numTimeSamples",
+            #           label="Num Time Samples",
+            #           default=1),
+            # NumberDef("timeSamplesSpan",
+            #           label="Time Samples Span",
+            #           default=0.0),
+            #
+        ])
+
+        return defs
diff --git a/openpype/hosts/maya/plugins/create/create_multiverse_usd.py b/openpype/hosts/maya/plugins/create/create_multiverse_usd.py
index 0b0ad3bccb..2963d4d5b6 100644
--- a/openpype/hosts/maya/plugins/create/create_multiverse_usd.py
+++ b/openpype/hosts/maya/plugins/create/create_multiverse_usd.py
@@ -14,6 +14,10 @@ class CreateMultiverseUsd(plugin.MayaCreator):
     label = "Multiverse USD Asset"
     family = "usd"
     icon = "cubes"
+    description = "Create Multiverse USD Asset"
+
+    def get_publish_families(self):
+        return ["usd", "mvUsd"]
 
     def get_instance_attr_defs(self):
 
diff --git a/openpype/hosts/maya/plugins/load/load_maya_usd.py b/openpype/hosts/maya/plugins/load/load_maya_usd.py
new file mode 100644
index 0000000000..26c497768d
--- /dev/null
+++ b/openpype/hosts/maya/plugins/load/load_maya_usd.py
@@ -0,0 +1,100 @@
+# -*- coding: utf-8 -*-
+import maya.cmds as cmds
+
+from openpype.pipeline import (
+    load,
+    get_representation_path,
+)
+from openpype.pipeline.load import get_representation_path_from_context
+from openpype.hosts.maya.api.lib import (
+    namespaced,
+    unique_namespace
+)
+from openpype.hosts.maya.api.pipeline import containerise
+
+
+class MayaUsdLoader(load.LoaderPlugin):
+    """Read USD data in a Maya USD Proxy"""
+
+    families = ["model", "usd", "pointcache", "animation"]
+    representations = ["usd", "usda", "usdc", "usdz", "abc"]
+
+    label = "Load USD to Maya Proxy"
+    order = -1
+    icon = "code-fork"
+    color = "orange"
+
+    def load(self, context, name=None, namespace=None, options=None):
+        asset = context['asset']['name']
+        namespace = namespace or unique_namespace(
+            asset + "_",
+            prefix="_" if asset[0].isdigit() else "",
+            suffix="_",
+        )
+
+        # Make sure we can load the plugin
+        cmds.loadPlugin("mayaUsdPlugin", quiet=True)
+
+        path = get_representation_path_from_context(context)
+
+        # Create the shape
+        cmds.namespace(addNamespace=namespace)
+        with namespaced(namespace, new=False):
+            transform = cmds.createNode("transform",
+                                        name=name,
+                                        skipSelect=True)
+            proxy = cmds.createNode('mayaUsdProxyShape',
+                                    name="{}Shape".format(name),
+                                    parent=transform,
+                                    skipSelect=True)
+
+            cmds.connectAttr("time1.outTime", "{}.time".format(proxy))
+            cmds.setAttr("{}.filePath".format(proxy), path, type="string")
+
+        nodes = [transform, proxy]
+        self[:] = nodes
+
+        return containerise(
+            name=name,
+            namespace=namespace,
+            nodes=nodes,
+            context=context,
+            loader=self.__class__.__name__)
+
+    def update(self, container, representation):
+        # type: (dict, dict) -> None
+        """Update container with specified representation."""
+        node = container['objectName']
+        assert cmds.objExists(node), "Missing container"
+
+        members = cmds.sets(node, query=True) or []
+        shapes = cmds.ls(members, type="mayaUsdProxyShape")
+
+        path = get_representation_path(representation)
+        for shape in shapes:
+            cmds.setAttr("{}.filePath".format(shape), path, type="string")
+
+        cmds.setAttr("{}.representation".format(node),
+                     str(representation["_id"]),
+                     type="string")
+
+    def switch(self, container, representation):
+        self.update(container, representation)
+
+    def remove(self, container):
+        # type: (dict) -> None
+        """Remove loaded container."""
+        # Delete container and its contents
+        if cmds.objExists(container['objectName']):
+            members = cmds.sets(container['objectName'], query=True) or []
+            cmds.delete([container['objectName']] + members)
+
+        # Remove the namespace, if empty
+        namespace = container['namespace']
+        if cmds.namespace(exists=namespace):
+            members = cmds.namespaceInfo(namespace, listNamespace=True)
+            if not members:
+                cmds.namespace(removeNamespace=namespace)
+            else:
+                self.log.warning("Namespace not deleted because it "
+                                 "still has members: %s", namespace)
diff --git a/openpype/hosts/maya/plugins/publish/extract_maya_usd.py b/openpype/hosts/maya/plugins/publish/extract_maya_usd.py
new file mode 100644
index 0000000000..3b95037d4c
--- /dev/null
+++ b/openpype/hosts/maya/plugins/publish/extract_maya_usd.py
@@ -0,0 +1,168 @@
+import os
+import six
+
+from maya import cmds
+
+import pyblish.api
+from openpype.pipeline import publish
+from openpype.hosts.maya.api.lib import maintained_selection
+
+
+class ExtractMayaUsd(publish.Extractor):
+    """Extractor for Maya USD Asset data.
+
+    Upon publish a .usd (or .usdz) asset file will typically be written.
+    """
+
+    label = "Extract Maya USD Asset"
+    hosts = ["maya"]
+    families = ["mayaUsd"]
+
+    @property
+    def options(self):
+        """Overridable options for Maya 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.
+
+        """
+
+        # TODO: Support more `mayaUSDExport` parameters
+        return {
+            "stripNamespaces": bool,
+            "mergeTransformAndShape": bool,
+            "exportDisplayColor": bool,
+            "exportColorSets": bool,
+            "exportInstances": bool,
+            "exportUVs": bool,
+            "exportVisibility": bool,
+            "exportComponentTags": bool,
+            "exportRefsAsInstanceable": bool,
+            "eulerFilter": bool,
+            "renderableOnly": bool,
+            #"worldspace": bool,
+        }
+
+    @property
+    def default_options(self):
+        """The default options for Maya USD Export."""
+
+        # TODO: Support more `mayaUSDExport` parameters
+        return {
+            "stripNamespaces": False,
+            "mergeTransformAndShape": False,
+            "exportDisplayColor": False,
+            "exportColorSets": True,
+            "exportInstances": True,
+            "exportUVs": True,
+            "exportVisibility": True,
+            "exportComponentTags": True,
+            "exportRefsAsInstanceable": False,
+            "eulerFilter": True,
+            "renderableOnly": False,
+            #"worldspace": False
+        }
+
+    def parse_overrides(self, instance, options):
+        """Inspect data of instance to determine overridden options"""
+
+        for key in instance.data:
+            if key not in self.options:
+                continue
+
+            # Ensure the data is of correct type
+            value = instance.data[key]
+            if isinstance(value, six.text_type):
+                value = str(value)
+            if not isinstance(value, self.options[key]):
+                self.log.warning(
+                    "Overridden attribute {key} was of "
+                    "the wrong type: {invalid_type} "
+                    "- should have been {valid_type}".format(
+                        key=key,
+                        invalid_type=type(value).__name__,
+                        valid_type=self.options[key].__name__))
+                continue
+
+            options[key] = value
+
+        return options
+
+    def filter_members(self, members):
+        # Can be overridden by inherited classes
+        return members
+
+    def process(self, instance):
+
+        # Load plugin first
+        cmds.loadPlugin("mayaUsdPlugin", quiet=True)
+
+        # Define output file path
+        staging_dir = self.staging_dir(instance)
+        file_name = "{0}.usd".format(instance.name)
+        file_path = os.path.join(staging_dir, file_name)
+        file_path = file_path.replace('\\', '/')
+
+        # Parse export options
+        options = self.default_options
+        options = self.parse_overrides(instance, options)
+        self.log.info("Export options: {0}".format(options))
+
+        # Perform extraction
+        self.log.debug("Performing extraction ...")
+
+        members = instance.data("setMembers")
+        self.log.debug('Collected objects: {}'.format(members))
+        members = self.filter_members(members)
+        if not members:
+            self.log.error('No members!')
+            return
+
+        start = instance.data["frameStartHandle"]
+        end = instance.data["frameEndHandle"]
+
+        with maintained_selection():
+            self.log.debug('Exporting USD: {} / {}'.format(file_path, members))
+            cmds.mayaUSDExport(file=file_path,
+                               frameRange=(start, end),
+                               frameStride=instance.data.get("step", 1.0),
+                               exportRoots=members,
+                               **options)
+
+        representation = {
+            'name': "usd",
+            'ext': "usd",
+            'files': file_name,
+            'stagingDir': staging_dir
+        }
+        instance.data.setdefault("representations", []).append(representation)
+
+        self.log.debug(
+            "Extracted instance {} to {}".format(instance.name, file_path)
+        )
+
+
+class ExtractMayaUsdAnim(ExtractMayaUsd):
+    """Extractor for Maya USD Animation Sparse Cache data.
+
+    This will extract the sparse cache data from the scene and generate a
+    USD file with all the animation data.
+
+    Upon publish a .usd sparse cache will be written.
+    """
+    label = "Extract Maya USD Animation Sparse Cache"
+    families = ["animation", "mayaUsd"]
+    match = pyblish.api.Subset
+
+    def filter_members(self, members):
+        out_set = next((i for i in members if i.endswith("out_SET")), None)
+
+        if out_set is None:
+            self.log.warning("Expecting out_SET")
+            return None
+
+        members = cmds.ls(cmds.sets(out_set, query=True), long=True)
+        return members
diff --git a/openpype/hosts/maya/plugins/publish/extract_multiverse_usd.py b/openpype/hosts/maya/plugins/publish/extract_multiverse_usd.py
index 4399eacda1..e0a1369556 100644
--- a/openpype/hosts/maya/plugins/publish/extract_multiverse_usd.py
+++ b/openpype/hosts/maya/plugins/publish/extract_multiverse_usd.py
@@ -28,7 +28,7 @@ class ExtractMultiverseUsd(publish.Extractor):
 
     label = "Extract Multiverse USD Asset"
     hosts = ["maya"]
-    families = ["usd"]
+    families = ["mvUsd"]
     scene_type = "usd"
     file_formats = ["usd", "usda", "usdz"]
 

From 90417a42c38e6197583969d2549de2b3b810568d Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Tue, 5 Sep 2023 17:56:30 +0200
Subject: [PATCH 156/366] Allow loading USD into Arnold Standin in Maya

---
 openpype/hosts/maya/plugins/load/load_arnold_standin.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/openpype/hosts/maya/plugins/load/load_arnold_standin.py b/openpype/hosts/maya/plugins/load/load_arnold_standin.py
index b5cc4d629b..e1bd1954fa 100644
--- a/openpype/hosts/maya/plugins/load/load_arnold_standin.py
+++ b/openpype/hosts/maya/plugins/load/load_arnold_standin.py
@@ -32,8 +32,8 @@ def get_current_session_fps():
 class ArnoldStandinLoader(load.LoaderPlugin):
     """Load as Arnold standin"""
 
-    families = ["ass", "animation", "model", "proxyAbc", "pointcache"]
-    representations = ["ass", "abc"]
+    families = ["ass", "animation", "model", "proxyAbc", "pointcache", "usd"]
+    representations = ["ass", "abc", "usda", "usdc", "usd"]
 
     label = "Load as Arnold standin"
     order = -5

From 4456ac86f41e7fa529b5f07d32da6e71f601128d Mon Sep 17 00:00:00 2001
From: Ondrej Samohel <ondrej.samohel@ynput.io>
Date: Tue, 5 Sep 2023 17:56:49 +0200
Subject: [PATCH 157/366] :art: add default isort config

---
 setup.cfg | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/setup.cfg b/setup.cfg
index 10cca3eb3f..216bae848f 100644
--- a/setup.cfg
+++ b/setup.cfg
@@ -28,4 +28,11 @@ omit = /tests
 directory = ./coverage
 
 [tool:pytest]
-norecursedirs = repos/* openpype/modules/ftrack/*
\ No newline at end of file
+norecursedirs = repos/* openpype/modules/ftrack/*
+
+[isort]
+line_length = 79
+multi_line_output = 3
+include_trailing_comma = True
+force_grid_wrap = 0
+combine_as_imports = True

From 34b15587c11005ca9c2d7db77f44fa18ebb37f4e Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Tue, 5 Sep 2023 18:00:23 +0200
Subject: [PATCH 158/366] Cosmetics

---
 openpype/hosts/maya/plugins/load/load_arnold_standin.py | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/openpype/hosts/maya/plugins/load/load_arnold_standin.py b/openpype/hosts/maya/plugins/load/load_arnold_standin.py
index e1bd1954fa..2e1329f201 100644
--- a/openpype/hosts/maya/plugins/load/load_arnold_standin.py
+++ b/openpype/hosts/maya/plugins/load/load_arnold_standin.py
@@ -17,6 +17,7 @@ from openpype.hosts.maya.api.lib import (
 )
 from openpype.hosts.maya.api.pipeline import containerise
 
+
 def is_sequence(files):
     sequence = False
     collections, remainder = clique.assemble(files, minimum_items=1)
@@ -29,6 +30,7 @@ def get_current_session_fps():
     session_fps = float(legacy_io.Session.get('AVALON_FPS', 25))
     return convert_to_maya_fps(session_fps)
 
+
 class ArnoldStandinLoader(load.LoaderPlugin):
     """Load as Arnold standin"""
 

From 5c12d9c8621130703d063ec5aba0fef832d479ac Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Tue, 5 Sep 2023 18:04:21 +0200
Subject: [PATCH 159/366] Remove commented out attribute definitions

---
 .../maya/plugins/create/create_maya_usd.py    | 106 +-----------------
 1 file changed, 1 insertion(+), 105 deletions(-)

diff --git a/openpype/hosts/maya/plugins/create/create_maya_usd.py b/openpype/hosts/maya/plugins/create/create_maya_usd.py
index 298dc6a24f..554b8169db 100644
--- a/openpype/hosts/maya/plugins/create/create_maya_usd.py
+++ b/openpype/hosts/maya/plugins/create/create_maya_usd.py
@@ -1,8 +1,6 @@
 from openpype.hosts.maya.api import plugin, lib
 from openpype.lib import (
     BoolDef,
-    NumberDef,
-    TextDef,
     EnumDef
 )
 
@@ -35,109 +33,7 @@ class CreateMayaUsd(plugin.MayaCreator):
                     default=True),
             BoolDef("mergeTransformAndShape",
                     label="Merge Transform and Shape",
-                    default=True),
-            # BoolDef("writeAncestors",
-            #         label="Write Ancestors",
-            #         default=True),
-            # BoolDef("flattenParentXforms",
-            #         label="Flatten Parent Xforms",
-            #         default=False),
-            # BoolDef("writeSparseOverrides",
-            #         label="Write Sparse Overrides",
-            #         default=False),
-            # BoolDef("useMetaPrimPath",
-            #         label="Use Meta Prim Path",
-            #         default=False),
-            # TextDef("customRootPath",
-            #         label="Custom Root Path",
-            #         default=''),
-            # TextDef("customAttributes",
-            #         label="Custom Attributes",
-            #         tooltip="Comma-separated list of attribute names",
-            #         default=''),
-            # TextDef("nodeTypesToIgnore",
-            #         label="Node Types to Ignore",
-            #         tooltip="Comma-separated list of node types to be ignored",
-            #         default=''),
-            # BoolDef("writeMeshes",
-            #         label="Write Meshes",
-            #         default=True),
-            # BoolDef("writeCurves",
-            #         label="Write Curves",
-            #         default=True),
-            # BoolDef("writeParticles",
-            #         label="Write Particles",
-            #         default=True),
-            # BoolDef("writeCameras",
-            #         label="Write Cameras",
-            #         default=False),
-            # BoolDef("writeLights",
-            #         label="Write Lights",
-            #         default=False),
-            # BoolDef("writeJoints",
-            #         label="Write Joints",
-            #         default=False),
-            # BoolDef("writeCollections",
-            #         label="Write Collections",
-            #         default=False),
-            # BoolDef("writePositions",
-            #         label="Write Positions",
-            #         default=True),
-            # BoolDef("writeNormals",
-            #         label="Write Normals",
-            #         default=True),
-            # BoolDef("writeUVs",
-            #         label="Write UVs",
-            #         default=True),
-            # BoolDef("writeColorSets",
-            #         label="Write Color Sets",
-            #         default=False),
-            # BoolDef("writeTangents",
-            #         label="Write Tangents",
-            #         default=False),
-            # BoolDef("writeRefPositions",
-            #         label="Write Ref Positions",
-            #         default=True),
-            # BoolDef("writeBlendShapes",
-            #         label="Write BlendShapes",
-            #         default=False),
-            # BoolDef("writeDisplayColor",
-            #         label="Write Display Color",
-            #         default=True),
-            # BoolDef("writeSkinWeights",
-            #         label="Write Skin Weights",
-            #         default=False),
-            # BoolDef("writeMaterialAssignment",
-            #         label="Write Material Assignment",
-            #         default=False),
-            # BoolDef("writeHardwareShader",
-            #         label="Write Hardware Shader",
-            #         default=False),
-            # BoolDef("writeShadingNetworks",
-            #         label="Write Shading Networks",
-            #         default=False),
-            # BoolDef("writeTransformMatrix",
-            #         label="Write Transform Matrix",
-            #         default=True),
-            # BoolDef("writeUsdAttributes",
-            #         label="Write USD Attributes",
-            #         default=True),
-            # BoolDef("writeInstancesAsReferences",
-            #         label="Write Instances as References",
-            #         default=False),
-            # BoolDef("timeVaryingTopology",
-            #         label="Time Varying Topology",
-            #         default=False),
-            # TextDef("customMaterialNamespace",
-            #         label="Custom Material Namespace",
-            #         default=''),
-            # NumberDef("numTimeSamples",
-            #           label="Num Time Samples",
-            #           default=1),
-            # NumberDef("timeSamplesSpan",
-            #           label="Time Samples Span",
-            #           default=0.0),
-            #
+                    default=True)
         ])
 
         return defs

From d6f2ace99d87d2cb8069c02de72c6f7244a222bf Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Tue, 5 Sep 2023 18:04:57 +0200
Subject: [PATCH 160/366] Cosmetics

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

diff --git a/openpype/hosts/maya/plugins/publish/extract_maya_usd.py b/openpype/hosts/maya/plugins/publish/extract_maya_usd.py
index 3b95037d4c..70508042c0 100644
--- a/openpype/hosts/maya/plugins/publish/extract_maya_usd.py
+++ b/openpype/hosts/maya/plugins/publish/extract_maya_usd.py
@@ -43,7 +43,7 @@ class ExtractMayaUsd(publish.Extractor):
             "exportRefsAsInstanceable": bool,
             "eulerFilter": bool,
             "renderableOnly": bool,
-            #"worldspace": bool,
+            # "worldspace": bool,
         }
 
     @property
@@ -63,7 +63,7 @@ class ExtractMayaUsd(publish.Extractor):
             "exportRefsAsInstanceable": False,
             "eulerFilter": True,
             "renderableOnly": False,
-            #"worldspace": False
+            # "worldspace": False
         }
 
     def parse_overrides(self, instance, options):

From 45f86749e165f3825ccdff4dbe8200180f4369b8 Mon Sep 17 00:00:00 2001
From: Mustafa-Zarkash <mustafataherzaky@outlook.com>
Date: Tue, 5 Sep 2023 19:52:13 +0300
Subject: [PATCH 161/366] resolve some comments

---
 .../create/create_unreal_staticmesh.py        | 50 +++-------
 .../hosts/houdini/plugins/load/load_fbx.py    |  2 +-
 .../houdini/plugins/publish/extract_fbx.py    | 45 +++------
 ...ut_node.py => validate_fbx_output_node.py} |  3 +-
 .../publish/validate_mesh_is_static.py        |  2 +-
 .../plugins/publish/validate_subset_name.py   | 94 +++++++++++++++++++
 .../validate_unreal_staticmesh_naming.py      | 21 +----
 .../defaults/project_settings/houdini.json    | 10 ++
 .../schemas/schema_houdini_publish.json       |  8 ++
 .../server/settings/publish_plugins.py        | 16 ++++
 10 files changed, 164 insertions(+), 87 deletions(-)
 rename openpype/hosts/houdini/plugins/publish/{validate_output_node.py => validate_fbx_output_node.py} (93%)
 create mode 100644 openpype/hosts/houdini/plugins/publish/validate_subset_name.py

diff --git a/openpype/hosts/houdini/plugins/create/create_unreal_staticmesh.py b/openpype/hosts/houdini/plugins/create/create_unreal_staticmesh.py
index ca5e2e8fb4..fc3783c0d1 100644
--- a/openpype/hosts/houdini/plugins/create/create_unreal_staticmesh.py
+++ b/openpype/hosts/houdini/plugins/create/create_unreal_staticmesh.py
@@ -28,8 +28,18 @@ class CreateUnrealStaticMesh(plugin.HoudiniCreator):
         # get the created rop node
         instance_node = hou.node(instance.get("instance_node"))
 
-        # get parms
-        parms = self.get_parms(subset_name, pre_create_data)
+        # prepare parms
+        output_path = hou.text.expandString("$HIP/pyblish/{}.fbx".format(subset_name))
+        parms = {
+            "startnode": self.get_selection(),
+            "sopoutput": output_path,
+            # vertex cache format
+            "vcformat": pre_create_data.get("vcformat"),
+            "convertunits": pre_create_data.get("convertunits"),
+            # set render range to use frame range start-end frame
+            "trange": 1,
+            "createsubnetroot": pre_create_data.get("createsubnetroot")
+        }
 
         # set parms
         instance_node.setParms(parms)
@@ -47,7 +57,7 @@ class CreateUnrealStaticMesh(plugin.HoudiniCreator):
     def get_pre_create_attr_defs(self):
         """Add settings for users. """
 
-        attrs = super().get_pre_create_attr_defs()
+        attrs = super(CreateUnrealStaticMesh, self).get_pre_create_attr_defs()
         createsubnetroot = BoolDef("createsubnetroot",
                                    tooltip="Create an extra root for the "
                                            "Export node when it's a "
@@ -86,40 +96,6 @@ class CreateUnrealStaticMesh(plugin.HoudiniCreator):
         dynamic_data["asset"] = asset_doc["name"]
         return dynamic_data
 
-    def get_parms(self, subset_name, pre_create_data):
-        """Get parameters values. """
-
-        # 1. get output path
-        output_path = hou.text.expandString(
-            "$HIP/pyblish/{}.fbx".format(subset_name))
-
-        # 2. get selection
-        selection = self.get_selection()
-
-        # 3. get Vertex Cache Format
-        vcformat = pre_create_data.get("vcformat")
-
-        # 4. get convert_units
-        convertunits = pre_create_data.get("convertunits")
-
-        # 5. get Valid Frame Range
-        trange = 1
-
-        # 6. get createsubnetroot
-        createsubnetroot = pre_create_data.get("createsubnetroot")
-
-        # parms dictionary
-        parms = {
-            "startnode": selection,
-            "sopoutput": output_path,
-            "vcformat": vcformat,
-            "convertunits": convertunits,
-            "trange": trange,
-            "createsubnetroot": createsubnetroot
-        }
-
-        return parms
-
     def get_selection(self):
         """Selection Logic.
 
diff --git a/openpype/hosts/houdini/plugins/load/load_fbx.py b/openpype/hosts/houdini/plugins/load/load_fbx.py
index 9c7dbf578e..7e7f0c04e5 100644
--- a/openpype/hosts/houdini/plugins/load/load_fbx.py
+++ b/openpype/hosts/houdini/plugins/load/load_fbx.py
@@ -146,5 +146,5 @@ class FbxLoader(load.LoaderPlugin):
         # Set new position for children nodes
         parent_node.layoutChildren()
 
-        # Retrun all the nodes
+        # Return all the nodes
         return [parent_node, file_node, attribdelete, null]
diff --git a/openpype/hosts/houdini/plugins/publish/extract_fbx.py b/openpype/hosts/houdini/plugins/publish/extract_fbx.py
index 2a95734ece..e8cd207818 100644
--- a/openpype/hosts/houdini/plugins/publish/extract_fbx.py
+++ b/openpype/hosts/houdini/plugins/publish/extract_fbx.py
@@ -21,40 +21,17 @@ class ExtractFBX(publish.Extractor):
 
         # get rop node
         ropnode = hou.node(instance.data.get("instance_node"))
+        output_node = ropnode.evalParm("sopoutput")
+
+        # get staging_dir and file_name
+        staging_dir = os.path.normpath(os.path.dirname(output_node))
+        file_name = os.path.basename(output_node)
 
         # render rop
+        self.log.debug("Writing FBX '%s' to '%s'",file_name, staging_dir)
         render_rop(ropnode)
 
-        # get required data
-        file_name, staging_dir = self.get_paths_data(ropnode)
-        representation = self.get_representation(instance,
-                                                 file_name,
-                                                 staging_dir)
-
-        # set value type for 'representations' key to list
-        if "representations" not in instance.data:
-            instance.data["representations"] = []
-
-        # update instance data
-        instance.data["stagingDir"] = staging_dir
-        instance.data["representations"].append(representation)
-
-    def get_paths_data(self, ropnode):
-        # Get the filename from the filename parameter
-        output = ropnode.evalParm("sopoutput")
-
-        staging_dir = os.path.normpath(os.path.dirname(output))
-
-        file_name = os.path.basename(output)
-
-        self.log.info("Writing FBX '%s' to '%s'" % (file_name,
-                                                    staging_dir))
-
-        return file_name, staging_dir
-
-    def get_representation(self, instance,
-                           file_name, staging_dir):
-
+        # prepare representation
         representation = {
             "name": "fbx",
             "ext": "fbx",
@@ -67,4 +44,10 @@ class ExtractFBX(publish.Extractor):
             representation["frameStart"] = instance.data["frameStart"]
             representation["frameEnd"] = instance.data["frameEnd"]
 
-        return representation
+        # set value type for 'representations' key to list
+        if "representations" not in instance.data:
+            instance.data["representations"] = []
+
+        # update instance data
+        instance.data["stagingDir"] = staging_dir
+        instance.data["representations"].append(representation)
diff --git a/openpype/hosts/houdini/plugins/publish/validate_output_node.py b/openpype/hosts/houdini/plugins/publish/validate_fbx_output_node.py
similarity index 93%
rename from openpype/hosts/houdini/plugins/publish/validate_output_node.py
rename to openpype/hosts/houdini/plugins/publish/validate_fbx_output_node.py
index 99a6cda077..503a3bb3c1 100644
--- a/openpype/hosts/houdini/plugins/publish/validate_output_node.py
+++ b/openpype/hosts/houdini/plugins/publish/validate_fbx_output_node.py
@@ -9,12 +9,13 @@ from openpype.hosts.houdini.api.action import (
 import hou
 
 
-class ValidateOutputNode(pyblish.api.InstancePlugin):
+class ValidateFBXOutputNode(pyblish.api.InstancePlugin):
     """Validate the instance Output Node.
 
     This will ensure:
         - The Output Node Path is set.
         - The Output Node Path refers to an existing object.
+        - The Output Node is a Sop or Obj node.
     """
 
     order = pyblish.api.ValidatorOrder
diff --git a/openpype/hosts/houdini/plugins/publish/validate_mesh_is_static.py b/openpype/hosts/houdini/plugins/publish/validate_mesh_is_static.py
index 25ab362a88..4d0904eb53 100644
--- a/openpype/hosts/houdini/plugins/publish/validate_mesh_is_static.py
+++ b/openpype/hosts/houdini/plugins/publish/validate_mesh_is_static.py
@@ -17,7 +17,7 @@ class ValidateMeshIsStatic(pyblish.api.InstancePlugin,
                            OptionalPyblishPluginMixin):
     """Validate mesh is static.
 
-    It checks if output node is time dependant.
+    It checks if output node is time dependent.
     """
 
     families = ["staticMesh"]
diff --git a/openpype/hosts/houdini/plugins/publish/validate_subset_name.py b/openpype/hosts/houdini/plugins/publish/validate_subset_name.py
new file mode 100644
index 0000000000..299729a6e8
--- /dev/null
+++ b/openpype/hosts/houdini/plugins/publish/validate_subset_name.py
@@ -0,0 +1,94 @@
+# -*- coding: utf-8 -*-
+"""Validator for correct naming of Static Meshes."""
+import pyblish.api
+from openpype.pipeline import (
+    PublishValidationError,
+    OptionalPyblishPluginMixin
+)
+from openpype.pipeline.publish import (
+    ValidateContentsOrder,
+    RepairAction,
+)
+from openpype.hosts.houdini.api.action import SelectInvalidAction
+from openpype.pipeline.create import get_subset_name
+
+import hou
+
+
+class FixSubsetNameAction(RepairAction):
+    label = "Fix Subset Name"
+
+
+class ValidateSubsetName(pyblish.api.InstancePlugin,
+                         OptionalPyblishPluginMixin):
+    """Validate Subset name.
+
+    """
+
+    families = ["staticMesh"]
+    hosts = ["houdini"]
+    label = "Validate Subset Name"
+    order = ValidateContentsOrder + 0.1
+    actions = [FixSubsetNameAction, SelectInvalidAction]
+
+    optional = True
+
+
+    def process(self, instance):
+
+        if not self.is_active(instance.data):
+            return
+
+        invalid = self.get_invalid(instance)
+        if invalid:
+            nodes = [n.path() for n in invalid]
+            raise PublishValidationError(
+                "See log for details. "
+                "Invalid nodes: {0}".format(nodes)
+            )
+
+    @classmethod
+    def get_invalid(cls, instance):
+
+        invalid = []
+
+        rop_node = hou.node(instance.data["instance_node"])
+
+        # Check subset name
+        subset_name = get_subset_name(
+            family=instance.data["family"],
+            variant=instance.data["variant"],
+            task_name=instance.data["task"],
+            asset_doc=instance.data["assetEntity"],
+            dynamic_data={"asset":instance.data["asset"]}
+        )
+
+        if instance.data.get("subset") != subset_name:
+            invalid.append(rop_node)
+            cls.log.error(
+                "Invalid subset name on rop node '%s' should be '%s'.",
+                rop_node.path(), subset_name
+            )
+
+        return invalid
+
+    @classmethod
+    def repair(cls, instance):
+        rop_node = hou.node(instance.data["instance_node"])
+
+        # Check subset name
+        subset_name = get_subset_name(
+            family=instance.data["family"],
+            variant=instance.data["variant"],
+            task_name=instance.data["task"],
+            asset_doc=instance.data["assetEntity"],
+            dynamic_data={"asset":instance.data["asset"]}
+        )
+
+        instance.data["subset"] = subset_name
+        rop_node.parm("subset").set(subset_name)
+
+        cls.log.debug(
+            "Subset name on rop node '%s' has been set to '%s'.",
+            rop_node.path(), subset_name
+        )
diff --git a/openpype/hosts/houdini/plugins/publish/validate_unreal_staticmesh_naming.py b/openpype/hosts/houdini/plugins/publish/validate_unreal_staticmesh_naming.py
index 5558b43258..791db8198f 100644
--- a/openpype/hosts/houdini/plugins/publish/validate_unreal_staticmesh_naming.py
+++ b/openpype/hosts/houdini/plugins/publish/validate_unreal_staticmesh_naming.py
@@ -35,9 +35,12 @@ class ValidateUnrealStaticMeshName(pyblish.api.InstancePlugin,
     actions = [SelectInvalidAction]
 
     optional = True
+    collision_prefixes = []
+    static_mesh_prefix = ""
 
     @classmethod
     def apply_settings(cls, project_settings, system_settings):
+
         settings = (
             project_settings["houdini"]["create"]["CreateUnrealStaticMesh"]
         )
@@ -51,7 +54,7 @@ class ValidateUnrealStaticMeshName(pyblish.api.InstancePlugin,
 
         invalid = self.get_invalid(instance)
         if invalid:
-            nodes = [n.path() for n in invalid if isinstance(n, hou.Node)]
+            nodes = [n.path() for n in invalid]
             raise PublishValidationError(
                 "See log for details. "
                 "Invalid nodes: {0}".format(nodes)
@@ -70,7 +73,7 @@ class ValidateUnrealStaticMeshName(pyblish.api.InstancePlugin,
             )
             return
 
-        if not rop_node.evalParm('buildfrompath'):
+        if rop_node.evalParm("buildfrompath"):
             # This validator doesn't support naming check if
             # building hierarchy from path' is used
             cls.log.info(
@@ -91,18 +94,4 @@ class ValidateUnrealStaticMeshName(pyblish.api.InstancePlugin,
                     )
                     break
 
-        # Check subset name
-        subset_name = "{}_{}{}".format(
-            cls.static_mesh_prefix,
-            instance.data["asset"],
-            instance.data.get("variant", "")
-        )
-
-        if instance.data.get("subset") != subset_name:
-            invalid.append(rop_node)
-            cls.log.error(
-                "Invalid subset name on rop node '%s' should be '%s'.",
-                rop_node.path(), subset_name
-            )
-
         return invalid
diff --git a/openpype/settings/defaults/project_settings/houdini.json b/openpype/settings/defaults/project_settings/houdini.json
index 65f13fa1ab..7673725831 100644
--- a/openpype/settings/defaults/project_settings/houdini.json
+++ b/openpype/settings/defaults/project_settings/houdini.json
@@ -111,6 +111,16 @@
             "optional": true,
             "active": true
         },
+        "ValidateSubsetName": {
+            "enabled": true,
+            "optional": true,
+            "active": true
+        },
+        "ValidateMeshIsStatic": {
+            "enabled": true,
+            "optional": true,
+            "active": true
+        },
         "ValidateUnrealStaticMeshName": {
             "enabled": true,
             "optional": true,
diff --git a/openpype/settings/entities/schemas/projects_schema/schemas/schema_houdini_publish.json b/openpype/settings/entities/schemas/projects_schema/schemas/schema_houdini_publish.json
index 4339f86db6..670b1a0bc2 100644
--- a/openpype/settings/entities/schemas/projects_schema/schemas/schema_houdini_publish.json
+++ b/openpype/settings/entities/schemas/projects_schema/schemas/schema_houdini_publish.json
@@ -44,6 +44,14 @@
               "key": "ValidateContainers",
               "label": "ValidateContainers"
           },
+          {
+            "key": "ValidateSubsetName",
+            "label": "Validate Subset Name"
+          },
+          {
+            "key": "ValidateMeshIsStatic",
+            "label": "Validate Mesh is Static"
+          },
           {
             "key": "ValidateUnrealStaticMeshName",
             "label": "Validate Unreal Static Mesh Name"
diff --git a/server_addon/houdini/server/settings/publish_plugins.py b/server_addon/houdini/server/settings/publish_plugins.py
index 335751e5f9..b3e47d6948 100644
--- a/server_addon/houdini/server/settings/publish_plugins.py
+++ b/server_addon/houdini/server/settings/publish_plugins.py
@@ -164,6 +164,12 @@ class PublishPluginsModel(BaseSettingsModel):
     ValidateContainers: ValidateContainersModel = Field(
         default_factory=ValidateContainersModel,
         title="Validate Latest Containers.")
+    ValidateSubsetName: ValidateContainersModel = Field(
+        default_factory=ValidateContainersModel,
+        title="Validate Subset Name.")
+    ValidateMeshIsStatic: ValidateContainersModel = Field(
+        default_factory=ValidateContainersModel,
+        title="Validate Mesh is Static.")
     ValidateUnrealStaticMeshName: ValidateContainersModel = Field(
         default_factory=ValidateContainersModel,
         title="Validate Unreal Static Mesh Name.")
@@ -187,6 +193,16 @@ DEFAULT_HOUDINI_PUBLISH_SETTINGS = {
         "optional": True,
         "active": True
     },
+    "ValidateSubsetName": {
+        "enabled": True,
+        "optional": True,
+        "active": True
+    },
+    "ValidateMeshIsStatic": {
+        "enabled": True,
+        "optional": True,
+        "active": True
+    },
     "ValidateUnrealStaticMeshName": {
         "enabled": True,
         "optional": True,

From ebae3cf03ef443b51296eb160a06d26e3c4ba637 Mon Sep 17 00:00:00 2001
From: Mustafa-Zarkash <mustafataherzaky@outlook.com>
Date: Tue, 5 Sep 2023 19:54:31 +0300
Subject: [PATCH 162/366] remove white spaces

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

diff --git a/openpype/hosts/houdini/api/lib.py b/openpype/hosts/houdini/api/lib.py
index b108d0d881..7d3edbc707 100644
--- a/openpype/hosts/houdini/api/lib.py
+++ b/openpype/hosts/houdini/api/lib.py
@@ -654,19 +654,19 @@ def get_color_management_preferences():
 def get_obj_node_output(obj_node):
     """Find output node.
 
-    If the node has any output node return the 
+    If the node has any output node return the
     output node with the minimum `outputidx`.
     When no output is present return the node
     with the display flag set. If no output node is
     detected then None is returned.
-    
+
     Arguments:
         node (hou.Node): The node to retrieve a single
             the output node for.
-    
+
     Returns:
         Optional[hou.Node]: The child output node.
-        
+
     """
 
     outputs = obj_node.subnetOutputs()

From f00d76c0330f37eff8956cfd633484e1cd607ec5 Mon Sep 17 00:00:00 2001
From: Mustafa-Zarkash <mustafataherzaky@outlook.com>
Date: Tue, 5 Sep 2023 19:58:13 +0300
Subject: [PATCH 163/366] resolve hound

---
 .../hosts/houdini/plugins/create/create_unreal_staticmesh.py | 5 ++++-
 openpype/hosts/houdini/plugins/publish/extract_fbx.py        | 4 ++--
 .../hosts/houdini/plugins/publish/validate_subset_name.py    | 5 ++---
 3 files changed, 8 insertions(+), 6 deletions(-)

diff --git a/openpype/hosts/houdini/plugins/create/create_unreal_staticmesh.py b/openpype/hosts/houdini/plugins/create/create_unreal_staticmesh.py
index fc3783c0d1..2f92def54a 100644
--- a/openpype/hosts/houdini/plugins/create/create_unreal_staticmesh.py
+++ b/openpype/hosts/houdini/plugins/create/create_unreal_staticmesh.py
@@ -29,7 +29,10 @@ class CreateUnrealStaticMesh(plugin.HoudiniCreator):
         instance_node = hou.node(instance.get("instance_node"))
 
         # prepare parms
-        output_path = hou.text.expandString("$HIP/pyblish/{}.fbx".format(subset_name))
+        output_path = hou.text.expandString(
+            "$HIP/pyblish/{}.fbx".format(subset_name)
+        )
+
         parms = {
             "startnode": self.get_selection(),
             "sopoutput": output_path,
diff --git a/openpype/hosts/houdini/plugins/publish/extract_fbx.py b/openpype/hosts/houdini/plugins/publish/extract_fbx.py
index e8cd207818..dd61e68f3b 100644
--- a/openpype/hosts/houdini/plugins/publish/extract_fbx.py
+++ b/openpype/hosts/houdini/plugins/publish/extract_fbx.py
@@ -28,7 +28,7 @@ class ExtractFBX(publish.Extractor):
         file_name = os.path.basename(output_node)
 
         # render rop
-        self.log.debug("Writing FBX '%s' to '%s'",file_name, staging_dir)
+        self.log.debug("Writing FBX '%s' to '%s'", file_name, staging_dir)
         render_rop(ropnode)
 
         # prepare representation
@@ -36,7 +36,7 @@ class ExtractFBX(publish.Extractor):
             "name": "fbx",
             "ext": "fbx",
             "files": file_name,
-            "stagingDir": staging_dir,
+            "stagingDir": staging_dir
         }
 
         # A single frame may also be rendered without start/end frame.
diff --git a/openpype/hosts/houdini/plugins/publish/validate_subset_name.py b/openpype/hosts/houdini/plugins/publish/validate_subset_name.py
index 299729a6e8..bb3648f361 100644
--- a/openpype/hosts/houdini/plugins/publish/validate_subset_name.py
+++ b/openpype/hosts/houdini/plugins/publish/validate_subset_name.py
@@ -33,7 +33,6 @@ class ValidateSubsetName(pyblish.api.InstancePlugin,
 
     optional = True
 
-
     def process(self, instance):
 
         if not self.is_active(instance.data):
@@ -60,7 +59,7 @@ class ValidateSubsetName(pyblish.api.InstancePlugin,
             variant=instance.data["variant"],
             task_name=instance.data["task"],
             asset_doc=instance.data["assetEntity"],
-            dynamic_data={"asset":instance.data["asset"]}
+            dynamic_data={"asset": instance.data["asset"]}
         )
 
         if instance.data.get("subset") != subset_name:
@@ -82,7 +81,7 @@ class ValidateSubsetName(pyblish.api.InstancePlugin,
             variant=instance.data["variant"],
             task_name=instance.data["task"],
             asset_doc=instance.data["assetEntity"],
-            dynamic_data={"asset":instance.data["asset"]}
+            dynamic_data={"asset": instance.data["asset"]}
         )
 
         instance.data["subset"] = subset_name

From 7f78a95559870a79f2b20c456ea4ec8a3419e30d Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Tue, 5 Sep 2023 22:04:38 +0200
Subject: [PATCH 164/366] Export correct file type (ascii vs binary) based on
 instance setting

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

diff --git a/openpype/hosts/maya/plugins/publish/extract_maya_usd.py b/openpype/hosts/maya/plugins/publish/extract_maya_usd.py
index 70508042c0..32730d2963 100644
--- a/openpype/hosts/maya/plugins/publish/extract_maya_usd.py
+++ b/openpype/hosts/maya/plugins/publish/extract_maya_usd.py
@@ -32,6 +32,7 @@ class ExtractMayaUsd(publish.Extractor):
 
         # TODO: Support more `mayaUSDExport` parameters
         return {
+            "defaultUSDFormat": str,
             "stripNamespaces": bool,
             "mergeTransformAndShape": bool,
             "exportDisplayColor": bool,
@@ -52,6 +53,7 @@ class ExtractMayaUsd(publish.Extractor):
 
         # TODO: Support more `mayaUSDExport` parameters
         return {
+            "defaultUSDFormat": "usdc",
             "stripNamespaces": False,
             "mergeTransformAndShape": False,
             "exportDisplayColor": False,

From 93e3e310295c758f236e208dc7ed130eee4a4335 Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Tue, 5 Sep 2023 22:05:02 +0200
Subject: [PATCH 165/366] Log message as debug

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

diff --git a/openpype/hosts/maya/plugins/publish/extract_maya_usd.py b/openpype/hosts/maya/plugins/publish/extract_maya_usd.py
index 32730d2963..4a5fcc3366 100644
--- a/openpype/hosts/maya/plugins/publish/extract_maya_usd.py
+++ b/openpype/hosts/maya/plugins/publish/extract_maya_usd.py
@@ -111,7 +111,7 @@ class ExtractMayaUsd(publish.Extractor):
         # Parse export options
         options = self.default_options
         options = self.parse_overrides(instance, options)
-        self.log.info("Export options: {0}".format(options))
+        self.log.debug("Export options: {0}".format(options))
 
         # Perform extraction
         self.log.debug("Performing extraction ...")

From f4a0ab45e4a9f50d60488fb8cfc7ccaae7f016a0 Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Tue, 5 Sep 2023 23:10:32 +0200
Subject: [PATCH 166/366] Allow exporting custom attributes with
 `mayaUSDExport`

---
 .../maya/plugins/create/create_maya_usd.py    |  16 ++-
 .../maya/plugins/publish/extract_maya_usd.py  | 113 +++++++++++++++++-
 2 files changed, 121 insertions(+), 8 deletions(-)

diff --git a/openpype/hosts/maya/plugins/create/create_maya_usd.py b/openpype/hosts/maya/plugins/create/create_maya_usd.py
index 554b8169db..f05f155dd9 100644
--- a/openpype/hosts/maya/plugins/create/create_maya_usd.py
+++ b/openpype/hosts/maya/plugins/create/create_maya_usd.py
@@ -1,7 +1,8 @@
 from openpype.hosts.maya.api import plugin, lib
 from openpype.lib import (
     BoolDef,
-    EnumDef
+    EnumDef,
+    TextDef
 )
 
 
@@ -33,7 +34,18 @@ class CreateMayaUsd(plugin.MayaCreator):
                     default=True),
             BoolDef("mergeTransformAndShape",
                     label="Merge Transform and Shape",
-                    default=True)
+                    default=True),
+            BoolDef("includeUserDefinedAttributes",
+                    label="Include User Defined Attributes",
+                    default=False),
+            TextDef("attr",
+                    label="Custom Attributes",
+                    default="",
+                    placeholder="attr1, attr2"),
+            TextDef("attrPrefix",
+                    label="Custom Attributes Prefix",
+                    default="",
+                    placeholder="prefix1, prefix2")
         ])
 
         return defs
diff --git a/openpype/hosts/maya/plugins/publish/extract_maya_usd.py b/openpype/hosts/maya/plugins/publish/extract_maya_usd.py
index 4a5fcc3366..dfdea6868f 100644
--- a/openpype/hosts/maya/plugins/publish/extract_maya_usd.py
+++ b/openpype/hosts/maya/plugins/publish/extract_maya_usd.py
@@ -1,5 +1,7 @@
 import os
 import six
+import json
+import contextlib
 
 from maya import cmds
 
@@ -8,6 +10,88 @@ from openpype.pipeline import publish
 from openpype.hosts.maya.api.lib import maintained_selection
 
 
+@contextlib.contextmanager
+def usd_export_attributes(nodes, attrs=None, attr_prefixes=None, mapping=None):
+    """Define attributes for the given nodes that should be exported.
+
+    MayaUSDExport will export custom attributes if the Maya node has a
+    string attribute `USD_UserExportedAttributesJson` that provides an
+    export mapping for the maya attributes. This context manager will try
+    to autogenerate such an attribute during the export to include attributes
+    for the export.
+
+    """
+    # todo: this might be better done with a custom export chaser
+    #   see `chaser` argument for `mayaUSDExport`
+
+    import maya.api.OpenMaya as om
+
+    if not attrs and not attr_prefixes:
+        # context manager does nothing
+        yield
+        return
+
+    if attrs is None:
+        attrs = []
+    if attr_prefixes is None:
+        attr_prefixes = []
+    if mapping is None:
+        mapping = {}
+
+    usd_json_attr = "USD_UserExportedAttributesJson"
+    strings = attrs + ["{}*".format(prefix) for prefix in attr_prefixes]
+    context_state = {}
+    for node in set(nodes):
+        node_attrs = cmds.listAttr(node, st=strings)
+        if not node_attrs:
+            # Nothing to do for this node
+            continue
+
+        node_attr_data = {}
+        for node_attr in set(node_attrs):
+            node_attr_data[node_attr] = mapping.get(node_attr, {})
+
+        if cmds.attributeQuery(usd_json_attr, node=node, exists=True):
+            existing_node_attr_value = cmds.getAttr(
+                "{}.{}".format(node, usd_json_attr)
+            )
+            if existing_node_attr_value and existing_node_attr_value != "{}":
+                # Any existing attribute mappings in an existing
+                # `USD_UserExportedAttributesJson` attribute always take
+                # precedence over what this function tries to imprint
+                existing_node_attr_data = json.loads(existing_node_attr_value)
+                node_attr_data.update(existing_node_attr_data)
+
+        context_state[node] = json.dumps(node_attr_data)
+
+    sel = om.MSelectionList()
+    dg_mod = om.MDGModifier()
+    fn_string = om.MFnStringData()
+    fn_typed = om.MFnTypedAttribute()
+    try:
+        for node, value in context_state.items():
+            data = fn_string.create(value)
+            sel.clear()
+            if cmds.attributeQuery(usd_json_attr, node=node, exists=True):
+                # Set the attribute value
+                sel.add("{}.{}".format(node, usd_json_attr))
+                plug = sel.getPlug(0)
+                dg_mod.newPlugValue(plug, data)
+            else:
+                # Create attribute with the value as default value
+                sel.add(node)
+                node_obj = sel.getDependNode(0)
+                attr_obj = fn_typed.create(usd_json_attr,
+                                           usd_json_attr,
+                                           om.MFnData.kString,
+                                           data)
+                dg_mod.addAttribute(node_obj, attr_obj)
+        dg_mod.doIt()
+        yield
+    finally:
+        dg_mod.undoIt()
+
+
 class ExtractMayaUsd(publish.Extractor):
     """Extractor for Maya USD Asset data.
 
@@ -126,13 +210,30 @@ class ExtractMayaUsd(publish.Extractor):
         start = instance.data["frameStartHandle"]
         end = instance.data["frameEndHandle"]
 
+        def parse_attr_str(attr_str):
+            result = list()
+            for attr in attr_str.split(","):
+                attr = attr.strip()
+                if not attr:
+                    continue
+                result.append(attr)
+            return result
+
+        attrs = parse_attr_str(instance.data.get("attr", ""))
+        attrs += instance.data.get("userDefinedAttributes", [])
+        attrs += ["cbId"]
+        attr_prefixes = parse_attr_str(instance.data.get("attrPrefix", ""))
+
+        self.log.debug('Exporting USD: {} / {}'.format(file_path, members))
         with maintained_selection():
-            self.log.debug('Exporting USD: {} / {}'.format(file_path, members))
-            cmds.mayaUSDExport(file=file_path,
-                               frameRange=(start, end),
-                               frameStride=instance.data.get("step", 1.0),
-                               exportRoots=members,
-                               **options)
+            with usd_export_attributes(instance[:],
+                                       attrs=attrs,
+                                       attr_prefixes=attr_prefixes):
+                cmds.mayaUSDExport(file=file_path,
+                                   frameRange=(start, end),
+                                   frameStride=instance.data.get("step", 1.0),
+                                   exportRoots=members,
+                                   **options)
 
         representation = {
             'name': "usd",

From 17d494c1a2cb5229b764daeb415010f97fe46ad4 Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Tue, 5 Sep 2023 23:13:39 +0200
Subject: [PATCH 167/366] Add logic to collect user defined attributes and
 merge logic with pointcache and animation family + optimize the query by
 doing only one `cmds.listAttr` call

---
 .../maya/plugins/publish/collect_animation.py | 14 -------
 .../plugins/publish/collect_pointcache.py     | 15 -------
 .../collect_user_defined_attributes.py        | 39 +++++++++++++++++++
 3 files changed, 39 insertions(+), 29 deletions(-)
 create mode 100644 openpype/hosts/maya/plugins/publish/collect_user_defined_attributes.py

diff --git a/openpype/hosts/maya/plugins/publish/collect_animation.py b/openpype/hosts/maya/plugins/publish/collect_animation.py
index 8f523f770b..26a0a01c8b 100644
--- a/openpype/hosts/maya/plugins/publish/collect_animation.py
+++ b/openpype/hosts/maya/plugins/publish/collect_animation.py
@@ -58,17 +58,3 @@ class CollectAnimationOutputGeometry(pyblish.api.InstancePlugin):
         if instance.data.get("farm"):
             instance.data["families"].append("publish.farm")
 
-        # Collect user defined attributes.
-        if not instance.data.get("includeUserDefinedAttributes", False):
-            return
-
-        user_defined_attributes = set()
-        for node in hierarchy:
-            attrs = cmds.listAttr(node, userDefined=True) or list()
-            shapes = cmds.listRelatives(node, shapes=True) or list()
-            for shape in shapes:
-                attrs.extend(cmds.listAttr(shape, userDefined=True) or list())
-
-            user_defined_attributes.update(attrs)
-
-        instance.data["userDefinedAttributes"] = list(user_defined_attributes)
diff --git a/openpype/hosts/maya/plugins/publish/collect_pointcache.py b/openpype/hosts/maya/plugins/publish/collect_pointcache.py
index bb9065792f..5578a57f31 100644
--- a/openpype/hosts/maya/plugins/publish/collect_pointcache.py
+++ b/openpype/hosts/maya/plugins/publish/collect_pointcache.py
@@ -45,18 +45,3 @@ class CollectPointcache(pyblish.api.InstancePlugin):
         if proxy_set:
             instance.remove(proxy_set)
             instance.data["setMembers"].remove(proxy_set)
-
-        # Collect user defined attributes.
-        if not instance.data.get("includeUserDefinedAttributes", False):
-            return
-
-        user_defined_attributes = set()
-        for node in instance:
-            attrs = cmds.listAttr(node, userDefined=True) or list()
-            shapes = cmds.listRelatives(node, shapes=True) or list()
-            for shape in shapes:
-                attrs.extend(cmds.listAttr(shape, userDefined=True) or list())
-
-            user_defined_attributes.update(attrs)
-
-        instance.data["userDefinedAttributes"] = list(user_defined_attributes)
diff --git a/openpype/hosts/maya/plugins/publish/collect_user_defined_attributes.py b/openpype/hosts/maya/plugins/publish/collect_user_defined_attributes.py
new file mode 100644
index 0000000000..4d0790ad7c
--- /dev/null
+++ b/openpype/hosts/maya/plugins/publish/collect_user_defined_attributes.py
@@ -0,0 +1,39 @@
+from maya import cmds
+
+import pyblish.api
+
+
+class CollectUserDefinedAttributes(pyblish.api.InstancePlugin):
+    """Collect user defined attributes for nodes in instance."""
+
+    order = pyblish.api.CollectorOrder + 0.4
+    families = ["pointcache", "animation", "usd"]
+    label = "Collect User Defined Attributes"
+    hosts = ["maya"]
+
+    def process(self, instance):
+
+        # Collect user defined attributes.
+        if not instance.data.get("includeUserDefinedAttributes", False):
+            return
+
+        if "out_hierarchy" in instance.data:
+            # animation family
+            nodes = instance.data["out_hierarchy"]
+        else:
+            nodes = instance[:]
+        if not nodes:
+            return
+
+        shapes = cmds.listRelatives(nodes, shapes=True, fullPath=True) or []
+        nodes = set(nodes).union(shapes)
+
+        attrs = cmds.listAttr(list(nodes), userDefined=True) or []
+        user_defined_attributes = list(sorted(set(attrs)))
+        instance.data["userDefinedAttributes"] = user_defined_attributes
+
+        self.log.debug(
+            "Collected user defined attributes: {}".format(
+                ", ".join(user_defined_attributes)
+            )
+        )

From 4a861a6bfcdc06026fe4146e162523a1dc33cb58 Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Tue, 5 Sep 2023 23:29:46 +0200
Subject: [PATCH 168/366] Improve docstring

---
 .../maya/plugins/publish/extract_maya_usd.py  | 20 +++++++++++++++++++
 1 file changed, 20 insertions(+)

diff --git a/openpype/hosts/maya/plugins/publish/extract_maya_usd.py b/openpype/hosts/maya/plugins/publish/extract_maya_usd.py
index dfdea6868f..09bbf01831 100644
--- a/openpype/hosts/maya/plugins/publish/extract_maya_usd.py
+++ b/openpype/hosts/maya/plugins/publish/extract_maya_usd.py
@@ -20,6 +20,26 @@ def usd_export_attributes(nodes, attrs=None, attr_prefixes=None, mapping=None):
     to autogenerate such an attribute during the export to include attributes
     for the export.
 
+    Arguments:
+        nodes (List[str]): Nodes to process.
+        attrs (Optional[List[str]]): Full name of attributes to include.
+        attr_prefixes (Optional[List[str]]): Prefixes of attributes to include.
+        mapping (Optional[Dict[Dict]]): A mapping per attribute name for the
+            conversion to a USD attribute, including renaming, defining type,
+            converting attribute precision, etc. This match the usual
+            `USD_UserExportedAttributesJson` json mapping of `mayaUSDExport`.
+            When no mapping provided for an attribute it will use `{}` as
+            value.
+
+    Examples:
+          >>> with usd_export_attributes(
+          >>>     ["pCube1"], attrs="myDoubleAttributeAsFloat", mapping={
+          >>>         "myDoubleAttributeAsFloat": {
+          >>>           "usdAttrName": "my:namespace:attrib",
+          >>>           "translateMayaDoubleToUsdSinglePrecision": True,
+          >>>         }
+          >>> })
+
     """
     # todo: this might be better done with a custom export chaser
     #   see `chaser` argument for `mayaUSDExport`

From a61f7ac7998453dad917d01e43fa134320a8e7e5 Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Wed, 6 Sep 2023 00:02:39 +0200
Subject: [PATCH 169/366] Add support for Look Assigner to assign looks in
 `aiStandin` for USD files based on `cbId` attributes in the USD file.

- For this to currently work the transform and shape should *not* be merged into a single Prim inside USD because otherwise the unique `cbId` between Transform and Shape node will be lost.
---
 .../tools/mayalookassigner/arnold_standin.py  |  8 ++++
 .../hosts/maya/tools/mayalookassigner/usd.py  | 38 +++++++++++++++++++
 2 files changed, 46 insertions(+)
 create mode 100644 openpype/hosts/maya/tools/mayalookassigner/usd.py

diff --git a/openpype/hosts/maya/tools/mayalookassigner/arnold_standin.py b/openpype/hosts/maya/tools/mayalookassigner/arnold_standin.py
index 0ce2b21dcd..076b0047bb 100644
--- a/openpype/hosts/maya/tools/mayalookassigner/arnold_standin.py
+++ b/openpype/hosts/maya/tools/mayalookassigner/arnold_standin.py
@@ -10,6 +10,7 @@ from openpype.client import get_last_version_by_subset_name
 from openpype.hosts.maya import api
 from . import lib
 from .alembic import get_alembic_ids_cache
+from .usd import is_usd_lib_supported, get_usd_ids_cache
 
 
 log = logging.getLogger(__name__)
@@ -74,6 +75,13 @@ def get_nodes_by_id(standin):
         # Support alembic files directly
         return get_alembic_ids_cache(path)
 
+    elif (
+        is_usd_lib_supported and
+        any(path.endswith(ext) for ext in [".usd", ".usda", ".usdc"])
+    ):
+        # Support usd files directly
+        return get_usd_ids_cache(path)
+
     json_path = None
     for f in os.listdir(os.path.dirname(path)):
         if f.endswith(".json"):
diff --git a/openpype/hosts/maya/tools/mayalookassigner/usd.py b/openpype/hosts/maya/tools/mayalookassigner/usd.py
new file mode 100644
index 0000000000..beecbd531a
--- /dev/null
+++ b/openpype/hosts/maya/tools/mayalookassigner/usd.py
@@ -0,0 +1,38 @@
+from collections import defaultdict
+
+try:
+    from pxr import Usd
+    is_usd_lib_supported = True
+except ImportError:
+    is_usd_lib_supported = False
+
+
+def get_usd_ids_cache(path):
+    # type: (str) -> dict
+    """Build a id to node mapping in a USD file.
+
+    Nodes without IDs are ignored.
+
+    Returns:
+        dict: Mapping of id to nodes in the USD file.
+
+    """
+    if not is_usd_lib_supported:
+        raise RuntimeError("No pxr.Usd python library available.")
+
+    stage = Usd.Stage.Open(path)
+    ids = {}
+    for prim in stage.Traverse():
+        attr = prim.GetAttribute("userProperties:cbId")
+        if not attr.IsValid():
+            continue
+        path = str(prim.GetPath())
+        value = attr.Get()
+        if not value:
+            continue
+        ids[path] = value
+
+    cache = defaultdict(list)
+    for path, value in ids.items():
+        cache[value].append(path)
+    return dict(cache)

From b953391f43592fedf18069093c21e33a35136871 Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Wed, 6 Sep 2023 00:07:39 +0200
Subject: [PATCH 170/366] Only get path if a value is found

---
 openpype/hosts/maya/tools/mayalookassigner/usd.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/hosts/maya/tools/mayalookassigner/usd.py b/openpype/hosts/maya/tools/mayalookassigner/usd.py
index beecbd531a..6b5cb2f0f5 100644
--- a/openpype/hosts/maya/tools/mayalookassigner/usd.py
+++ b/openpype/hosts/maya/tools/mayalookassigner/usd.py
@@ -26,10 +26,10 @@ def get_usd_ids_cache(path):
         attr = prim.GetAttribute("userProperties:cbId")
         if not attr.IsValid():
             continue
-        path = str(prim.GetPath())
         value = attr.Get()
         if not value:
             continue
+        path = str(prim.GetPath())
         ids[path] = value
 
     cache = defaultdict(list)

From 11cd5a874eee0877c16c9cfde8cb8b74f1630364 Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Wed, 6 Sep 2023 00:13:34 +0200
Subject: [PATCH 171/366] Make sure to run after `CollectPointcache` and
 `CollectAnimation`

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

diff --git a/openpype/hosts/maya/plugins/publish/collect_user_defined_attributes.py b/openpype/hosts/maya/plugins/publish/collect_user_defined_attributes.py
index 4d0790ad7c..16fef2e168 100644
--- a/openpype/hosts/maya/plugins/publish/collect_user_defined_attributes.py
+++ b/openpype/hosts/maya/plugins/publish/collect_user_defined_attributes.py
@@ -6,7 +6,7 @@ import pyblish.api
 class CollectUserDefinedAttributes(pyblish.api.InstancePlugin):
     """Collect user defined attributes for nodes in instance."""
 
-    order = pyblish.api.CollectorOrder + 0.4
+    order = pyblish.api.CollectorOrder + 0.45
     families = ["pointcache", "animation", "usd"]
     label = "Collect User Defined Attributes"
     hosts = ["maya"]

From 8f5b09af2110bf93169bc69f91989981e8f3ad99 Mon Sep 17 00:00:00 2001
From: Kayla Man <moonyuet2008@hotmail.com>
Date: Wed, 6 Sep 2023 15:58:09 +0800
Subject: [PATCH 172/366] adding back the missing function after resolving
 conflict

---
 openpype/hosts/max/api/pipeline.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/openpype/hosts/max/api/pipeline.py b/openpype/hosts/max/api/pipeline.py
index c4167dfe0a..23b89a9ac2 100644
--- a/openpype/hosts/max/api/pipeline.py
+++ b/openpype/hosts/max/api/pipeline.py
@@ -15,6 +15,7 @@ from openpype.pipeline import (
 )
 from openpype.hosts.max.api.menu import OpenPypeMenu
 from openpype.hosts.max.api import lib
+from openpype.hosts.max.api.plugin import MS_CUSTOM_ATTRIB
 from openpype.hosts.max import MAX_HOST_DIR
 
 from pymxs import runtime as rt  # noqa

From 862907079c7c143854e864270878afb40449060e Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Wed, 6 Sep 2023 15:23:11 +0200
Subject: [PATCH 173/366] Support special creator attributes in Maya's
 flattened `creator_attributes` structure that are not convertable to Maya
 native attribute types (list, tuple, dict), like e.g. `EnumDef` with
 `multiselection=True`

---
 openpype/hosts/maya/api/plugin.py | 24 ++++++++++++++++++++++--
 1 file changed, 22 insertions(+), 2 deletions(-)

diff --git a/openpype/hosts/maya/api/plugin.py b/openpype/hosts/maya/api/plugin.py
index 058637c8b5..770767fc7d 100644
--- a/openpype/hosts/maya/api/plugin.py
+++ b/openpype/hosts/maya/api/plugin.py
@@ -161,8 +161,17 @@ class MayaCreatorBase(object):
         # will not clash in names with `subset`, `task`, etc. and other
         # default names. This is just so these attributes in many cases
         # are still editable in the maya UI by artists.
-        # pop to move to end of dict to sort attributes last on the node
+        # note: pop to move to end of dict to sort attributes last on the node
         creator_attributes = data.pop("creator_attributes", {})
+
+        # We only flatten value types which `imprint` function supports
+        json_creator_attributes = {}
+        for key, value in dict(creator_attributes).items():
+            if isinstance(value, (list, tuple, dict)):
+                creator_attributes.pop(key)
+                json_creator_attributes[key] = value
+
+        # Flatten remaining creator attributes to the node itself
         data.update(creator_attributes)
 
         # We know the "publish_attributes" will be complex data of
@@ -172,6 +181,10 @@ class MayaCreatorBase(object):
             data.pop("publish_attributes", {})
         )
 
+        # Persist the non-flattened creator attributes (special value types,
+        # like multiselection EnumDef)
+        data["creator_attributes"] = json.dumps(json_creator_attributes)
+
         # Since we flattened the data structure for creator attributes we want
         # to correctly detect which flattened attributes should end back in the
         # creator attributes when reading the data from the node, so we store
@@ -192,15 +205,22 @@ class MayaCreatorBase(object):
         # being read as 'data'
         node_data.pop("cbId", None)
 
+        # Make sure we convert any creator attributes from the json string
+        creator_attributes = node_data.get("creator_attributes")
+        if creator_attributes:
+            node_data["creator_attributes"] = json.loads(creator_attributes)
+        else:
+            node_data["creator_attributes"] = {}
+
         # Move the relevant attributes into "creator_attributes" that
         # we flattened originally
-        node_data["creator_attributes"] = {}
         creator_attribute_keys = node_data.pop("__creator_attributes_keys",
                                                "").split(",")
         for key in creator_attribute_keys:
             if key in node_data:
                 node_data["creator_attributes"][key] = node_data.pop(key)
 
+        # Make sure we convert any publish attributes from the json string
         publish_attributes = node_data.get("publish_attributes")
         if publish_attributes:
             node_data["publish_attributes"] = json.loads(publish_attributes)

From 48ab18f5431a42bdd185f25a7bedab5b45770ad9 Mon Sep 17 00:00:00 2001
From: Kayla Man <moonyuet2008@hotmail.com>
Date: Wed, 6 Sep 2023 21:25:50 +0800
Subject: [PATCH 174/366] Ondrej's comment on changing the raise exception to
 LoaderError

---
 openpype/hosts/max/plugins/load/load_pointcache_ornatrix.py | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/openpype/hosts/max/plugins/load/load_pointcache_ornatrix.py b/openpype/hosts/max/plugins/load/load_pointcache_ornatrix.py
index d3b7c61ff8..d87d6b1bfe 100644
--- a/openpype/hosts/max/plugins/load/load_pointcache_ornatrix.py
+++ b/openpype/hosts/max/plugins/load/load_pointcache_ornatrix.py
@@ -1,10 +1,12 @@
 import os
 from openpype.pipeline import load, get_representation_path
+from openpype.pipeline.load import LoaderError
 from openpype.hosts.max.api.pipeline import (
     containerise,
     import_custom_attribute_data,
     update_custom_attribute_data
 )
+
 from openpype.hosts.max.api.lib import (
     unique_namespace,
     get_namespace,
@@ -28,8 +30,8 @@ class OxAbcLoader(load.LoaderPlugin):
     def load(self, context, name=None, namespace=None, data=None):
         plugin_list = get_plugins()
         if "ephere.plugins.autodesk.max.ornatrix.dlo" not in plugin_list:
-            raise RuntimeError("Ornatrix plugin not "
-                               "found/installed in Max yet..")
+            raise LoaderError("Ornatrix plugin not "
+                              "found/installed in Max yet..")
 
         file_path = os.path.normpath(self.filepath_from_context(context))
         rt.AlembicImport.ImportToRoot = True

From a0f7951ea3927de61722d299fb77239abfd9e033 Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Wed, 6 Sep 2023 16:02:46 +0200
Subject: [PATCH 175/366] Add job context parameter to USD publisher

E.g. You can now directly export with a `Arnold` job context (if it's registered) so that the USD export is Arnold supported and directly renderable with shaders/render attributes by Arnold renderer.
---
 .../maya/plugins/create/create_maya_usd.py    | 25 ++++++++++++++++++-
 .../maya/plugins/publish/extract_maya_usd.py  |  2 ++
 2 files changed, 26 insertions(+), 1 deletion(-)

diff --git a/openpype/hosts/maya/plugins/create/create_maya_usd.py b/openpype/hosts/maya/plugins/create/create_maya_usd.py
index f05f155dd9..38de218bfb 100644
--- a/openpype/hosts/maya/plugins/create/create_maya_usd.py
+++ b/openpype/hosts/maya/plugins/create/create_maya_usd.py
@@ -5,6 +5,8 @@ from openpype.lib import (
     TextDef
 )
 
+from maya import cmds
+
 
 class CreateMayaUsd(plugin.MayaCreator):
     """Create Maya USD Export"""
@@ -15,11 +17,28 @@ class CreateMayaUsd(plugin.MayaCreator):
     icon = "cubes"
     description = "Create Maya USD Export"
 
+    cache = {}
+
     def get_publish_families(self):
         return ["usd", "mayaUsd"]
 
     def get_instance_attr_defs(self):
 
+        if "jobContextItems" not in self.cache:
+            # Query once instead of per instance
+            job_context_items = {}
+            try:
+                cmds.loadPlugin("mayaUsdPlugin", quiet=True)
+                job_context_items = {
+                    cmds.mayaUSDListJobContexts(jobContext=name): name
+                    for name in cmds.mayaUSDListJobContexts(export=True)
+                }
+            except RuntimeError:
+                # Likely `mayaUsdPlugin` plug-in not available
+                self.log.warning("Unable to retrieve available job "
+                                 "contexts for `mayaUsdPlugin` exports")
+            self.cache["jobContextItems"] = job_context_items
+
         defs = lib.collect_animation_defs()
         defs.extend([
             EnumDef("defaultUSDFormat",
@@ -45,7 +64,11 @@ class CreateMayaUsd(plugin.MayaCreator):
             TextDef("attrPrefix",
                     label="Custom Attributes Prefix",
                     default="",
-                    placeholder="prefix1, prefix2")
+                    placeholder="prefix1, prefix2"),
+            EnumDef("jobContext",
+                    label="Job Context",
+                    items=self.cache["jobContextItems"],
+                    multiselection=True),
         ])
 
         return defs
diff --git a/openpype/hosts/maya/plugins/publish/extract_maya_usd.py b/openpype/hosts/maya/plugins/publish/extract_maya_usd.py
index 09bbf01831..8c32ac1e39 100644
--- a/openpype/hosts/maya/plugins/publish/extract_maya_usd.py
+++ b/openpype/hosts/maya/plugins/publish/extract_maya_usd.py
@@ -148,6 +148,7 @@ class ExtractMayaUsd(publish.Extractor):
             "exportRefsAsInstanceable": bool,
             "eulerFilter": bool,
             "renderableOnly": bool,
+            "jobContext": (list, None)  # optional list
             # "worldspace": bool,
         }
 
@@ -169,6 +170,7 @@ class ExtractMayaUsd(publish.Extractor):
             "exportRefsAsInstanceable": False,
             "eulerFilter": True,
             "renderableOnly": False,
+            "jobContext": None
             # "worldspace": False
         }
 

From 388ae935e1e37d5771816defd4983bb1d6092bd2 Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Wed, 6 Sep 2023 16:09:51 +0200
Subject: [PATCH 176/366] By default load proxy as *not* `Shareable`

---
 openpype/hosts/maya/plugins/load/load_maya_usd.py | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/openpype/hosts/maya/plugins/load/load_maya_usd.py b/openpype/hosts/maya/plugins/load/load_maya_usd.py
index 26c497768d..2fb1a625a5 100644
--- a/openpype/hosts/maya/plugins/load/load_maya_usd.py
+++ b/openpype/hosts/maya/plugins/load/load_maya_usd.py
@@ -51,6 +51,14 @@ class MayaUsdLoader(load.LoaderPlugin):
             cmds.connectAttr("time1.outTime", "{}.time".format(proxy))
             cmds.setAttr("{}.filePath".format(proxy), path, type="string")
 
+            # By default, we force the proxy to not use a shared stage because
+            # when doing so Maya will quite easily allow to save into the
+            # loaded usd file. Since we are loading published files we want to
+            # avoid altering them. Unshared stages also save their edits into
+            # the workfile as an artist might expect it to do.
+            cmds.setAttr("{}.shareStage".format(proxy), False)
+            # cmds.setAttr("{}.shareStage".format(proxy), lock=True)
+
         nodes = [transform, proxy]
         self[:] = nodes
 

From 8dd4b70aa3c153ece4cb26fb4ee590742850c990 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Wed, 6 Sep 2023 16:52:34 +0200
Subject: [PATCH 177/366] nuke: remove redundant workfile colorspace profiles

---
 .../defaults/project_settings/nuke.json       |  6 +-----
 .../schemas/schema_nuke_imageio.json          | 20 -------------------
 2 files changed, 1 insertion(+), 25 deletions(-)

diff --git a/openpype/settings/defaults/project_settings/nuke.json b/openpype/settings/defaults/project_settings/nuke.json
index b736c462ff..7961e77113 100644
--- a/openpype/settings/defaults/project_settings/nuke.json
+++ b/openpype/settings/defaults/project_settings/nuke.json
@@ -28,11 +28,7 @@
             "colorManagement": "Nuke",
             "OCIO_config": "nuke-default",
             "workingSpaceLUT": "linear",
-            "monitorLut": "sRGB",
-            "int8Lut": "sRGB",
-            "int16Lut": "sRGB",
-            "logLut": "Cineon",
-            "floatLut": "linear"
+            "monitorLut": "sRGB"
         },
         "nodes": {
             "requiredNodes": [
diff --git a/openpype/settings/entities/schemas/projects_schema/schemas/schema_nuke_imageio.json b/openpype/settings/entities/schemas/projects_schema/schemas/schema_nuke_imageio.json
index d4cd332ef8..af826fcf46 100644
--- a/openpype/settings/entities/schemas/projects_schema/schemas/schema_nuke_imageio.json
+++ b/openpype/settings/entities/schemas/projects_schema/schemas/schema_nuke_imageio.json
@@ -106,26 +106,6 @@
                             "type": "text",
                             "key": "monitorLut",
                             "label": "monitor"
-                        },
-                        {
-                            "type": "text",
-                            "key": "int8Lut",
-                            "label": "8-bit files"
-                        },
-                        {
-                            "type": "text",
-                            "key": "int16Lut",
-                            "label": "16-bit files"
-                        },
-                        {
-                            "type": "text",
-                            "key": "logLut",
-                            "label": "log files"
-                        },
-                        {
-                            "type": "text",
-                            "key": "floatLut",
-                            "label": "float files"
                         }
                     ]
                 }

From 359ead27a2e6f637dda576ae1daf1801bf00f348 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Wed, 6 Sep 2023 16:53:41 +0200
Subject: [PATCH 178/366] nuke-addon: remove redundant workfile colorspace
 names

---
 server_addon/nuke/server/settings/imageio.py | 32 --------------------
 1 file changed, 32 deletions(-)

diff --git a/server_addon/nuke/server/settings/imageio.py b/server_addon/nuke/server/settings/imageio.py
index b43017ef8b..3f5ac0b8f9 100644
--- a/server_addon/nuke/server/settings/imageio.py
+++ b/server_addon/nuke/server/settings/imageio.py
@@ -66,22 +66,6 @@ def ocio_configs_switcher_enum():
 
 class WorkfileColorspaceSettings(BaseSettingsModel):
     """Nuke workfile colorspace preset. """
-    """# TODO: enhance settings with host api:
-    we need to add mapping to resolve properly keys.
-    Nuke is excpecting camel case key names,
-    but for better code consistency we need to
-    be  using snake_case:
-
-    color_management = colorManagement
-    ocio_config = OCIO_config
-    working_space_name = workingSpaceLUT
-    monitor_name = monitorLut
-    monitor_out_name = monitorOutLut
-    int_8_name = int8Lut
-    int_16_name = int16Lut
-    log_name = logLut
-    float_name = floatLut
-    """
 
     colorManagement: Literal["Nuke", "OCIO"] = Field(
         title="Color Management"
@@ -100,18 +84,6 @@ class WorkfileColorspaceSettings(BaseSettingsModel):
     monitorLut: str = Field(
         title="Monitor"
     )
-    int8Lut: str = Field(
-        title="8-bit files"
-    )
-    int16Lut: str = Field(
-        title="16-bit files"
-    )
-    logLut: str = Field(
-        title="Log files"
-    )
-    floatLut: str = Field(
-        title="Float files"
-    )
 
 
 class ReadColorspaceRulesItems(BaseSettingsModel):
@@ -238,10 +210,6 @@ DEFAULT_IMAGEIO_SETTINGS = {
         "OCIO_config": "nuke-default",
         "workingSpaceLUT": "linear",
         "monitorLut": "sRGB",
-        "int8Lut": "sRGB",
-        "int16Lut": "sRGB",
-        "logLut": "Cineon",
-        "floatLut": "linear"
     },
     "nodes": {
         "requiredNodes": [

From f1267546d23040eb778b9f8ead135d6de36184d9 Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Wed, 6 Sep 2023 18:02:24 +0200
Subject: [PATCH 179/366] Avoid error if no job contexts are available

---
 openpype/hosts/maya/plugins/create/create_maya_usd.py | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/openpype/hosts/maya/plugins/create/create_maya_usd.py b/openpype/hosts/maya/plugins/create/create_maya_usd.py
index 38de218bfb..77a96dd4cb 100644
--- a/openpype/hosts/maya/plugins/create/create_maya_usd.py
+++ b/openpype/hosts/maya/plugins/create/create_maya_usd.py
@@ -31,12 +31,17 @@ class CreateMayaUsd(plugin.MayaCreator):
                 cmds.loadPlugin("mayaUsdPlugin", quiet=True)
                 job_context_items = {
                     cmds.mayaUSDListJobContexts(jobContext=name): name
-                    for name in cmds.mayaUSDListJobContexts(export=True)
+                    for name in cmds.mayaUSDListJobContexts(export=True) or []
                 }
             except RuntimeError:
                 # Likely `mayaUsdPlugin` plug-in not available
                 self.log.warning("Unable to retrieve available job "
                                  "contexts for `mayaUsdPlugin` exports")
+
+            if not job_context_items:
+                # enumdef multiselection may not be empty
+                job_context_items = ["<placeholder; do not use>"]
+
             self.cache["jobContextItems"] = job_context_items
 
         defs = lib.collect_animation_defs()

From d5823ab556e016c424b7c4bdd12ddac646d745be Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Wed, 6 Sep 2023 18:08:51 +0200
Subject: [PATCH 180/366] Add a few tooltips

---
 .../maya/plugins/create/create_maya_usd.py    | 23 +++++++++++++++++++
 1 file changed, 23 insertions(+)

diff --git a/openpype/hosts/maya/plugins/create/create_maya_usd.py b/openpype/hosts/maya/plugins/create/create_maya_usd.py
index 77a96dd4cb..cc9a14bd3a 100644
--- a/openpype/hosts/maya/plugins/create/create_maya_usd.py
+++ b/openpype/hosts/maya/plugins/create/create_maya_usd.py
@@ -55,12 +55,29 @@ class CreateMayaUsd(plugin.MayaCreator):
                     default="usdc"),
             BoolDef("stripNamespaces",
                     label="Strip Namespaces",
+                    tooltip=(
+                        "Remove namespaces during export. By default, "
+                        "namespaces are exported to the USD file in the "
+                        "following format: nameSpaceExample_pPlatonic1"
+                    ),
                     default=True),
             BoolDef("mergeTransformAndShape",
                     label="Merge Transform and Shape",
+                    tooltip=(
+                        "Combine Maya transform and shape into a single USD"
+                        "prim that has transform and geometry, for all"
+                        " \"geometric primitives\" (gprims).\n"
+                        "This results in smaller and faster scenes. Gprims "
+                        "will be \"unpacked\" back into transform and shape "
+                        "nodes when imported into Maya from USD."
+                    ),
                     default=True),
             BoolDef("includeUserDefinedAttributes",
                     label="Include User Defined Attributes",
+                    tooltip=(
+                        "Whether to include all custom maya attributes found "
+                        "on nodes as metadata (userProperties) in USD."
+                    ),
                     default=False),
             TextDef("attr",
                     label="Custom Attributes",
@@ -73,6 +90,12 @@ class CreateMayaUsd(plugin.MayaCreator):
             EnumDef("jobContext",
                     label="Job Context",
                     items=self.cache["jobContextItems"],
+                    tooltip=(
+                        "Specifies an additional export context to handle.\n"
+                        "These usually contain extra schemas, primitives,\n"
+                        "and materials that are to be exported for a "
+                        "specific\ntask, a target renderer for example."
+                    ),
                     multiselection=True),
         ])
 

From d2140c36192d353d68c287af6385fac1b8fa68d7 Mon Sep 17 00:00:00 2001
From: Mustafa-Zarkash <mustafataherzaky@outlook.com>
Date: Wed, 6 Sep 2023 21:37:20 +0300
Subject: [PATCH 181/366] match maya render mask in houdini

---
 openpype/hosts/houdini/api/lib.py             | 53 ++++++++++++
 openpype/hosts/houdini/api/pipeline.py        |  2 +
 .../plugins/inventory/set_asset_resolution.py | 24 ++++++
 .../hosts/houdini/plugins/load/load_camera.py | 81 +++++++++++--------
 4 files changed, 126 insertions(+), 34 deletions(-)
 create mode 100644 openpype/hosts/houdini/plugins/inventory/set_asset_resolution.py

diff --git a/openpype/hosts/houdini/api/lib.py b/openpype/hosts/houdini/api/lib.py
index 75c7ff9fee..c6672cf969 100644
--- a/openpype/hosts/houdini/api/lib.py
+++ b/openpype/hosts/houdini/api/lib.py
@@ -649,3 +649,56 @@ def get_color_management_preferences():
         "display": hou.Color.ocio_defaultDisplay(),
         "view": hou.Color.ocio_defaultView()
     }
+
+
+def get_current_asset_doc():
+    """Get asset document of the current asset. """
+
+    project_name = get_current_project_name()
+    asset_name = get_current_asset_name()
+    asset_doc = get_asset_by_name(project_name, asset_name)
+
+    return asset_doc
+
+
+def get_resolution_from_data(doc):
+    if not doc or "data" not in doc:
+        print("Entered document is not valid. \"{}\"".format(str(doc)))
+        return None
+
+    resolution_width = doc["data"].get("resolutionWidth")
+    resolution_height = doc["data"].get("resolutionHeight")
+
+    # Make sure both width and height are set
+    if resolution_width is None or resolution_height is None:
+        print("No resolution information found for \"{}\"".format(doc["name"]))
+        return None
+
+    return int(resolution_width), int(resolution_height)
+
+
+def set_camera_resolution(camera, asset_doc=None):
+    """Apply resolution to camera from asset document of the publish"""
+
+    if not asset_doc:
+        asset_doc = get_current_asset_doc()
+
+    resolution = get_resolution_from_data(asset_doc)
+
+    if resolution:
+        print("Setting camera resolution: {} -> {}x{}".format(
+            camera.name(), resolution[0], resolution[1]
+        ))
+        camera.parm("resx").set(resolution[0])
+        camera.parm("resy").set(resolution[1])
+
+
+def get_camera_from_container(container):
+    """Get camera from container node. """
+
+    cameras = container.recursiveGlob("*",
+                                    filter=hou.nodeTypeFilter.ObjCamera,
+                                    include_subnets=False)
+
+    assert len(cameras) == 1, "Camera instance must have only one camera"
+    return cameras[0]
diff --git a/openpype/hosts/houdini/api/pipeline.py b/openpype/hosts/houdini/api/pipeline.py
index c9ae801af5..6aa65deb89 100644
--- a/openpype/hosts/houdini/api/pipeline.py
+++ b/openpype/hosts/houdini/api/pipeline.py
@@ -14,6 +14,7 @@ import pyblish.api
 from openpype.pipeline import (
     register_creator_plugin_path,
     register_loader_plugin_path,
+    register_inventory_action_path,
     AVALON_CONTAINER_ID,
 )
 from openpype.pipeline.load import any_outdated_containers
@@ -55,6 +56,7 @@ class HoudiniHost(HostBase, IWorkfileHost, ILoadHost, IPublishHost):
         pyblish.api.register_plugin_path(PUBLISH_PATH)
         register_loader_plugin_path(LOAD_PATH)
         register_creator_plugin_path(CREATE_PATH)
+        register_inventory_action_path(INVENTORY_PATH)
 
         log.info("Installing callbacks ... ")
         # register_event_callback("init", on_init)
diff --git a/openpype/hosts/houdini/plugins/inventory/set_asset_resolution.py b/openpype/hosts/houdini/plugins/inventory/set_asset_resolution.py
new file mode 100644
index 0000000000..cff7f89288
--- /dev/null
+++ b/openpype/hosts/houdini/plugins/inventory/set_asset_resolution.py
@@ -0,0 +1,24 @@
+from openpype.pipeline import InventoryAction
+from openpype.hosts.houdini.api.lib import (
+    get_camera_from_container,
+    set_camera_resolution
+)
+
+class SetAssetResolution(InventoryAction):
+
+    label = "Set Asset Resolution"
+    icon = "desktop"
+    color = "orange"
+
+    @staticmethod
+    def is_compatible(container):
+        print(container)
+        return (
+            container.get("loader") == "CameraLoader"
+        )
+
+    def process(self, containers):
+        for container in containers:
+            node = container["node"]
+            camera = get_camera_from_container(node)
+            set_camera_resolution(camera)
diff --git a/openpype/hosts/houdini/plugins/load/load_camera.py b/openpype/hosts/houdini/plugins/load/load_camera.py
index 7b4a04809e..cffa5ca813 100644
--- a/openpype/hosts/houdini/plugins/load/load_camera.py
+++ b/openpype/hosts/houdini/plugins/load/load_camera.py
@@ -4,6 +4,13 @@ from openpype.pipeline import (
 )
 from openpype.hosts.houdini.api import pipeline
 
+from openpype.hosts.houdini.api.lib import (
+    set_camera_resolution,
+    get_camera_from_container
+)
+
+import hou
+
 
 ARCHIVE_EXPRESSION = ('__import__("_alembic_hom_extensions")'
                       '.alembicGetCameraDict')
@@ -25,7 +32,15 @@ def transfer_non_default_values(src, dest, ignore=None):
     channel expression and ignore certain Parm types.
 
     """
-    import hou
+
+    ignore_types = {
+            hou.parmTemplateType.Toggle,
+            hou.parmTemplateType.Menu,
+            hou.parmTemplateType.Button,
+            hou.parmTemplateType.FolderSet,
+            hou.parmTemplateType.Separator,
+            hou.parmTemplateType.Label,
+        }
 
     src.updateParmStates()
 
@@ -62,14 +77,6 @@ def transfer_non_default_values(src, dest, ignore=None):
             continue
 
         # Ignore folders, separators, etc.
-        ignore_types = {
-            hou.parmTemplateType.Toggle,
-            hou.parmTemplateType.Menu,
-            hou.parmTemplateType.Button,
-            hou.parmTemplateType.FolderSet,
-            hou.parmTemplateType.Separator,
-            hou.parmTemplateType.Label,
-        }
         if parm.parmTemplate().type() in ignore_types:
             continue
 
@@ -90,13 +97,8 @@ class CameraLoader(load.LoaderPlugin):
 
     def load(self, context, name=None, namespace=None, data=None):
 
-        import os
-        import hou
-
         # Format file name, Houdini only wants forward slashes
-        file_path = self.filepath_from_context(context)
-        file_path = os.path.normpath(file_path)
-        file_path = file_path.replace("\\", "/")
+        file_path = self.fname.replace("\\", "/")
 
         # Get the root node
         obj = hou.node("/obj")
@@ -106,19 +108,21 @@ class CameraLoader(load.LoaderPlugin):
         node_name = "{}_{}".format(namespace, name) if namespace else name
 
         # Create a archive node
-        container = self.create_and_connect(obj, "alembicarchive", node_name)
+        node = self.create_and_connect(obj, "alembicarchive", node_name)
 
         # TODO: add FPS of project / asset
-        container.setParms({"fileName": file_path,
-                            "channelRef": True})
+        node.setParms({"fileName": file_path, "channelRef": True})
 
         # Apply some magic
-        container.parm("buildHierarchy").pressButton()
-        container.moveToGoodPosition()
+        node.parm("buildHierarchy").pressButton()
+        node.moveToGoodPosition()
 
         # Create an alembic xform node
-        nodes = [container]
+        nodes = [node]
 
+        camera = get_camera_from_container(node)
+        self._match_maya_render_mask(camera)
+        set_camera_resolution(camera, asset_doc=context["asset"])
         self[:] = nodes
 
         return pipeline.containerise(node_name,
@@ -143,14 +147,14 @@ class CameraLoader(load.LoaderPlugin):
         # Store the cam temporarily next to the Alembic Archive
         # so that we can preserve parm values the user set on it
         # after build hierarchy was triggered.
-        old_camera = self._get_camera(node)
+        old_camera = get_camera_from_container(node)
         temp_camera = old_camera.copyTo(node.parent())
 
         # Rebuild
         node.parm("buildHierarchy").pressButton()
 
         # Apply values to the new camera
-        new_camera = self._get_camera(node)
+        new_camera = get_camera_from_container(node)
         transfer_non_default_values(temp_camera,
                                     new_camera,
                                     # The hidden uniform scale attribute
@@ -158,6 +162,9 @@ class CameraLoader(load.LoaderPlugin):
                                     # "icon_scale" just skip that completely
                                     ignore={"scale"})
 
+        self._match_maya_render_mask(new_camera)
+        set_camera_resolution(new_camera)
+
         temp_camera.destroy()
 
     def remove(self, container):
@@ -165,15 +172,6 @@ class CameraLoader(load.LoaderPlugin):
         node = container["node"]
         node.destroy()
 
-    def _get_camera(self, node):
-        import hou
-        cameras = node.recursiveGlob("*",
-                                     filter=hou.nodeTypeFilter.ObjCamera,
-                                     include_subnets=False)
-
-        assert len(cameras) == 1, "Camera instance must have only one camera"
-        return cameras[0]
-
     def create_and_connect(self, node, node_type, name=None):
         """Create a node within a node which and connect it to the input
 
@@ -194,5 +192,20 @@ class CameraLoader(load.LoaderPlugin):
         new_node.moveToGoodPosition()
         return new_node
 
-    def switch(self, container, representation):
-        self.update(container, representation)
+    def _match_maya_render_mask(self, camera):
+        """Workaround to match Maya render mask in Houdini"""
+
+        # print("Setting match maya render mask ")
+        parm = camera.parm("aperture")
+        expression = parm.expression()
+        expression = expression.replace("return ", "aperture = ")
+        expression += """
+# Match maya render mask (logic from Houdini's own FBX importer)
+node = hou.pwd()
+resx = node.evalParm('resx')
+resy = node.evalParm('resy')
+aspect = node.evalParm('aspect')
+aperture *= min(1, (resx / resy * aspect) / 1.5)
+return aperture
+"""
+        parm.setExpression(expression, language=hou.exprLanguage.Python)

From 32a192b1929598c82fc8d199b19ff0edb5763564 Mon Sep 17 00:00:00 2001
From: Mustafa-Zarkash <mustafataherzaky@outlook.com>
Date: Wed, 6 Sep 2023 21:44:46 +0300
Subject: [PATCH 182/366] change action name

---
 .../{set_asset_resolution.py => set_camera_resolution.py}     | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)
 rename openpype/hosts/houdini/plugins/inventory/{set_asset_resolution.py => set_camera_resolution.py} (87%)

diff --git a/openpype/hosts/houdini/plugins/inventory/set_asset_resolution.py b/openpype/hosts/houdini/plugins/inventory/set_camera_resolution.py
similarity index 87%
rename from openpype/hosts/houdini/plugins/inventory/set_asset_resolution.py
rename to openpype/hosts/houdini/plugins/inventory/set_camera_resolution.py
index cff7f89288..441aef8b1c 100644
--- a/openpype/hosts/houdini/plugins/inventory/set_asset_resolution.py
+++ b/openpype/hosts/houdini/plugins/inventory/set_camera_resolution.py
@@ -4,9 +4,9 @@ from openpype.hosts.houdini.api.lib import (
     set_camera_resolution
 )
 
-class SetAssetResolution(InventoryAction):
+class SetCameraResolution(InventoryAction):
 
-    label = "Set Asset Resolution"
+    label = "Set Camera Resolution"
     icon = "desktop"
     color = "orange"
 

From f8d03955f71b6d7fe9d87b1835cb1d62a2adf788 Mon Sep 17 00:00:00 2001
From: Mustafa-Zarkash <mustafataherzaky@outlook.com>
Date: Wed, 6 Sep 2023 21:59:11 +0300
Subject: [PATCH 183/366] resolve hound

---
 openpype/hosts/houdini/api/lib.py                  | 14 +++++++++-----
 .../plugins/inventory/set_camera_resolution.py     |  1 +
 openpype/hosts/houdini/plugins/load/load_camera.py | 14 +++++++-------
 3 files changed, 17 insertions(+), 12 deletions(-)

diff --git a/openpype/hosts/houdini/api/lib.py b/openpype/hosts/houdini/api/lib.py
index c6672cf969..f83519ddb8 100644
--- a/openpype/hosts/houdini/api/lib.py
+++ b/openpype/hosts/houdini/api/lib.py
@@ -661,7 +661,9 @@ def get_current_asset_doc():
     return asset_doc
 
 
-def get_resolution_from_data(doc):
+def get_resolution_from_doc(doc):
+    """Get resolution from the given asset document. """
+
     if not doc or "data" not in doc:
         print("Entered document is not valid. \"{}\"".format(str(doc)))
         return None
@@ -683,7 +685,7 @@ def set_camera_resolution(camera, asset_doc=None):
     if not asset_doc:
         asset_doc = get_current_asset_doc()
 
-    resolution = get_resolution_from_data(asset_doc)
+    resolution = get_resolution_from_doc(asset_doc)
 
     if resolution:
         print("Setting camera resolution: {} -> {}x{}".format(
@@ -696,9 +698,11 @@ def set_camera_resolution(camera, asset_doc=None):
 def get_camera_from_container(container):
     """Get camera from container node. """
 
-    cameras = container.recursiveGlob("*",
-                                    filter=hou.nodeTypeFilter.ObjCamera,
-                                    include_subnets=False)
+    cameras = container.recursiveGlob(
+        "*",
+        filter=hou.nodeTypeFilter.ObjCamera,
+        include_subnets=False
+    )
 
     assert len(cameras) == 1, "Camera instance must have only one camera"
     return cameras[0]
diff --git a/openpype/hosts/houdini/plugins/inventory/set_camera_resolution.py b/openpype/hosts/houdini/plugins/inventory/set_camera_resolution.py
index 441aef8b1c..5dd94232b8 100644
--- a/openpype/hosts/houdini/plugins/inventory/set_camera_resolution.py
+++ b/openpype/hosts/houdini/plugins/inventory/set_camera_resolution.py
@@ -4,6 +4,7 @@ from openpype.hosts.houdini.api.lib import (
     set_camera_resolution
 )
 
+
 class SetCameraResolution(InventoryAction):
 
     label = "Set Camera Resolution"
diff --git a/openpype/hosts/houdini/plugins/load/load_camera.py b/openpype/hosts/houdini/plugins/load/load_camera.py
index cffa5ca813..53567b6f97 100644
--- a/openpype/hosts/houdini/plugins/load/load_camera.py
+++ b/openpype/hosts/houdini/plugins/load/load_camera.py
@@ -34,13 +34,13 @@ def transfer_non_default_values(src, dest, ignore=None):
     """
 
     ignore_types = {
-            hou.parmTemplateType.Toggle,
-            hou.parmTemplateType.Menu,
-            hou.parmTemplateType.Button,
-            hou.parmTemplateType.FolderSet,
-            hou.parmTemplateType.Separator,
-            hou.parmTemplateType.Label,
-        }
+        hou.parmTemplateType.Toggle,
+        hou.parmTemplateType.Menu,
+        hou.parmTemplateType.Button,
+        hou.parmTemplateType.FolderSet,
+        hou.parmTemplateType.Separator,
+        hou.parmTemplateType.Label,
+    }
 
     src.updateParmStates()
 

From 7a3aaa5408b3d4a9ff22220018506e25e55858bf Mon Sep 17 00:00:00 2001
From: Mustafa-Zarkash <mustafataherzaky@outlook.com>
Date: Thu, 7 Sep 2023 10:26:09 +0300
Subject: [PATCH 184/366] replace fname

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

diff --git a/openpype/hosts/houdini/plugins/load/load_camera.py b/openpype/hosts/houdini/plugins/load/load_camera.py
index 53567b6f97..e16146a267 100644
--- a/openpype/hosts/houdini/plugins/load/load_camera.py
+++ b/openpype/hosts/houdini/plugins/load/load_camera.py
@@ -98,7 +98,7 @@ class CameraLoader(load.LoaderPlugin):
     def load(self, context, name=None, namespace=None, data=None):
 
         # Format file name, Houdini only wants forward slashes
-        file_path = self.fname.replace("\\", "/")
+        file_path = self.filepath_from_context(context).replace("\\", "/")
 
         # Get the root node
         obj = hou.node("/obj")

From 2c0a8d41006c5886d0e05e85c302f00b70c8e8f9 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Thu, 7 Sep 2023 14:47:27 +0200
Subject: [PATCH 185/366] adding default factory to list objects

---
 .../nuke/server/settings/create_plugins.py    |  4 ++++
 server_addon/nuke/server/settings/imageio.py  |  2 ++
 .../nuke/server/settings/publish_plugins.py   |  3 +++
 .../nuke/server/settings/workfile_builder.py  | 20 ++++++++++++++-----
 4 files changed, 24 insertions(+), 5 deletions(-)

diff --git a/server_addon/nuke/server/settings/create_plugins.py b/server_addon/nuke/server/settings/create_plugins.py
index 0bbae4ee77..b89188a77a 100644
--- a/server_addon/nuke/server/settings/create_plugins.py
+++ b/server_addon/nuke/server/settings/create_plugins.py
@@ -37,6 +37,7 @@ class PrenodeModel(BaseSettingsModel):
     - We could not support v3 style of settings.
     """
     knobs: list[KnobModel] = Field(
+        default_factory=list,
         title="Knobs",
     )
 
@@ -66,6 +67,7 @@ class CreateWriteRenderModel(BaseSettingsModel):
       (we could not support v3 style of settings)
     """
     prenodes: list[PrenodeModel] = Field(
+        default_factory=list,
         title="Preceding nodes",
     )
 
@@ -95,6 +97,7 @@ class CreateWritePrerenderModel(BaseSettingsModel):
       (we could not support v3 style of settings)
     """
     prenodes: list[PrenodeModel] = Field(
+        default_factory=list,
         title="Preceding nodes",
     )
 
@@ -124,6 +127,7 @@ class CreateWriteImageModel(BaseSettingsModel):
       (we could not support v3 style of settings)
     """
     prenodes: list[PrenodeModel] = Field(
+        default_factory=list,
         title="Preceding nodes",
     )
 
diff --git a/server_addon/nuke/server/settings/imageio.py b/server_addon/nuke/server/settings/imageio.py
index b43017ef8b..16f9bd309a 100644
--- a/server_addon/nuke/server/settings/imageio.py
+++ b/server_addon/nuke/server/settings/imageio.py
@@ -14,6 +14,7 @@ class NodesModel(BaseSettingsModel):
     """
     _layout = "expanded"
     plugins: list[str] = Field(
+        default_factory=list,
         title="Used in plugins"
     )
     # TODO: rename `nukeNodeClass` to `nuke_node_class`
@@ -25,6 +26,7 @@ class NodesModel(BaseSettingsModel):
     in nuke integration. We could not support v3 style of settings.
     """
     knobs: list[KnobModel] = Field(
+        default_factory=list,
         title="Knobs",
     )
 
diff --git a/server_addon/nuke/server/settings/publish_plugins.py b/server_addon/nuke/server/settings/publish_plugins.py
index 7e898f8c9a..de21870d5f 100644
--- a/server_addon/nuke/server/settings/publish_plugins.py
+++ b/server_addon/nuke/server/settings/publish_plugins.py
@@ -46,6 +46,7 @@ class NodeModel(BaseSettingsModel):
     - We could not support v3 style of settings.
     """
     knobs: list[KnobModel] = Field(
+        default_factory=list,
         title="Knobs",
     )
 
@@ -105,6 +106,7 @@ class ExtractThumbnailModel(BaseSettingsModel):
     """
 
     nodes: list[NodeModel] = Field(
+        default_factory=list,
         title="Nodes (deprecated)"
     )
     reposition_nodes: list[ThumbnailRepositionNodeModel] = Field(
@@ -177,6 +179,7 @@ class ExtractReviewDataMovModel(BaseSettingsModel):
     enabled: bool = Field(title="Enabled")
     viewer_lut_raw: bool = Field(title="Viewer lut raw")
     outputs: list[BakingStreamModel] = Field(
+        default_factory=list,
         title="Baking streams"
     )
 
diff --git a/server_addon/nuke/server/settings/workfile_builder.py b/server_addon/nuke/server/settings/workfile_builder.py
index ee67c7c16a..e9ac0db2a0 100644
--- a/server_addon/nuke/server/settings/workfile_builder.py
+++ b/server_addon/nuke/server/settings/workfile_builder.py
@@ -48,20 +48,30 @@ class BuilderProfileModel(BaseSettingsModel):
         title="Task names"
     )
     current_context: list[BuilderProfileItemModel] = Field(
-        title="Current context")
+        default_factory=list,
+        title="Current context"
+    )
     linked_assets: list[BuilderProfileItemModel] = Field(
-        title="Linked assets/shots")
+        default_factory=list,
+        title="Linked assets/shots"
+    )
 
 
 class WorkfileBuilderModel(BaseSettingsModel):
     create_first_version: bool = Field(
         title="Create first workfile")
     custom_templates: list[CustomTemplateModel] = Field(
-        title="Custom templates")
+        default_factory=list,
+        title="Custom templates"
+    )
     builder_on_start: bool = Field(
-        title="Run Builder at first workfile")
+        default=False,
+        title="Run Builder at first workfile"
+    )
     profiles: list[BuilderProfileModel] = Field(
-        title="Builder profiles")
+        default_factory=list,
+        title="Builder profiles"
+    )
 
 
 DEFAULT_WORKFILE_BUILDER_SETTINGS = {

From ee050fe63ba6c498fd736bcf2e1bcb1226e49ed9 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Thu, 7 Sep 2023 14:47:47 +0200
Subject: [PATCH 186/366] clearing todos and improving docstrings

---
 server_addon/nuke/server/settings/common.py   |  6 ------
 .../nuke/server/settings/create_plugins.py    | 19 -------------------
 server_addon/nuke/server/settings/dirmap.py   | 13 -------------
 server_addon/nuke/server/settings/imageio.py  | 15 ++++-----------
 .../nuke/server/settings/loader_plugins.py    |  8 --------
 server_addon/nuke/server/settings/main.py     |  4 +---
 .../nuke/server/settings/publish_plugins.py   | 17 -----------------
 .../nuke/server/settings/scriptsmenu.py       |  1 -
 .../settings/templated_workfile_build.py      |  1 +
 .../nuke/server/settings/workfile_builder.py  |  2 ++
 10 files changed, 8 insertions(+), 78 deletions(-)

diff --git a/server_addon/nuke/server/settings/common.py b/server_addon/nuke/server/settings/common.py
index 700f01f3dc..2bc3c9be81 100644
--- a/server_addon/nuke/server/settings/common.py
+++ b/server_addon/nuke/server/settings/common.py
@@ -89,12 +89,6 @@ knob_types_enum = [
 
 
 class KnobModel(BaseSettingsModel):
-    """# TODO: new data structure
-    - v3 was having type, name, value but
-    ayon is not able to make it the same. Current model is
-    defining `type` as `text` and instead of `value` the key is `text`.
-    So if `type` is `boolean` then key is `boolean` (value).
-    """
     _layout = "expanded"
 
     type: str = Field(
diff --git a/server_addon/nuke/server/settings/create_plugins.py b/server_addon/nuke/server/settings/create_plugins.py
index b89188a77a..80aec51ae0 100644
--- a/server_addon/nuke/server/settings/create_plugins.py
+++ b/server_addon/nuke/server/settings/create_plugins.py
@@ -16,13 +16,10 @@ def instance_attributes_enum():
 
 
 class PrenodeModel(BaseSettingsModel):
-    # TODO: missing in host api
-    # - good for `dependency`
     name: str = Field(
         title="Node name"
     )
 
-    # TODO: `nodeclass` should be renamed to `nuke_node_class`
     nodeclass: str = Field(
         "",
         title="Node class"
@@ -32,10 +29,6 @@ class PrenodeModel(BaseSettingsModel):
         title="Incoming dependency"
     )
 
-    """# TODO: Changes in host api:
-    - Need complete rework of knob types in nuke integration.
-    - We could not support v3 style of settings.
-    """
     knobs: list[KnobModel] = Field(
         default_factory=list,
         title="Knobs",
@@ -62,10 +55,6 @@ class CreateWriteRenderModel(BaseSettingsModel):
         title="Instance attributes"
     )
 
-    """# TODO: Changes in host api:
-    - prenodes key was originally dict and now is list
-      (we could not support v3 style of settings)
-    """
     prenodes: list[PrenodeModel] = Field(
         default_factory=list,
         title="Preceding nodes",
@@ -92,10 +81,6 @@ class CreateWritePrerenderModel(BaseSettingsModel):
         title="Instance attributes"
     )
 
-    """# TODO: Changes in host api:
-    - prenodes key was originally dict and now is list
-      (we could not support v3 style of settings)
-    """
     prenodes: list[PrenodeModel] = Field(
         default_factory=list,
         title="Preceding nodes",
@@ -122,10 +107,6 @@ class CreateWriteImageModel(BaseSettingsModel):
         title="Instance attributes"
     )
 
-    """# TODO: Changes in host api:
-    - prenodes key was originally dict and now is list
-      (we could not support v3 style of settings)
-    """
     prenodes: list[PrenodeModel] = Field(
         default_factory=list,
         title="Preceding nodes",
diff --git a/server_addon/nuke/server/settings/dirmap.py b/server_addon/nuke/server/settings/dirmap.py
index 2da6d7bf60..7e3c443957 100644
--- a/server_addon/nuke/server/settings/dirmap.py
+++ b/server_addon/nuke/server/settings/dirmap.py
@@ -25,19 +25,6 @@ class DirmapSettings(BaseSettingsModel):
     )
 
 
-"""# TODO:
-nuke is having originally implemented
-following data inputs:
-
-"nuke-dirmap": {
-    "enabled": false,
-    "paths": {
-        "source-path": [],
-        "destination-path": []
-    }
-}
-"""
-
 DEFAULT_DIRMAP_SETTINGS = {
     "enabled": False,
     "paths": {
diff --git a/server_addon/nuke/server/settings/imageio.py b/server_addon/nuke/server/settings/imageio.py
index 16f9bd309a..44bb72769e 100644
--- a/server_addon/nuke/server/settings/imageio.py
+++ b/server_addon/nuke/server/settings/imageio.py
@@ -9,22 +9,15 @@ from .common import KnobModel
 
 
 class NodesModel(BaseSettingsModel):
-    """# TODO: This needs to be somehow labeled in settings panel
-    or at least it could show gist of configuration
-    """
     _layout = "expanded"
     plugins: list[str] = Field(
         default_factory=list,
         title="Used in plugins"
     )
-    # TODO: rename `nukeNodeClass` to `nuke_node_class`
     nukeNodeClass: str = Field(
         title="Nuke Node Class",
     )
 
-    """ # TODO: Need complete rework of knob types
-    in nuke integration. We could not support v3 style of settings.
-    """
     knobs: list[KnobModel] = Field(
         default_factory=list,
         title="Knobs",
@@ -172,7 +165,7 @@ class ImageIOSettings(BaseSettingsModel):
     _isGroup: bool = True
 
     """# TODO: enhance settings with host api:
-    to restruture settings for simplification.
+    to restructure settings for simplification.
 
     now: nuke/imageio/viewer/viewerProcess
     future: nuke/imageio/viewer
@@ -195,7 +188,7 @@ class ImageIOSettings(BaseSettingsModel):
     )
 
     """# TODO: enhance settings with host api:
-    to restruture settings for simplification.
+    to restructure settings for simplification.
 
     now: nuke/imageio/baking/viewerProcess
     future: nuke/imageio/baking
@@ -217,9 +210,9 @@ class ImageIOSettings(BaseSettingsModel):
         title="Nodes"
     )
     """# TODO: enhance settings with host api:
-    - old settings are using `regexInputs` key but we
+    - [ ] old settings are using `regexInputs` key but we
       need to rename to `regex_inputs`
-    - no need for `inputs` middle part. It can stay
+    - [ ] no need for `inputs` middle part. It can stay
       directly on `regex_inputs`
     """
     regexInputs: RegexInputsModel = Field(
diff --git a/server_addon/nuke/server/settings/loader_plugins.py b/server_addon/nuke/server/settings/loader_plugins.py
index 6db381bffb..51e2c2149b 100644
--- a/server_addon/nuke/server/settings/loader_plugins.py
+++ b/server_addon/nuke/server/settings/loader_plugins.py
@@ -6,10 +6,6 @@ class LoadImageModel(BaseSettingsModel):
     enabled: bool = Field(
         title="Enabled"
     )
-    """# TODO: v3 api used `_representation`
-    New api is hiding it so it had to be renamed
-    to `representations_include`
-    """
     representations_include: list[str] = Field(
         default_factory=list,
         title="Include representations"
@@ -33,10 +29,6 @@ class LoadClipModel(BaseSettingsModel):
     enabled: bool = Field(
         title="Enabled"
     )
-    """# TODO: v3 api used `_representation`
-    New api is hiding it so it had to be renamed
-    to `representations_include`
-    """
     representations_include: list[str] = Field(
         default_factory=list,
         title="Include representations"
diff --git a/server_addon/nuke/server/settings/main.py b/server_addon/nuke/server/settings/main.py
index 4687d48ac9..cdaaa3a9e2 100644
--- a/server_addon/nuke/server/settings/main.py
+++ b/server_addon/nuke/server/settings/main.py
@@ -59,9 +59,7 @@ class NukeSettings(BaseSettingsModel):
         default_factory=ImageIOSettings,
         title="Color Management (imageio)",
     )
-    """# TODO: fix host api:
-    - rename  `nuke-dirmap` to `dirmap` was inevitable
-    """
+
     dirmap: DirmapSettings = Field(
         default_factory=DirmapSettings,
         title="Nuke Directory Mapping",
diff --git a/server_addon/nuke/server/settings/publish_plugins.py b/server_addon/nuke/server/settings/publish_plugins.py
index de21870d5f..c78685534f 100644
--- a/server_addon/nuke/server/settings/publish_plugins.py
+++ b/server_addon/nuke/server/settings/publish_plugins.py
@@ -28,11 +28,9 @@ def nuke_product_types_enum():
 
 
 class NodeModel(BaseSettingsModel):
-    # TODO: missing in host api
     name: str = Field(
         title="Node name"
     )
-    # TODO: `nodeclass` rename to `nuke_node_class`
     nodeclass: str = Field(
         "",
         title="Node class"
@@ -41,10 +39,6 @@ class NodeModel(BaseSettingsModel):
         "",
         title="Incoming dependency"
     )
-    """# TODO: Changes in host api:
-    - Need complete rework of knob types in nuke integration.
-    - We could not support v3 style of settings.
-    """
     knobs: list[KnobModel] = Field(
         default_factory=list,
         title="Knobs",
@@ -100,10 +94,6 @@ class ExtractThumbnailModel(BaseSettingsModel):
     use_rendered: bool = Field(title="Use rendered images")
     bake_viewer_process: bool = Field(title="Bake view process")
     bake_viewer_input_process: bool = Field(title="Bake viewer input process")
-    """# TODO: needs to rewrite from v3 to ayon
-    - `nodes` in v3 was dict but now `prenodes` is list of dict
-    - also later `nodes` should be `prenodes`
-    """
 
     nodes: list[NodeModel] = Field(
         default_factory=list,
@@ -216,12 +206,6 @@ class ExctractSlateFrameParamModel(BaseSettingsModel):
 
 class ExtractSlateFrameModel(BaseSettingsModel):
     viewer_lut_raw: bool = Field(title="Viewer lut raw")
-    """# TODO: v3 api different model:
-    - not possible to replicate v3 model:
-        {"name": [bool, str]}
-    - not it is:
-        {"name": {"enabled": bool, "template": str}}
-    """
     key_value_mapping: ExctractSlateFrameParamModel = Field(
         title="Key value mapping",
         default_factory=ExctractSlateFrameParamModel
@@ -290,7 +274,6 @@ class PublishPuginsModel(BaseSettingsModel):
         title="Extract Slate Frame",
         default_factory=ExtractSlateFrameModel
     )
-    # TODO: plugin should be renamed - `workfile` not `script`
     IncrementScriptVersion: IncrementScriptVersionModel = Field(
         title="Increment Workfile Version",
         default_factory=IncrementScriptVersionModel,
diff --git a/server_addon/nuke/server/settings/scriptsmenu.py b/server_addon/nuke/server/settings/scriptsmenu.py
index 9d1c32ebac..0b2d660da5 100644
--- a/server_addon/nuke/server/settings/scriptsmenu.py
+++ b/server_addon/nuke/server/settings/scriptsmenu.py
@@ -17,7 +17,6 @@ class ScriptsmenuSettings(BaseSettingsModel):
     """Nuke script menu project settings."""
     _isGroup = True
 
-    # TODO: in api rename key `name` to `menu_name`
     name: str = Field(title="Menu Name")
     definition: list[ScriptsmenuSubmodel] = Field(
         default_factory=list,
diff --git a/server_addon/nuke/server/settings/templated_workfile_build.py b/server_addon/nuke/server/settings/templated_workfile_build.py
index e0245c8d06..0899be841e 100644
--- a/server_addon/nuke/server/settings/templated_workfile_build.py
+++ b/server_addon/nuke/server/settings/templated_workfile_build.py
@@ -28,6 +28,7 @@ class TemplatedWorkfileProfileModel(BaseSettingsModel):
 
 
 class TemplatedWorkfileBuildModel(BaseSettingsModel):
+    """Settings for templated workfile builder."""
     profiles: list[TemplatedWorkfileProfileModel] = Field(
         default_factory=list
     )
diff --git a/server_addon/nuke/server/settings/workfile_builder.py b/server_addon/nuke/server/settings/workfile_builder.py
index e9ac0db2a0..3ae3b08788 100644
--- a/server_addon/nuke/server/settings/workfile_builder.py
+++ b/server_addon/nuke/server/settings/workfile_builder.py
@@ -58,6 +58,8 @@ class BuilderProfileModel(BaseSettingsModel):
 
 
 class WorkfileBuilderModel(BaseSettingsModel):
+    """[deprecated] use Template Workfile Build Settings instead.
+    """
     create_first_version: bool = Field(
         title="Create first workfile")
     custom_templates: list[CustomTemplateModel] = Field(

From 9d2fc2fca4622e8c91ba4539034a03f67b57fc40 Mon Sep 17 00:00:00 2001
From: Mustafa-Zarkash <mustafataherzaky@outlook.com>
Date: Thu, 7 Sep 2023 22:30:03 +0300
Subject: [PATCH 187/366] Jakub comments

---
 openpype/hosts/houdini/api/lib.py                    | 12 +-----------
 .../plugins/inventory/set_camera_resolution.py       |  6 +++---
 2 files changed, 4 insertions(+), 14 deletions(-)

diff --git a/openpype/hosts/houdini/api/lib.py b/openpype/hosts/houdini/api/lib.py
index f83519ddb8..eff98c05f1 100644
--- a/openpype/hosts/houdini/api/lib.py
+++ b/openpype/hosts/houdini/api/lib.py
@@ -651,16 +651,6 @@ def get_color_management_preferences():
     }
 
 
-def get_current_asset_doc():
-    """Get asset document of the current asset. """
-
-    project_name = get_current_project_name()
-    asset_name = get_current_asset_name()
-    asset_doc = get_asset_by_name(project_name, asset_name)
-
-    return asset_doc
-
-
 def get_resolution_from_doc(doc):
     """Get resolution from the given asset document. """
 
@@ -683,7 +673,7 @@ def set_camera_resolution(camera, asset_doc=None):
     """Apply resolution to camera from asset document of the publish"""
 
     if not asset_doc:
-        asset_doc = get_current_asset_doc()
+        asset_doc = get_current_project_asset()
 
     resolution = get_resolution_from_doc(asset_doc)
 
diff --git a/openpype/hosts/houdini/plugins/inventory/set_camera_resolution.py b/openpype/hosts/houdini/plugins/inventory/set_camera_resolution.py
index 5dd94232b8..97b94e66aa 100644
--- a/openpype/hosts/houdini/plugins/inventory/set_camera_resolution.py
+++ b/openpype/hosts/houdini/plugins/inventory/set_camera_resolution.py
@@ -3,7 +3,7 @@ from openpype.hosts.houdini.api.lib import (
     get_camera_from_container,
     set_camera_resolution
 )
-
+from openpype.pipeline.context_tools import get_current_project_asset
 
 class SetCameraResolution(InventoryAction):
 
@@ -13,13 +13,13 @@ class SetCameraResolution(InventoryAction):
 
     @staticmethod
     def is_compatible(container):
-        print(container)
         return (
             container.get("loader") == "CameraLoader"
         )
 
     def process(self, containers):
+        asset_doc = get_current_project_asset()
         for container in containers:
             node = container["node"]
             camera = get_camera_from_container(node)
-            set_camera_resolution(camera)
+            set_camera_resolution(camera, asset_doc)

From d38d25308dc393ced6504e86e925d8c821c92868 Mon Sep 17 00:00:00 2001
From: Mustafa-Zarkash <mustafataherzaky@outlook.com>
Date: Thu, 7 Sep 2023 22:31:48 +0300
Subject: [PATCH 188/366] resolve hound

---
 .../hosts/houdini/plugins/inventory/set_camera_resolution.py     | 1 +
 1 file changed, 1 insertion(+)

diff --git a/openpype/hosts/houdini/plugins/inventory/set_camera_resolution.py b/openpype/hosts/houdini/plugins/inventory/set_camera_resolution.py
index 97b94e66aa..18ececb019 100644
--- a/openpype/hosts/houdini/plugins/inventory/set_camera_resolution.py
+++ b/openpype/hosts/houdini/plugins/inventory/set_camera_resolution.py
@@ -5,6 +5,7 @@ from openpype.hosts.houdini.api.lib import (
 )
 from openpype.pipeline.context_tools import get_current_project_asset
 
+
 class SetCameraResolution(InventoryAction):
 
     label = "Set Camera Resolution"

From 572d6e3ab52d5d398a9a25fd4405cad4fecea796 Mon Sep 17 00:00:00 2001
From: Mustafa-Zarkash <mustafataherzaky@outlook.com>
Date: Fri, 8 Sep 2023 12:44:14 +0300
Subject: [PATCH 189/366] update ayon settings

---
 .../houdini/server/settings/publish_plugins.py       | 12 ++++++------
 server_addon/houdini/server/version.py               |  2 +-
 2 files changed, 7 insertions(+), 7 deletions(-)

diff --git a/server_addon/houdini/server/settings/publish_plugins.py b/server_addon/houdini/server/settings/publish_plugins.py
index 528e847fce..6ceff028a5 100644
--- a/server_addon/houdini/server/settings/publish_plugins.py
+++ b/server_addon/houdini/server/settings/publish_plugins.py
@@ -167,14 +167,14 @@ class PublishPluginsModel(BaseSettingsModel):
     ValidateContainers: BasicValidateModel = Field(
         default_factory=BasicValidateModel,
         title="Validate Latest Containers.")
-    ValidateSubsetName: ValidateContainersModel = Field(
-        default_factory=ValidateContainersModel,
+    ValidateSubsetName: BasicValidateModel = Field(
+        default_factory=BasicValidateModel,
         title="Validate Subset Name.")
-    ValidateMeshIsStatic: ValidateContainersModel = Field(
-        default_factory=ValidateContainersModel,
+    ValidateMeshIsStatic: BasicValidateModel = Field(
+        default_factory=BasicValidateModel,
         title="Validate Mesh is Static.")
-    ValidateUnrealStaticMeshName: ValidateContainersModel = Field(
-        default_factory=ValidateContainersModel,
+    ValidateUnrealStaticMeshName: BasicValidateModel = Field(
+        default_factory=BasicValidateModel,
         title="Validate Unreal Static Mesh Name.")
 
 
diff --git a/server_addon/houdini/server/version.py b/server_addon/houdini/server/version.py
index b3f4756216..ae7362549b 100644
--- a/server_addon/houdini/server/version.py
+++ b/server_addon/houdini/server/version.py
@@ -1 +1 @@
-__version__ = "0.1.2"
+__version__ = "0.1.3"

From 81446b1bbb972bcb8ee8fa9c9df06868d7c008aa Mon Sep 17 00:00:00 2001
From: Simone Barbieri <simone.barbieri@hey.com>
Date: Mon, 11 Sep 2023 11:55:49 +0100
Subject: [PATCH 190/366] Remove hardcoded subset name for reviews

---
 openpype/hosts/blender/plugins/publish/collect_review.py | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/openpype/hosts/blender/plugins/publish/collect_review.py b/openpype/hosts/blender/plugins/publish/collect_review.py
index 6459927015..3bf2e39e24 100644
--- a/openpype/hosts/blender/plugins/publish/collect_review.py
+++ b/openpype/hosts/blender/plugins/publish/collect_review.py
@@ -39,15 +39,11 @@ class CollectReview(pyblish.api.InstancePlugin):
         ]
 
         if not instance.data.get("remove"):
-
-            task = instance.context.data["task"]
-
             # Store focal length in `burninDataMembers`
             burninData = instance.data.setdefault("burninDataMembers", {})
             burninData["focalLength"] = focal_length
 
             instance.data.update({
-                "subset": f"{task}Review",
                 "review_camera": camera,
                 "frameStart": instance.context.data["frameStart"],
                 "frameEnd": instance.context.data["frameEnd"],

From 2d255f15bedc2aca61177d80cad987b7108b5a26 Mon Sep 17 00:00:00 2001
From: Mustafa-Zarkash <mustafataherzaky@outlook.com>
Date: Mon, 11 Sep 2023 14:05:24 +0300
Subject: [PATCH 191/366] validate empty nodes and invalid prims

---
 .../publish/validate_fbx_output_node.py       | 109 ++++++++++++++++--
 1 file changed, 100 insertions(+), 9 deletions(-)

diff --git a/openpype/hosts/houdini/plugins/publish/validate_fbx_output_node.py b/openpype/hosts/houdini/plugins/publish/validate_fbx_output_node.py
index 503a3bb3c1..9f6a1b8767 100644
--- a/openpype/hosts/houdini/plugins/publish/validate_fbx_output_node.py
+++ b/openpype/hosts/houdini/plugins/publish/validate_fbx_output_node.py
@@ -5,7 +5,8 @@ from openpype.hosts.houdini.api.action import (
     SelectInvalidAction,
     SelectROPAction,
 )
-
+from openpype.hosts.houdini.api.lib import get_obj_node_output
+from collections import defaultdict
 import hou
 
 
@@ -16,27 +17,38 @@ class ValidateFBXOutputNode(pyblish.api.InstancePlugin):
         - The Output Node Path is set.
         - The Output Node Path refers to an existing object.
         - The Output Node is a Sop or Obj node.
+        - The Output Node has geometry data.
     """
 
     order = pyblish.api.ValidatorOrder
     families = ["fbx"]
     hosts = ["houdini"]
-    label = "Validate Output Node"
+    label = "Validate FBX Output Node"
     actions = [SelectROPAction, SelectInvalidAction]
 
     def process(self, instance):
 
-        invalid = self.get_invalid(instance)
+        invalid = self.get_invalid_categorized(instance)
         if invalid:
             raise PublishValidationError(
                 "Output node(s) are incorrect",
                 title="Invalid output node(s)"
             )
-
     @classmethod
     def get_invalid(cls, instance):
+        out = cls.get_invalid_categorized(instance).values()
+        invalid = []
+        for row in out:
+            invalid += row
+        return invalid
+
+
+    @classmethod
+    def get_invalid_categorized(cls, instance):
         output_node = instance.data.get("output_node")
 
+        # Check if The Output Node Path is set and
+        #  refers to an existing object.
         if output_node is None:
             rop_node = hou.node(instance.data["instance_node"])
             cls.log.error(
@@ -46,11 +58,90 @@ class ValidateFBXOutputNode(pyblish.api.InstancePlugin):
 
             return [rop_node]
 
-        if output_node.type().category().name() not in ["Sop", "Object"]:
+        # Check if the Output Node is a Sop or Obj node
+        #  also, make a dictionary of all geo obj nodes
+        #  and their sop output node.
+        all_outputs = {}
+        # if user selects an ObjSubnet or an ObjNetwork
+        if output_node.childTypeCategory() == hou.objNodeTypeCategory():
+            all_outputs.update({output_node : {}})
+            for node in output_node.allSubChildren():
+                if node.type().name() == "geo":
+                    out = get_obj_node_output(node)
+                    all_outputs[output_node].update({node: out})
+
+        # elif user selects a geometry ObjNode
+        elif output_node.type().name() == "geo":
+            out = get_obj_node_output(output_node)
+            all_outputs.update({output_node: out})
+
+        # elif user selects a SopNode
+        elif output_node.type().category().name() == "Sop":
+            # expetional case because output_node is not an obj node
+            all_outputs.update({output_node: output_node})
+
+        # Then it's wrong node type
+        else:
             cls.log.error(
-                "Output node %s is not a SOP or OBJ node. "
-                "It must point to a SOP or OBJ node, "
-                "instead found category type: %s"
-                % (output_node.path(), output_node.type().category().name())
+                "Output node %s is not a SOP or OBJ Geo or OBJ SubNet node. "
+                "Instead found category type: %s %s"
+                , output_node.path(), output_node.type().category().name()
+                , output_node.type().name()
             )
             return [output_node]
+
+        # Check if geo obj node have geometry.
+        #  return geo obj node if their sop output node
+        valid = {}
+        invalid = defaultdict(list)
+        cls.filter_inner_dict(all_outputs, valid, invalid)
+
+        invalid_prim_types = ["VDB", "Volume"]
+        for obj_node, sop_node in valid.items():
+            # Empty Geometry test
+            if not hasattr(sop_node, "geometry"):
+                invalid["empty_geometry"].append(sop_node)
+                cls.log.error(
+                    "Sop node '%s' includes no geometry."
+                    , sop_node.path()
+                )
+                continue
+
+            frame = instance.data.get("frameStart", 0)
+            geo = sop_node.geometryAtFrame(frame)
+            if len(geo.iterPrims()) == 0:
+                invalid["empty_geometry"].append(sop_node)
+                cls.log.error(
+                    "Sop node '%s' includes no geometry."
+                    , sop_node.path()
+                )
+                continue
+
+            # Invalid Prims test
+            for prim_type in invalid_prim_types:
+                if geo.countPrimType(prim_type) > 0:
+                    invalid["invalid_prims"].append(sop_node)
+                    cls.log.error(
+                        "Sop node '%s' includes invliad prims of type '%s'."
+                        , sop_node.path(), prim_type
+                    )
+
+        if invalid:
+            return invalid
+
+    @classmethod
+    def filter_inner_dict(cls, d: dict, valid: dict, invalid: dict):
+        """Parse the dictionary and filter items to valid and invalid.
+
+        Invalid items have empty values like {}, None
+        Valid dictionary is a flattened dictionary that includes
+          the valid inner items.
+        """
+
+        for k, v in d.items():
+            if not v:
+                invalid["empty_objs"].append(k)
+            elif isinstance(v, dict):
+                cls.filter_inner_dict(v, valid, invalid)
+            else:
+                valid.update({k:v})

From ad0c6245cdd347fed47b075e1ecb13e5dfb8c359 Mon Sep 17 00:00:00 2001
From: Mustafa-Zarkash <mustafataherzaky@outlook.com>
Date: Mon, 11 Sep 2023 15:52:11 +0300
Subject: [PATCH 192/366] remove unnecessary logic

---
 .../publish/validate_fbx_output_node.py       | 89 +++++++++----------
 1 file changed, 40 insertions(+), 49 deletions(-)

diff --git a/openpype/hosts/houdini/plugins/publish/validate_fbx_output_node.py b/openpype/hosts/houdini/plugins/publish/validate_fbx_output_node.py
index 9f6a1b8767..d06ef593d3 100644
--- a/openpype/hosts/houdini/plugins/publish/validate_fbx_output_node.py
+++ b/openpype/hosts/houdini/plugins/publish/validate_fbx_output_node.py
@@ -28,23 +28,15 @@ class ValidateFBXOutputNode(pyblish.api.InstancePlugin):
 
     def process(self, instance):
 
-        invalid = self.get_invalid_categorized(instance)
+        invalid = self.get_invalid(instance)
         if invalid:
             raise PublishValidationError(
                 "Output node(s) are incorrect",
                 title="Invalid output node(s)"
             )
+
     @classmethod
     def get_invalid(cls, instance):
-        out = cls.get_invalid_categorized(instance).values()
-        invalid = []
-        for row in out:
-            invalid += row
-        return invalid
-
-
-    @classmethod
-    def get_invalid_categorized(cls, instance):
         output_node = instance.data.get("output_node")
 
         # Check if The Output Node Path is set and
@@ -58,27 +50,47 @@ class ValidateFBXOutputNode(pyblish.api.InstancePlugin):
 
             return [rop_node]
 
-        # Check if the Output Node is a Sop or Obj node
-        #  also, make a dictionary of all geo obj nodes
-        #  and their sop output node.
-        all_outputs = {}
-        # if user selects an ObjSubnet or an ObjNetwork
+        # Check if the Output Node is a Sop or an Obj node
+        #  also, list all sop output nodes inside as well as
+        #  invalid empty nodes.
+        all_out_sops = []
+        invalid = defaultdict(list)
+
+        # if output_node is an ObjSubnet or an ObjNetwork
         if output_node.childTypeCategory() == hou.objNodeTypeCategory():
-            all_outputs.update({output_node : {}})
             for node in output_node.allSubChildren():
                 if node.type().name() == "geo":
                     out = get_obj_node_output(node)
-                    all_outputs[output_node].update({node: out})
+                    if out:
+                        all_out_sops.append(out)
+                    else:
+                        invalid["empty_objs"].append(node)
+                        cls.log.error(
+                            "Geo Obj Node '%s' is empty!"
+                            , node.path()
+                        )
+            if not all_out_sops:
+                invalid["empty_objs"].append(output_node)
+                cls.log.error(
+                    "Output Node '%s' is empty!"
+                    , node.path()
+                )
 
-        # elif user selects a geometry ObjNode
+        # elif output_node is an ObjNode
         elif output_node.type().name() == "geo":
             out = get_obj_node_output(output_node)
-            all_outputs.update({output_node: out})
+            if out:
+                all_out_sops.append(out)
+            else:
+                invalid["empty_objs"].append(node)
+                cls.log.error(
+                    "Output Node '%s' is empty!"
+                    , node.path()
+                )
 
-        # elif user selects a SopNode
+        # elif output_node is a SopNode
         elif output_node.type().category().name() == "Sop":
-            # expetional case because output_node is not an obj node
-            all_outputs.update({output_node: output_node})
+                all_out_sops.append(output_node)
 
         # Then it's wrong node type
         else:
@@ -90,19 +102,15 @@ class ValidateFBXOutputNode(pyblish.api.InstancePlugin):
             )
             return [output_node]
 
-        # Check if geo obj node have geometry.
-        #  return geo obj node if their sop output node
-        valid = {}
-        invalid = defaultdict(list)
-        cls.filter_inner_dict(all_outputs, valid, invalid)
-
+        # Check if all output sop nodes have geometry
+        #  and don't contain invalid prims
         invalid_prim_types = ["VDB", "Volume"]
-        for obj_node, sop_node in valid.items():
+        for sop_node in all_out_sops:
             # Empty Geometry test
             if not hasattr(sop_node, "geometry"):
                 invalid["empty_geometry"].append(sop_node)
                 cls.log.error(
-                    "Sop node '%s' includes no geometry."
+                    "Sop node '%s' doesn't include any prims."
                     , sop_node.path()
                 )
                 continue
@@ -112,7 +120,7 @@ class ValidateFBXOutputNode(pyblish.api.InstancePlugin):
             if len(geo.iterPrims()) == 0:
                 invalid["empty_geometry"].append(sop_node)
                 cls.log.error(
-                    "Sop node '%s' includes no geometry."
+                    "Sop node '%s' doesn't include any prims."
                     , sop_node.path()
                 )
                 continue
@@ -127,21 +135,4 @@ class ValidateFBXOutputNode(pyblish.api.InstancePlugin):
                     )
 
         if invalid:
-            return invalid
-
-    @classmethod
-    def filter_inner_dict(cls, d: dict, valid: dict, invalid: dict):
-        """Parse the dictionary and filter items to valid and invalid.
-
-        Invalid items have empty values like {}, None
-        Valid dictionary is a flattened dictionary that includes
-          the valid inner items.
-        """
-
-        for k, v in d.items():
-            if not v:
-                invalid["empty_objs"].append(k)
-            elif isinstance(v, dict):
-                cls.filter_inner_dict(v, valid, invalid)
-            else:
-                valid.update({k:v})
+            return [output_node]

From 20f4b62213530118829dbbe027d25c982f80675b Mon Sep 17 00:00:00 2001
From: Mustafa-Zarkash <mustafataherzaky@outlook.com>
Date: Mon, 11 Sep 2023 16:33:28 +0300
Subject: [PATCH 193/366] Remove unnecessary line

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

diff --git a/openpype/hosts/houdini/plugins/publish/validate_mesh_is_static.py b/openpype/hosts/houdini/plugins/publish/validate_mesh_is_static.py
index 4d0904eb53..6bf94f7536 100644
--- a/openpype/hosts/houdini/plugins/publish/validate_mesh_is_static.py
+++ b/openpype/hosts/houdini/plugins/publish/validate_mesh_is_static.py
@@ -30,7 +30,7 @@ class ValidateMeshIsStatic(pyblish.api.InstancePlugin,
 
         invalid = self.get_invalid(instance)
         if invalid:
-            nodes = [n.path() for n in invalid if isinstance(n, hou.Node)]
+            nodes = [n.path() for n in invalid]
             raise PublishValidationError(
                 "See log for details. "
                 "Invalid nodes: {0}".format(nodes)

From 21c174c47bd761392ff6856346bdedf5ece732d9 Mon Sep 17 00:00:00 2001
From: Mustafa-Zarkash <mustafataherzaky@outlook.com>
Date: Mon, 11 Sep 2023 16:34:05 +0300
Subject: [PATCH 194/366] update error message

---
 .../publish/validate_fbx_output_node.py       | 25 ++++++++++---------
 1 file changed, 13 insertions(+), 12 deletions(-)

diff --git a/openpype/hosts/houdini/plugins/publish/validate_fbx_output_node.py b/openpype/hosts/houdini/plugins/publish/validate_fbx_output_node.py
index d06ef593d3..d493092755 100644
--- a/openpype/hosts/houdini/plugins/publish/validate_fbx_output_node.py
+++ b/openpype/hosts/houdini/plugins/publish/validate_fbx_output_node.py
@@ -6,7 +6,6 @@ from openpype.hosts.houdini.api.action import (
     SelectROPAction,
 )
 from openpype.hosts.houdini.api.lib import get_obj_node_output
-from collections import defaultdict
 import hou
 
 
@@ -30,8 +29,10 @@ class ValidateFBXOutputNode(pyblish.api.InstancePlugin):
 
         invalid = self.get_invalid(instance)
         if invalid:
+            nodes = [n.path() for n in invalid]
             raise PublishValidationError(
-                "Output node(s) are incorrect",
+                "See log for details. "
+                "Invalid nodes: {0}".format(nodes),
                 title="Invalid output node(s)"
             )
 
@@ -54,7 +55,7 @@ class ValidateFBXOutputNode(pyblish.api.InstancePlugin):
         #  also, list all sop output nodes inside as well as
         #  invalid empty nodes.
         all_out_sops = []
-        invalid = defaultdict(list)
+        invalid = []
 
         # if output_node is an ObjSubnet or an ObjNetwork
         if output_node.childTypeCategory() == hou.objNodeTypeCategory():
@@ -64,13 +65,13 @@ class ValidateFBXOutputNode(pyblish.api.InstancePlugin):
                     if out:
                         all_out_sops.append(out)
                     else:
-                        invalid["empty_objs"].append(node)
+                        invalid.append(node)  # empty_objs
                         cls.log.error(
                             "Geo Obj Node '%s' is empty!"
                             , node.path()
                         )
             if not all_out_sops:
-                invalid["empty_objs"].append(output_node)
+                invalid.append(output_node)  # empty_objs
                 cls.log.error(
                     "Output Node '%s' is empty!"
                     , node.path()
@@ -82,7 +83,7 @@ class ValidateFBXOutputNode(pyblish.api.InstancePlugin):
             if out:
                 all_out_sops.append(out)
             else:
-                invalid["empty_objs"].append(node)
+                invalid.append(node)  # empty_objs
                 cls.log.error(
                     "Output Node '%s' is empty!"
                     , node.path()
@@ -92,7 +93,7 @@ class ValidateFBXOutputNode(pyblish.api.InstancePlugin):
         elif output_node.type().category().name() == "Sop":
                 all_out_sops.append(output_node)
 
-        # Then it's wrong node type
+        # Then it's a wrong node type
         else:
             cls.log.error(
                 "Output node %s is not a SOP or OBJ Geo or OBJ SubNet node. "
@@ -108,7 +109,7 @@ class ValidateFBXOutputNode(pyblish.api.InstancePlugin):
         for sop_node in all_out_sops:
             # Empty Geometry test
             if not hasattr(sop_node, "geometry"):
-                invalid["empty_geometry"].append(sop_node)
+                invalid.append(sop_node)  # empty_geometry
                 cls.log.error(
                     "Sop node '%s' doesn't include any prims."
                     , sop_node.path()
@@ -118,7 +119,7 @@ class ValidateFBXOutputNode(pyblish.api.InstancePlugin):
             frame = instance.data.get("frameStart", 0)
             geo = sop_node.geometryAtFrame(frame)
             if len(geo.iterPrims()) == 0:
-                invalid["empty_geometry"].append(sop_node)
+                invalid.append(sop_node)  # empty_geometry
                 cls.log.error(
                     "Sop node '%s' doesn't include any prims."
                     , sop_node.path()
@@ -128,11 +129,11 @@ class ValidateFBXOutputNode(pyblish.api.InstancePlugin):
             # Invalid Prims test
             for prim_type in invalid_prim_types:
                 if geo.countPrimType(prim_type) > 0:
-                    invalid["invalid_prims"].append(sop_node)
+                    invalid.append(sop_node)  # invalid_prims
                     cls.log.error(
-                        "Sop node '%s' includes invliad prims of type '%s'."
+                        "Sop node '%s' includes invalid prims of type '%s'."
                         , sop_node.path(), prim_type
                     )
 
         if invalid:
-            return [output_node]
+            return invalid

From 9105e74b4326686510536cc9e2f8fd37f44be563 Mon Sep 17 00:00:00 2001
From: Mustafa-Zarkash <mustafataherzaky@outlook.com>
Date: Mon, 11 Sep 2023 16:43:26 +0300
Subject: [PATCH 195/366] resolve hound

---
 .../publish/validate_fbx_output_node.py       | 32 +++++++++----------
 .../publish/validate_mesh_is_static.py        |  2 --
 2 files changed, 16 insertions(+), 18 deletions(-)

diff --git a/openpype/hosts/houdini/plugins/publish/validate_fbx_output_node.py b/openpype/hosts/houdini/plugins/publish/validate_fbx_output_node.py
index d493092755..ea13d25122 100644
--- a/openpype/hosts/houdini/plugins/publish/validate_fbx_output_node.py
+++ b/openpype/hosts/houdini/plugins/publish/validate_fbx_output_node.py
@@ -67,14 +67,14 @@ class ValidateFBXOutputNode(pyblish.api.InstancePlugin):
                     else:
                         invalid.append(node)  # empty_objs
                         cls.log.error(
-                            "Geo Obj Node '%s' is empty!"
-                            , node.path()
+                            "Geo Obj Node '%s' is empty!",
+                            node.path()
                         )
             if not all_out_sops:
                 invalid.append(output_node)  # empty_objs
                 cls.log.error(
-                    "Output Node '%s' is empty!"
-                    , node.path()
+                    "Output Node '%s' is empty!",
+                    node.path()
                 )
 
         # elif output_node is an ObjNode
@@ -85,21 +85,21 @@ class ValidateFBXOutputNode(pyblish.api.InstancePlugin):
             else:
                 invalid.append(node)  # empty_objs
                 cls.log.error(
-                    "Output Node '%s' is empty!"
-                    , node.path()
+                    "Output Node '%s' is empty!",
+                    node.path()
                 )
 
         # elif output_node is a SopNode
         elif output_node.type().category().name() == "Sop":
-                all_out_sops.append(output_node)
+            all_out_sops.append(output_node)
 
         # Then it's a wrong node type
         else:
             cls.log.error(
                 "Output node %s is not a SOP or OBJ Geo or OBJ SubNet node. "
-                "Instead found category type: %s %s"
-                , output_node.path(), output_node.type().category().name()
-                , output_node.type().name()
+                "Instead found category type: %s %s",
+                output_node.path(), output_node.type().category().name(),
+                output_node.type().name()
             )
             return [output_node]
 
@@ -111,8 +111,8 @@ class ValidateFBXOutputNode(pyblish.api.InstancePlugin):
             if not hasattr(sop_node, "geometry"):
                 invalid.append(sop_node)  # empty_geometry
                 cls.log.error(
-                    "Sop node '%s' doesn't include any prims."
-                    , sop_node.path()
+                    "Sop node '%s' doesn't include any prims.",
+                    sop_node.path()
                 )
                 continue
 
@@ -121,8 +121,8 @@ class ValidateFBXOutputNode(pyblish.api.InstancePlugin):
             if len(geo.iterPrims()) == 0:
                 invalid.append(sop_node)  # empty_geometry
                 cls.log.error(
-                    "Sop node '%s' doesn't include any prims."
-                    , sop_node.path()
+                    "Sop node '%s' doesn't include any prims.",
+                    sop_node.path()
                 )
                 continue
 
@@ -131,8 +131,8 @@ class ValidateFBXOutputNode(pyblish.api.InstancePlugin):
                 if geo.countPrimType(prim_type) > 0:
                     invalid.append(sop_node)  # invalid_prims
                     cls.log.error(
-                        "Sop node '%s' includes invalid prims of type '%s'."
-                        , sop_node.path(), prim_type
+                        "Sop node '%s' includes invalid prims of type '%s'.",
+                        sop_node.path(), prim_type
                     )
 
         if invalid:
diff --git a/openpype/hosts/houdini/plugins/publish/validate_mesh_is_static.py b/openpype/hosts/houdini/plugins/publish/validate_mesh_is_static.py
index 6bf94f7536..b499682e0b 100644
--- a/openpype/hosts/houdini/plugins/publish/validate_mesh_is_static.py
+++ b/openpype/hosts/houdini/plugins/publish/validate_mesh_is_static.py
@@ -10,8 +10,6 @@ from openpype.pipeline.publish import ValidateContentsOrder
 from openpype.hosts.houdini.api.action import SelectInvalidAction
 from openpype.hosts.houdini.api.lib import get_output_children
 
-import hou
-
 
 class ValidateMeshIsStatic(pyblish.api.InstancePlugin,
                            OptionalPyblishPluginMixin):

From 583cfba38c2f4ffbf0c72795ac4adb48d98715e5 Mon Sep 17 00:00:00 2001
From: Mustafa-Zarkash <mustafataherzaky@outlook.com>
Date: Mon, 11 Sep 2023 16:48:38 +0300
Subject: [PATCH 196/366] update doc string

---
 .../hosts/houdini/plugins/publish/validate_fbx_output_node.py    | 1 +
 1 file changed, 1 insertion(+)

diff --git a/openpype/hosts/houdini/plugins/publish/validate_fbx_output_node.py b/openpype/hosts/houdini/plugins/publish/validate_fbx_output_node.py
index ea13d25122..894dad7d72 100644
--- a/openpype/hosts/houdini/plugins/publish/validate_fbx_output_node.py
+++ b/openpype/hosts/houdini/plugins/publish/validate_fbx_output_node.py
@@ -17,6 +17,7 @@ class ValidateFBXOutputNode(pyblish.api.InstancePlugin):
         - The Output Node Path refers to an existing object.
         - The Output Node is a Sop or Obj node.
         - The Output Node has geometry data.
+        - The Output Node doesn't include invalid primitive types.
     """
 
     order = pyblish.api.ValidatorOrder

From 4b27abfae2320e3324cccea63b82a2690097fab5 Mon Sep 17 00:00:00 2001
From: Simone Barbieri <simone.barbieri@hey.com>
Date: Mon, 11 Sep 2023 15:17:17 +0100
Subject: [PATCH 197/366] Implemented several suggestions from reviews

Co-authored-by: Jakub Trllo <43494761+iLLiCiTiT@users.noreply.github.com>
Co-authored-by: Oscar Domingo <oscardomingo@gmail.com>
Co-authored-by: Roy Nieterau <roy_nieterau@hotmail.com>
---
 openpype/hosts/blender/api/colorspace.py               |  8 ++++----
 openpype/hosts/blender/plugins/create/create_render.py | 10 +++-------
 .../projects_schema/schema_project_blender.json        |  2 +-
 .../blender/server/settings/render_settings.py         |  2 +-
 4 files changed, 9 insertions(+), 13 deletions(-)

diff --git a/openpype/hosts/blender/api/colorspace.py b/openpype/hosts/blender/api/colorspace.py
index 59deb514f8..0f504a3be0 100644
--- a/openpype/hosts/blender/api/colorspace.py
+++ b/openpype/hosts/blender/api/colorspace.py
@@ -12,12 +12,12 @@ class LayerMetadata(object):
 
 @attr.s
 class RenderProduct(object):
-    """Getting Colorspace as
-    Specific Render Product Parameter for submitting
+    """
+    Getting Colorspace as Specific Render Product Parameter for submitting
     publish job.
     """
-    colorspace = attr.ib()                      # colorspace
-    view = attr.ib()
+    colorspace = attr.ib()  # colorspace
+    view = attr.ib()        # OCIO view transform
     productName = attr.ib(default=None)
 
 
diff --git a/openpype/hosts/blender/plugins/create/create_render.py b/openpype/hosts/blender/plugins/create/create_render.py
index 62700cb55c..fa3cae6cc8 100644
--- a/openpype/hosts/blender/plugins/create/create_render.py
+++ b/openpype/hosts/blender/plugins/create/create_render.py
@@ -3,13 +3,11 @@ import os
 
 import bpy
 
+from openpype.settings import get_project_settings
 from openpype.pipeline import (
     get_current_project_name,
+    get_current_task_name,
 )
-from openpype.settings import (
-    get_project_settings,
-)
-from openpype.pipeline import get_current_task_name
 from openpype.hosts.blender.api import plugin, lib
 from openpype.hosts.blender.api.pipeline import AVALON_INSTANCES
 
@@ -76,9 +74,7 @@ class CreateRenderlayer(plugin.Creator):
             instance (pyblish.api.Instance): The instance to publish.
             ext (str): The image format to render.
         """
-        output_file = os.path.join(output_path, name)
-
-        render_product = f"{output_file}.####"
+        render_product = f"{os.path.join(output_path, name)}.####"
         render_product = render_product.replace("\\", "/")
 
         return render_product
diff --git a/openpype/settings/entities/schemas/projects_schema/schema_project_blender.json b/openpype/settings/entities/schemas/projects_schema/schema_project_blender.json
index 8db57f49eb..a283a2ff5c 100644
--- a/openpype/settings/entities/schemas/projects_schema/schema_project_blender.json
+++ b/openpype/settings/entities/schemas/projects_schema/schema_project_blender.json
@@ -140,7 +140,7 @@
                                 "label": "Type",
                                 "type": "enum",
                                 "multiselection": false,
-                                "defaults": "color",
+                                "default": "COLOR",
                                 "enum_items": [
                                     {"COLOR": "Color"},
                                     {"VALUE": "Value"}
diff --git a/server_addon/blender/server/settings/render_settings.py b/server_addon/blender/server/settings/render_settings.py
index bef16328d6..7a47095d3c 100644
--- a/server_addon/blender/server/settings/render_settings.py
+++ b/server_addon/blender/server/settings/render_settings.py
@@ -57,7 +57,7 @@ class CustomPassesModel(BaseSettingsModel):
 
     attribute: str = Field("", title="Attribute name")
     value: str = Field(
-        "Color",
+        "COLOR",
         title="Type",
         enum_resolver=custom_passes_types_enum
     )

From 1365bec5188cfb810ee73b442e9393bf918c2ab9 Mon Sep 17 00:00:00 2001
From: Ondrej Samohel <ondrej.samohel@ynput.io>
Date: Mon, 11 Sep 2023 16:19:15 +0200
Subject: [PATCH 198/366] :recycle: add check for produced file

---
 openpype/hosts/max/plugins/publish/extract_model_obj.py | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/openpype/hosts/max/plugins/publish/extract_model_obj.py b/openpype/hosts/max/plugins/publish/extract_model_obj.py
index e522b1e7a1..a5d9ad6597 100644
--- a/openpype/hosts/max/plugins/publish/extract_model_obj.py
+++ b/openpype/hosts/max/plugins/publish/extract_model_obj.py
@@ -3,6 +3,7 @@ import pyblish.api
 from openpype.pipeline import publish, OptionalPyblishPluginMixin
 from pymxs import runtime as rt
 from openpype.hosts.max.api import maintained_selection
+from openpype.pipeline.publish import KnownPublishError
 
 
 class ExtractModelObj(publish.Extractor, OptionalPyblishPluginMixin):
@@ -27,6 +28,7 @@ class ExtractModelObj(publish.Extractor, OptionalPyblishPluginMixin):
         filepath = os.path.join(stagingdir, filename)
         self.log.info("Writing OBJ '%s' to '%s'" % (filepath, stagingdir))
 
+        self.log.info("Performing Extraction ...")
         with maintained_selection():
             # select and export
             node_list = instance.data["members"]
@@ -38,7 +40,10 @@ class ExtractModelObj(publish.Extractor, OptionalPyblishPluginMixin):
                 using=rt.ObjExp,
             )
 
-        self.log.info("Performing Extraction ...")
+        if not os.path.exists(filepath):
+            raise KnownPublishError(
+                "File {} wasn't produced by 3ds max, please check the logs.")
+
         if "representations" not in instance.data:
             instance.data["representations"] = []
 

From 86629c85cab0cb59585f0fd0d6120a2c0c27f7fd Mon Sep 17 00:00:00 2001
From: Ondrej Samohel <ondrej.samohel@ynput.io>
Date: Mon, 11 Sep 2023 16:21:35 +0200
Subject: [PATCH 199/366] :recycle: make usd plugin validator optional

this is temporary hack to allow testing and publishing  models without USD plugin in max as the plugin validator will run always, no matter if the  USD extractor is enabled or not. This will change when #5602 is implemented.
---
 .../max/plugins/publish/validate_usd_plugin.py | 18 +++++++++++++++---
 1 file changed, 15 insertions(+), 3 deletions(-)

diff --git a/openpype/hosts/max/plugins/publish/validate_usd_plugin.py b/openpype/hosts/max/plugins/publish/validate_usd_plugin.py
index 9957e62736..36c4291925 100644
--- a/openpype/hosts/max/plugins/publish/validate_usd_plugin.py
+++ b/openpype/hosts/max/plugins/publish/validate_usd_plugin.py
@@ -1,9 +1,13 @@
 # -*- coding: utf-8 -*-
 """Validator for USD plugin."""
-from openpype.pipeline import PublishValidationError
 from pyblish.api import InstancePlugin, ValidatorOrder
 from pymxs import runtime as rt
 
+from openpype.pipeline import (
+    OptionalPyblishPluginMixin,
+    PublishValidationError
+)
+
 
 def get_plugins() -> list:
     """Get plugin list from 3ds max."""
@@ -17,17 +21,25 @@ def get_plugins() -> list:
     return plugin_info_list
 
 
-class ValidateUSDPlugin(InstancePlugin):
+class ValidateUSDPlugin(OptionalPyblishPluginMixin,
+                        InstancePlugin):
     """Validates if USD plugin is installed or loaded in 3ds max."""
 
     order = ValidatorOrder - 0.01
     families = ["model"]
     hosts = ["max"]
-    label = "USD Plugin"
+    label = "Validate USD Plugin loaded"
+    optional = True
 
     def process(self, instance):
         """Plugin entry point."""
 
+        for sc in ValidateUSDPlugin.__subclasses__():
+            self.log.info(sc)
+
+        if not self.is_active(instance.data):
+            return
+
         plugin_info = get_plugins()
         usd_import = "usdimport.dli"
         if usd_import not in plugin_info:

From ae02fe220aefb292f705f715fea4def1b2192782 Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Mon, 11 Sep 2023 16:28:11 +0200
Subject: [PATCH 200/366] AfterEffects: fix imports of image sequences (#5581)

* Fix loading image sequence in AE

* Fix logic

Files might be list or str

* Update openpype/hosts/aftereffects/plugins/load/load_file.py

Co-authored-by: Jakub Trllo <43494761+iLLiCiTiT@users.noreply.github.com>

---------

Co-authored-by: Jakub Trllo <43494761+iLLiCiTiT@users.noreply.github.com>
---
 openpype/hosts/aftereffects/plugins/load/load_file.py | 9 ++-------
 1 file changed, 2 insertions(+), 7 deletions(-)

diff --git a/openpype/hosts/aftereffects/plugins/load/load_file.py b/openpype/hosts/aftereffects/plugins/load/load_file.py
index def7c927ab..8d52aac546 100644
--- a/openpype/hosts/aftereffects/plugins/load/load_file.py
+++ b/openpype/hosts/aftereffects/plugins/load/load_file.py
@@ -31,13 +31,8 @@ class FileLoader(api.AfterEffectsLoader):
 
         path = self.filepath_from_context(context)
 
-        repr_cont = context["representation"]["context"]
-        if "#" not in path:
-            frame = repr_cont.get("frame")
-            if frame:
-                padding = len(frame)
-                path = path.replace(frame, "#" * padding)
-                import_options['sequence'] = True
+        if len(context["representation"]["files"]) > 1:
+            import_options['sequence'] = True
 
         if not path:
             repr_id = context["representation"]["_id"]

From 1fdbe05905995641f02b4c4c3b2d7e27be6ecf3a Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Mon, 11 Sep 2023 17:21:38 +0200
Subject: [PATCH 201/366] Photoshop: fixed blank Flatten image (#5600)

* OP-6763 - refresh all visible for Flatten image

Previously newly added layers were missing.

* OP-6763 - added explicit image collector

Creator was adding 'layer' metadata from workfile only during collect_instances, it was missing for newly added layers. This should be cleaner approach

* OP-6763 - removed unnecessary method overwrite

Creator is not adding layer to instance, separate collector created.

* OP-6763 - cleanup of names

Was failing when template for subset name for image family contained {layer}

* OP-6763 - cleanup, removed adding layer metadata

Separate collector created, cleaner.
Fixed propagation of mark_for_review

* OP-6763 - using members instead of layer data

Members should be more reliable.

* OP-6763 - updated image from Settings

Explicit subset name template was removed some time ago as confusing.

* OP-6763 - added explicit local plugin

Automated plugin has different logic, local would need to handle if auto_image is disabled by artist

* OP-6763 - Hound

* OP-6345 - fix - review for image family

Image family instance contained flattened content. Now it reuses previously extracted file without need to re-extract.
---
 .../plugins/create/create_flatten_image.py    |  40 +++++++++---
 .../photoshop/plugins/create/create_image.py  |  17 ++---
 .../publish/collect_auto_image_refresh.py     |  24 +++++++
 .../plugins/publish/collect_image.py          |  20 ++++++
 .../plugins/publish/extract_image.py          |   8 ++-
 .../plugins/publish/extract_review.py         |  59 +++++++++++++++---
 website/docs/admin_hosts_photoshop.md         |   7 +--
 .../assets/admin_hosts_photoshop_settings.png | Bin 14364 -> 16718 bytes
 8 files changed, 144 insertions(+), 31 deletions(-)
 create mode 100644 openpype/hosts/photoshop/plugins/publish/collect_auto_image_refresh.py
 create mode 100644 openpype/hosts/photoshop/plugins/publish/collect_image.py

diff --git a/openpype/hosts/photoshop/plugins/create/create_flatten_image.py b/openpype/hosts/photoshop/plugins/create/create_flatten_image.py
index 9d4189a1a3..e4229788bd 100644
--- a/openpype/hosts/photoshop/plugins/create/create_flatten_image.py
+++ b/openpype/hosts/photoshop/plugins/create/create_flatten_image.py
@@ -4,6 +4,7 @@ from openpype.lib import BoolDef
 import openpype.hosts.photoshop.api as api
 from openpype.hosts.photoshop.lib import PSAutoCreator
 from openpype.pipeline.create import get_subset_name
+from openpype.lib import prepare_template_data
 from openpype.client import get_asset_by_name
 
 
@@ -37,19 +38,14 @@ class AutoImageCreator(PSAutoCreator):
         asset_doc = get_asset_by_name(project_name, asset_name)
 
         if existing_instance is None:
-            subset_name = get_subset_name(
-                self.family, self.default_variant, task_name, asset_doc,
+            subset_name = self.get_subset_name(
+                self.default_variant, task_name, asset_doc,
                 project_name, host_name
             )
 
-            publishable_ids = [layer.id for layer in api.stub().get_layers()
-                               if layer.visible]
             data = {
                 "asset": asset_name,
                 "task": task_name,
-                # ids are "virtual" layers, won't get grouped as 'members' do
-                # same difference in color coded layers in WP
-                "ids": publishable_ids
             }
 
             if not self.active_on_create:
@@ -69,8 +65,8 @@ class AutoImageCreator(PSAutoCreator):
             existing_instance["asset"] != asset_name
             or existing_instance["task"] != task_name
         ):
-            subset_name = get_subset_name(
-                self.family, self.default_variant, task_name, asset_doc,
+            subset_name = self.get_subset_name(
+                self.default_variant, task_name, asset_doc,
                 project_name, host_name
             )
 
@@ -118,3 +114,29 @@ class AutoImageCreator(PSAutoCreator):
         Artist might disable this instance from publishing or from creating
         review for it though.
         """
+
+    def get_subset_name(
+            self,
+            variant,
+            task_name,
+            asset_doc,
+            project_name,
+            host_name=None,
+            instance=None
+    ):
+        dynamic_data = prepare_template_data({"layer": "{layer}"})
+        subset_name = get_subset_name(
+            self.family, variant, task_name, asset_doc,
+            project_name, host_name, dynamic_data=dynamic_data
+        )
+        return self._clean_subset_name(subset_name)
+
+    def _clean_subset_name(self, subset_name):
+        """Clean all variants leftover {layer} from subset name."""
+        dynamic_data = prepare_template_data({"layer": "{layer}"})
+        for value in dynamic_data.values():
+            if value in subset_name:
+                return (subset_name.replace(value, "")
+                        .replace("__", "_")
+                        .replace("..", "."))
+        return subset_name
diff --git a/openpype/hosts/photoshop/plugins/create/create_image.py b/openpype/hosts/photoshop/plugins/create/create_image.py
index 8d3ac9f459..af20d456e0 100644
--- a/openpype/hosts/photoshop/plugins/create/create_image.py
+++ b/openpype/hosts/photoshop/plugins/create/create_image.py
@@ -94,12 +94,17 @@ class ImageCreator(Creator):
                     name = self._clean_highlights(stub, directory)
                     layer_names_in_hierarchy.append(name)
 
-            data.update({"subset": subset_name})
-            data.update({"members": [str(group.id)]})
-            data.update({"layer_name": layer_name})
-            data.update({"long_name": "_".join(layer_names_in_hierarchy)})
+            data_update = {
+                "subset": subset_name,
+                "members": [str(group.id)],
+                "layer_name": layer_name,
+                "long_name": "_".join(layer_names_in_hierarchy)
+            }
+            data.update(data_update)
 
-            creator_attributes = {"mark_for_review": self.mark_for_review}
+            mark_for_review = (pre_create_data.get("mark_for_review") or
+                               self.mark_for_review)
+            creator_attributes = {"mark_for_review": mark_for_review}
             data.update({"creator_attributes": creator_attributes})
 
             if not self.active_on_create:
@@ -124,8 +129,6 @@ class ImageCreator(Creator):
 
             if creator_id == self.identifier:
                 instance_data = self._handle_legacy(instance_data)
-                layer = api.stub().get_layer(instance_data["members"][0])
-                instance_data["layer"] = layer
                 instance = CreatedInstance.from_existing(
                     instance_data, self
                 )
diff --git a/openpype/hosts/photoshop/plugins/publish/collect_auto_image_refresh.py b/openpype/hosts/photoshop/plugins/publish/collect_auto_image_refresh.py
new file mode 100644
index 0000000000..741fb0e9cd
--- /dev/null
+++ b/openpype/hosts/photoshop/plugins/publish/collect_auto_image_refresh.py
@@ -0,0 +1,24 @@
+import pyblish.api
+
+from openpype.hosts.photoshop import api as photoshop
+
+
+class CollectAutoImageRefresh(pyblish.api.ContextPlugin):
+    """Refreshes auto_image instance with currently visible layers..
+    """
+
+    label = "Collect Auto Image Refresh"
+    order = pyblish.api.CollectorOrder
+    hosts = ["photoshop"]
+    order = pyblish.api.CollectorOrder + 0.2
+
+    def process(self, context):
+        for instance in context:
+            creator_identifier = instance.data.get("creator_identifier")
+            if creator_identifier and creator_identifier == "auto_image":
+                self.log.debug("Auto image instance found, won't create new")
+                # refresh existing auto image instance with current visible
+                publishable_ids = [layer.id for layer in photoshop.stub().get_layers()  # noqa
+                                   if layer.visible]
+                instance.data["ids"] = publishable_ids
+                return
diff --git a/openpype/hosts/photoshop/plugins/publish/collect_image.py b/openpype/hosts/photoshop/plugins/publish/collect_image.py
new file mode 100644
index 0000000000..64727cef33
--- /dev/null
+++ b/openpype/hosts/photoshop/plugins/publish/collect_image.py
@@ -0,0 +1,20 @@
+import pyblish.api
+
+from openpype.hosts.photoshop import api
+
+
+class CollectImage(pyblish.api.InstancePlugin):
+    """Collect layer metadata into a instance.
+
+    Used later in validation
+    """
+    order = pyblish.api.CollectorOrder + 0.200
+    label = 'Collect Image'
+
+    hosts = ["photoshop"]
+    families = ["image"]
+
+    def process(self, instance):
+        if instance.data.get("members"):
+            layer = api.stub().get_layer(instance.data["members"][0])
+            instance.data["layer"] = layer
diff --git a/openpype/hosts/photoshop/plugins/publish/extract_image.py b/openpype/hosts/photoshop/plugins/publish/extract_image.py
index cdb28c742d..680f580cc0 100644
--- a/openpype/hosts/photoshop/plugins/publish/extract_image.py
+++ b/openpype/hosts/photoshop/plugins/publish/extract_image.py
@@ -45,9 +45,11 @@ class ExtractImage(pyblish.api.ContextPlugin):
                     # Perform extraction
                     files = {}
                     ids = set()
-                    layer = instance.data.get("layer")
-                    if layer:
-                        ids.add(layer.id)
+                    # real layers and groups
+                    members = instance.data("members")
+                    if members:
+                        ids.update(set([int(member) for member in members]))
+                    # virtual groups collected by color coding or auto_image
                     add_ids = instance.data.pop("ids", None)
                     if add_ids:
                         ids.update(set(add_ids))
diff --git a/openpype/hosts/photoshop/plugins/publish/extract_review.py b/openpype/hosts/photoshop/plugins/publish/extract_review.py
index 4aa7a05bd1..afddbdba31 100644
--- a/openpype/hosts/photoshop/plugins/publish/extract_review.py
+++ b/openpype/hosts/photoshop/plugins/publish/extract_review.py
@@ -1,4 +1,5 @@
 import os
+import shutil
 from PIL import Image
 
 from openpype.lib import (
@@ -55,6 +56,7 @@ class ExtractReview(publish.Extractor):
         }
 
         if instance.data["family"] != "review":
+            self.log.debug("Existing extracted file from image family used.")
             # enable creation of review, without this jpg review would clash
             # with jpg of the image family
             output_name = repre_name
@@ -62,8 +64,15 @@ class ExtractReview(publish.Extractor):
             repre_skeleton.update({"name": repre_name,
                                    "outputName": output_name})
 
-        if self.make_image_sequence and len(layers) > 1:
-            self.log.info("Extract layers to image sequence.")
+            img_file = self.output_seq_filename % 0
+            self._prepare_file_for_image_family(img_file, instance,
+                                                staging_dir)
+            repre_skeleton.update({
+                "files": img_file,
+            })
+            processed_img_names = [img_file]
+        elif self.make_image_sequence and len(layers) > 1:
+            self.log.debug("Extract layers to image sequence.")
             img_list = self._save_sequence_images(staging_dir, layers)
 
             repre_skeleton.update({
@@ -72,17 +81,17 @@ class ExtractReview(publish.Extractor):
                 "fps": fps,
                 "files": img_list,
             })
-            instance.data["representations"].append(repre_skeleton)
             processed_img_names = img_list
         else:
-            self.log.info("Extract layers to flatten image.")
-            img_list = self._save_flatten_image(staging_dir, layers)
+            self.log.debug("Extract layers to flatten image.")
+            img_file = self._save_flatten_image(staging_dir, layers)
 
             repre_skeleton.update({
-                "files": img_list,
+                "files": img_file,
             })
-            instance.data["representations"].append(repre_skeleton)
-            processed_img_names = [img_list]
+            processed_img_names = [img_file]
+
+        instance.data["representations"].append(repre_skeleton)
 
         ffmpeg_args = get_ffmpeg_tool_args("ffmpeg")
 
@@ -111,6 +120,35 @@ class ExtractReview(publish.Extractor):
 
         self.log.info(f"Extracted {instance} to {staging_dir}")
 
+    def _prepare_file_for_image_family(self, img_file, instance, staging_dir):
+        """Converts existing file for image family to .jpg
+
+        Image instance could have its own separate review (instance per layer
+        for example). This uses extracted file instead of extracting again.
+        Args:
+            img_file (str): name of output file (with 0000 value for ffmpeg
+                later)
+            instance:
+            staging_dir (str): temporary folder where extracted file is located
+        """
+        repre_file = instance.data["representations"][0]
+        source_file_path = os.path.join(repre_file["stagingDir"],
+                                        repre_file["files"])
+        if not os.path.exists(source_file_path):
+            raise RuntimeError(f"{source_file_path} doesn't exist for "
+                               "review to create from")
+        _, ext = os.path.splitext(repre_file["files"])
+        if ext != ".jpg":
+            im = Image.open(source_file_path)
+            # without this it produces messy low quality jpg
+            rgb_im = Image.new("RGBA", (im.width, im.height), "#ffffff")
+            rgb_im.alpha_composite(im)
+            rgb_im.convert("RGB").save(os.path.join(staging_dir, img_file))
+        else:
+            # handles already .jpg
+            shutil.copy(source_file_path,
+                        os.path.join(staging_dir, img_file))
+
     def _generate_mov(self, ffmpeg_path, instance, fps, no_of_frames,
                       source_files_pattern, staging_dir):
         """Generates .mov to upload to Ftrack.
@@ -218,6 +256,11 @@ class ExtractReview(publish.Extractor):
             (list) of PSItem
         """
         layers = []
+        # creating review for existing 'image' instance
+        if instance.data["family"] == "image" and instance.data.get("layer"):
+            layers.append(instance.data["layer"])
+            return layers
+
         for image_instance in instance.context:
             if image_instance.data["family"] != "image":
                 continue
diff --git a/website/docs/admin_hosts_photoshop.md b/website/docs/admin_hosts_photoshop.md
index de684f01d2..d79789760e 100644
--- a/website/docs/admin_hosts_photoshop.md
+++ b/website/docs/admin_hosts_photoshop.md
@@ -33,7 +33,6 @@ Provides list of [variants](artist_concepts.md#variant) that will be shown to an
 Provides simplified publishing process. It will create single `image` instance for artist automatically. This instance will
 produce flatten image from all visible layers in a workfile.
 
-- Subset template for flatten image - provide template for subset name for this instance (example `imageBeauty`)
 - Review - should be separate review created for this instance
 
 ### Create Review
@@ -111,11 +110,11 @@ Set Byte limit for review file. Applicable if gigantic `image` instances are pro
 
 #### Extract jpg Options
 
-Handles tags for produced `.jpg` representation. `Create review` and `Add review to Ftrack` are defaults. 
+Handles tags for produced `.jpg` representation. `Create review` and `Add review to Ftrack` are defaults.
 
 #### Extract mov Options
 
-Handles tags for produced `.mov` representation. `Create review` and `Add review to Ftrack` are defaults. 
+Handles tags for produced `.mov` representation. `Create review` and `Add review to Ftrack` are defaults.
 
 
 ### Workfile Builder
@@ -124,4 +123,4 @@ Allows to open prepared workfile for an artist when no workfile exists. Useful t
 
 Could be configured per `Task type`, eg. `composition` task type could use different `.psd` template file than `art` task.
 Workfile template must be accessible for all artists.
-(Currently not handled by [SiteSync](module_site_sync.md))
\ No newline at end of file
+(Currently not handled by [SiteSync](module_site_sync.md))
diff --git a/website/docs/assets/admin_hosts_photoshop_settings.png b/website/docs/assets/admin_hosts_photoshop_settings.png
index aaa6ecbed7b353733f8424abe3c2df0cb903935a..9478fbedf785ca8ae66132a14cb400c38e2dccc9 100644
GIT binary patch
literal 16718
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
PprI+ss>zf~fkXc<`wAQ%

literal 14364
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
HnJfPbma2Vl


From d58e518c39d5f032ca7fb2ccd7e42962abda1745 Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Mon, 11 Sep 2023 17:23:08 +0200
Subject: [PATCH 202/366] AfterEffects: added validator for missing files in
 FootageItems (#5590)

* OP-6345 - updated logic to return path and comp for FootageItem

Used later to check existance of file in published comps

* OP-6345 - added validator if footage files exist

Comp could contain multiple FootageItems, eg imported file(s). If file is missing render triggered by jsx fails silently.

* OP-6345 - updated extension

* OP-6345 - small updates after testing

* OP-6345 - fix - handle Solid Footage items

JSX failed silently on Solid item as it doesn't have any `.file`

* OP-6345 - enhance documentation

* OP-6345 - remove optionality

This plugin shouldn't be optional as when needed and skipped it result in really weird behavior.

* OP-6345 - updated documentation

Added missing plugins.

* OP-6345 - missed functionality for optionality

* OP-6345 - removed unneeded import
---
 openpype/hosts/aftereffects/api/extension.zxp | Bin 102930 -> 103005 bytes
 .../api/extension/CSXS/manifest.xml           |  24 ++++-----
 .../api/extension/jsx/hostscript.jsx          |  16 +++++-
 openpype/hosts/aftereffects/api/ws_stub.py    |   8 ++-
 .../publish/help/validate_footage_items.xml   |  14 +++++
 .../plugins/publish/validate_footage_items.py |  49 ++++++++++++++++++
 website/docs/admin_hosts_aftereffects.md      |   8 +++
 7 files changed, 104 insertions(+), 15 deletions(-)
 create mode 100644 openpype/hosts/aftereffects/plugins/publish/help/validate_footage_items.xml
 create mode 100644 openpype/hosts/aftereffects/plugins/publish/validate_footage_items.py

diff --git a/openpype/hosts/aftereffects/api/extension.zxp b/openpype/hosts/aftereffects/api/extension.zxp
index 358e9740d3c2479b88dff08af47eba3d74be63ce..933dc7dc6cab34b6a1630b25d11a2167fa0aef7a 100644
GIT binary patch
delta 10917
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
D9WP{T

delta 10814
zcmZv?1ymeS(=9rK6C}7paCdi?;1Jw`1REeoaBbY3z!2OaxVuZx1b4UK!JWWM^8N4L
z|9k7rth0J|S9MjLK3y}_U3;|vA+Z1<J`7fGGqEOe91N?!nV4h<^X2b;-5rc3`ahtG
zi3Rfym}5(!!L0_&XeX7CyHT0eCz$`yH=i=HGFMZCg~I`XKuDm!VngXNuq-SHw3{SN
z;ST)O`(y8)-gj+f=OuOw5jw8luS>^!0_!13(G*g!kW>z2SoyRsDz8g1bt_m}5=q_y
zzB<n!LM2K2>wucIU!AK>iE|$Kqx_PpnvAp_%a9gjM0K)ohV9EnXTW`y-<4JH6usm5
zorZlzXmA~&7LmwjiDFu7i<iU;03wYz-H08&fQ!64>@2xzzpji_Jejf=l)NnRywffu
z%)j8+Lcy^rk9h6u+NoK760A?RN5F=M;(p$P`zbaq{X3o?$wLx(0SAP=l6w>EDn8kx
zpE&-RHyl0}A5K`aHH3?`T?WCB`z;T-?{j~_2FI>UifyjTW@!1K_qufs;BD<^XP9s<
znKp(?DM4Pah*<zXMIl2ikK={MppW4gj2}_E6m3)}Pgx)vBTM?59!I}Kjr#hgocr^w
zx65z-ntneAUzc>b3a+O6zVNjkW17_HHAyuozVJLvh<ts#H#Ny!Qk#M#{};KzK?j8)
zZ_OHkbvgrwPa4B>+!vy{z@nQ)=`z0j2U(ic;)?w9ip=?NyAFAC_oA=I<CfeLrL?)p
zWy@WqZa6!nnaKust)))uU8mP&9VOT0NF<LULSKjPTV}#;-g)f0)6Gw4*2sxfJxzK%
zre<jqr5PF6ts3Y)P?BRBRVadtBEKFO;^5YSVfYL?IDRK_$`@~c25j+`Nr+SO`bXt=
z8M7*WqC1{$aAJS;d-f11!paMB?6%tam|sOdMJp~~$*98~22-kF@|NHYCaIg@*xhH=
zRkgu{FdfHDUSw)Tm(4px7AGVlZNmNDslF5`%)q8k_h<62vVy|#x&!8w8$3)Rf5Rz_
ze)d|BRml6!f9h9l)(pTNWF}0WY#w)TqcW%pHBDq-=8z9DD=zCWnw9Q4Bm0ZqxZ~Pb
zidkH$xo`Br?J)qx#9cKEC3b`c&#h)X@Mxu;wLK!{Pw>#|)gKyJ84Cx-(L*Tr*7Nn#
z_+9VeNuqXN)U4G9<~*viKWUu*tn>;JcWhWAt&{#4U7txz@j(}c4<5baeAv%<O!;o5
z?^^?}BXiz9-gCH?6dEJQmxjQeI>1?^0s*>j+avv4$>be#DxqfV2l)z(uhOJ5_^eag
z9zfPOsKjxsEyei8i6?37g5l+>+cP)`Ba|qKfX3lp(niu`{Yz0MS`Dm!Ab{WC{{>T+
zNi~N5a=cE+i19y1tsTZO;p*&WwUdMbJQ2Zv((`Z1w*^eX!Y$eUIT|10f@r&*_&33m
zP(tJX`N#^*_-9%qtdi~@_*L2b=`U#dN&)uA`-hnM!M5=KP?`u>81)}olm`>P`ezn;
zrvdi-XZP<}9-3g;SN}A6-h*f1;L`tu15Nt?cBP)%_~-fm^V9NIPO0;XHj@YhLUVv}
znS<RC|7!lR1+6g$;{z^<ZJA{abai{wD!krb7KnxF+>;d`^q7hJYSdvlcD9r+ZSKvt
zZFDWaz9E7!KA-Rlxw;CKCQ>Et%jQq+vvH?(Ans8rUZxrKCofpJHf&L8TQUV0`(~b@
zWF17c>s}ZdYx?}CQgFS#)`4W5wXa#daGH(YMe59oKK4o7m;k3oRX1c~b!J#r$L>@&
zc|%z5Cs#WF#Y;$|0{@ZB<XX$Z=v0J15G5>#-%-^iDejhPQEsSQ>oS6_`o3n7F?$Y@
zz*R%9tp~$BQ^sfo2#EOAN%{Kz)-p^{*E=Vy@(|sn#5#u;3pkQGucxn-IHei)gzwMz
z)H_35vv!cz444Dki#VZ!D#f^a9^QCXfv*?Al*(2?nSG^^^Zu<RQC>zDNQgeJ!o;<z
z#=yYF^m&E|q=c-x{->g)_!;b&)eH`iC`nE9-lZ3~>qv%?($jUKJ_{GuL_iH={p-&|
zFZX$wRi7zBaf)xZGiR{g7dsJoG&6>NIL^qul$)*hz*l{r%OOA1uBrs9?}h_MVwcQJ
z2vRZz8Rw;BS9l&t-%HJgV=Ha4=(->3%f0*XLItYgE~3EIj4^bC^B$VFT~QkXP1#`>
zPu)lS5l0JZHMbi9c@N+Z4#>$S7VSSG`2!^Co{v0w>qOHFNvJDQIZ~ILG159s6hjpI
zjsSHSfTzvrtrnTpAU0eidXic1%XS#Hfb7=GD*_=!=Pc9;fj011W<`dv7br-yJkJ-u
zR7`VPN_dhpEFa8~G#Y~7HX+;(?v?6)Z5{6lTW0Fgz^uA;Aou<?3jv4GnZ?sjoDCe*
zAEW6W!!m@b_ias82qK{4MRvkk0?=8H=y{tvkP{(IOG&E!&e7=|E)CN6hkZueYjJm;
zM5ItD2N7^4jfoK>5w|1CuN;~YBtoP9#mGlt4YY4L1|!W|#Sqc)ySRl<XU~1{C2kh1
zMk%<~^8r|2;}<gLWCl)|Tyi{qnss4X+*t?1s>32*Zi-4Zj1<YB9~I0g1K4wHbmi1G
zK%T*jtd~kC0`=Sc6#X8FWQzkfACrg_8pAs7?LnGxiPl4zxAkYaCa|+T@gM@w4Q9@1
zM0dI7lQ+16dL)RrknDghK3GqH1Oew4#Z&9Xc+|nG3<R@}y4OUjiqt<R(04^?tyAb7
zrwx;$u_ZyVn$jMlljI(Kc#ABsy+xQefY?gsRa|Ll2|@>7h#BLVzp@VQ9kFX8x&a#$
zpG{lO4aKh?Tiv`YjVl8~8^0C10=tty73oI`XscgI9bzl5AH{J`S7%LoR&$aeJzb8W
zZ|>0JlvvN!YZtZZl-Le4Zt2e@KuKp6{j3{4A0|&J&cv#SU_TpesIgOLM$!`rloUE-
zCmacE+7Ve1sxIupKuSFf`z8vS81eSQ{3Y>SQQwzHD{OP<Rxe8yOtD2fUs*UGzwF@}
zpPRPLH>N;s;a!F4J%~xy+zp6W_kWJZ0{n~Z{C>Zm_A4M?cYYj6|G@wB`KMj>xxnKL
zY+b|1;hN~<`Pp?F)d|)TZQ%hHP%iiS@o15=scA5A_EU?cx!pjxQPIXBtOk>xULnr{
zgIb0OGZE4!9i!nCY&h&^RM{%pr^z>Of{1_bZ#LcG1JMiHVg&iUJ;kr%=>#@0nk$3|
z2h_sQf7*-W_uui4&y~lG?dK0&TXgxx7i7S_3JIqZ8AVvD4va6LSC)K6R4O6O;NcLT
z1R*Hi7rl`o9dALZK&tR&&kOX+l>;-e&<5uuvoOH^{!E8}uDg_tS4~oMedK|*dPT94
zBhZg>Wf%TR7ir+5v;i-f5;^ph4VVa^IHlTaWQzuuf2uC)#@WIh4sAlEukU*#mpc`s
z*N6fezTzX3nE2L-f}9$A;O4Gjtmuxs`*;;p7^dFoe%6V`x|kLetG_7txO9?3iEmzR
z9@cN$F9<($gzf*EY&U!)S$AUEZLl)@cKvp-5=M}1%7;C8^f}B=yuFb7EixV8pA)1U
zL%uOKBdu0{kNx`@If)nxg-Kku%;3N<LRO{oRL1vaX3bBZhA3H|y)4`JHHSy|b%Gw3
zD!uB5%XJN13Jiq+xIN|^I~ClOJtk6fMpk;M03Iv45!#@a`UmBJoX;ZE49>x_=oqrD
za-?P(&)}<YrlzJs_8sBM$|+_brpz^IJu2i#C@;c1v?b=r9}^1UQIP-=f6yE0)s1?5
zzqw^@`65B0sYz;<`-DGt`li_r>Le`DTu^l}k}iX2h~9KM-o6zmh8sE1p*r931A>HY
zhW8Cmp+wmq$DQn#BFaOQ0kVXIwYtQVlMdDj1MEt+*FIn1k<wC1hBiJx<>v*-GboVX
z7r-jj$C#YA?~Y}pNnFf!X)HQ#f}O^xH_=K@HHKGYw9m8J&Z8bi8-8K3$?d(7XbrwM
z<-sp8R+rly*u}t?wo`5As5vHVX$>?}Q6yb2Ut)N&!!oEK*TV{wUR1L*$154zBd-9%
z1PZ3(T+<EY^v8KQ#$p0V$()HcXGvKZt@_I_d({L>lLY}`uPN#W{YYPn=cuWg-Yvf)
zVw}mL=Q*8^#wh)f`l~$bkYgn*Gdu0fGp%bhY0E;Zd_+R^hX4(-Qv6h=aGs$Qq0`u+
z;1R;z#;HbuBDJ(>;wp(^FMF5E2H&^6uq~xZZFllh+~f<V)1V|Edcyqrgx6QIx3l|0
zuzt(Ke4nX?sUaufO0L|^#5~R~H7Yc8*y@M~j2;Q%iw9Qec79P&As<f{HbI=&$Hc%s
zLNRY|pHH8ze4ZZ8#NyVn*3w1DIv*1~E^hAF<i>yel1b^sq#fw+B*l>H0p4%=S*YQ_
zen{xIE@^asbDYWv7`;!OOa(<a6Bx2CXDBJ<2wQf&_@<9kN8O+Geg739#aSvnmNxQa
z2;F-)lcIwXH$;@yG{_LmWY2JyMrqXI?T8gMYDb#KYTgk}*|LiW^ry4HBSuya$9hR0
z>K<nc4j*jdB+StYHKB-I<{@l1j3f<><8MY&Y}>_RQ4NCtQAqS=z^&n_<I_2)VO?<r
z$$c#Pq=O)sYPWm>?E`KVF;(wn0S85lPlyQa?&@QWpYkKicqFPv0BKAQQy|$UmY-3G
z6mSsS=WKD%Bd|{#-x<7yC26xEkv1=N01249%~J|d=JUGyp6@WbCM;7S?HYDVhIE%*
zX)H3|R~G}6ya`G$E}<L6a4J^XSq%Ju0fVl)xf9E#fl;-_dRfwZQw$exasD}dA%eF5
zlCrNxv`3=axF5MSl74=Mfyl45HwU6cJ0(*8ZgJIlS5<3kmr<@>*Gzy*$o-s_N1g9J
zF^l+UqGSF<mBF4HefFbaX=aY9E70JSWWvbmfUN|~_wZD}B|4QxC&RtMD~&f~8h#)i
z3I=~kZY3LRatdHhiDTFhZ&b>U7!aJ<#^<EC(Nw6vt;SonT6@32UFK!sJ>9IV{-{Xy
zWvkKyV~RzQG#jbxwlnZ3iFK~}_qg7MzxY{mAcOpg67h#n>Xunoxm|A*!X_D++v~E@
zH8>w2Yw1hahUkT}4Z@Pk>RHDC<OX3zVn97k-Lk$LtyF(1B#p#x!?O6eHbAoArk>VM
zrU$y^JOCY#se9!|iZJdOgG{M4n()cg?jmK!HElf7hQWPgOTMNwv$88U!?+{dwqp{4
zG30BURp0am$7XPsfSO&M;w!qqt$|@A>AD2)^sap6=ZfB{fM|a5hD{rEu1*i0Pvxk&
z)HRA4H)ng^<x~dOhBd2-F%1_suX2{mN4jDyuxS!zAf1SD;gD1LFvMO0|7IFqbq_`A
zYkMoYV3R2XHp%K+nO~HZNy~MJobm>hyjkrLI-OqiXx>Bk7GV;q;vnvhP66`1TB{eJ
zu5*4x)%Ny7DU)E&r^uH}N`kYdhiRFN@fPZOZq(Cd*_1@>&{K^0r3^mk(Bn<z+qdLS
z#NTs-kR+@<eYURZ=Us3DIbZXn&YvxjV#>q3I~@sp-Z)lI+Gfs;mmIy6kZa@H$PhI(
zNcaDp+bTT$Ogt^aH0Up$$QcFlr1F0ch{jW|OuWUO^!J%|!J*Di{SGJ7dRn1=Tr)_8
zNVQ^3hezC~*N3j0)o-3O+bgr|V=m()MX2Odw3t|xQrj<i!dXoCw6KaMI8$rqqzu8v
z-Rv76zy58ys?Ek~^bN@b4l}v6vIe+&I=~bv+cM1Q_)uT{Al20qAvxo)mvj~cP#)Zd
zz&^Tn;(ZQAfz}w<2|(=x<QiQ}1^u<VbDT{kJQ0JAdw?BV#!_U{nQ??Yin#+-6jbVn
zZgkrmD@ReAhXt*`xe(U)?siMfjv0<u-VcIdraHXqX?FopZp6D}v-7c{t*$u%a=d{J
z3B_mPF3A%5rj5hsSb4DJyh1{NpC5CONi{W8D`8v?$4G-UaZo-yRBBT1{b+CfMkv(4
zbXi%4eCYLDY$wgj8E)!Nf8vLn%`-(M4?<Xb9c)?Ue5+QM#N;w&?5TB!R}M8Q35`+w
zWJ4G`qiKw6vPXDkFdI3;!o>nYdh;k9PL^`^(U9epFRAJ*h55EUUzfsx+w6Gm$m$z!
z9Ub*A<K9$X^={vY&JYp$y)WB24f3X5)K5k?dbG(xnHs!`B->{_x?Z$kcHEAsWfo%R
z*PFvHM<oq69k24At(;jHk(1W`EU#^&1ugR`ABWSurm%k%%3Gs`^(~l2FIi6z-V8y?
zH&_8PEbuLAQh=!V6Ryl4&~tUQN~j|C5T)=*8jMq*SiW99tlUSB=uoSerHzbz<kRXu
zkn&7vl%a|AnvP7NH}O^`Ar(taONZDB%8?p`j9561t4`HjsR+@EfxkJ*ktWXVe^Uon
z7~Rfq&@XAOJza6FkN0{aLrq<yEJJoYbiiybhPE)gqX8-p&-NV$_!=L6B5b<$sYxv0
z6^UGEYjx1fEK`61uft2^2f@Ol{rmIud^JAOS}CI0#0*TlYBMwS`}tD*eG*IuIa^8}
znsSc;`i_X%8TJ6ZR=C{h4g**2CNsHsu8D*z9nMlQ6^{An(nmUxX|aI#Z7l6=y>FK|
zA)i)r*rT|WziE700BR_YUfLX6Dvl>lx85%IGnIZMDmZ+|eXDJ9L)P$HYHOusXXW0V
zm6`o$0fw$9Gb}VGPBL0Yt4NFfWP#^k!T)g!qNV46caze}Mf_ZBWvA<~K2c9&&!-nM
z*MCnKidQhqUoXC!gs#Koh`=4se(PsH9KKF6xV$#}mMM{P59rXwsk-GPmVe9=Y5h1Q
z4xwRZ80}p^Inymr9I)PvZ|C97uw&If&rC70PlB<z+FZpVD8)E&!`ZmUq1y#7O&~<;
zQw#3Kb#gnf1oulRlu@&+X)Q+O<z3<!BxV(V_S);sMGwQILMP;EociK&Co!=J?{-Hu
zP(6g}r}a+D9;joxRVg9jbj<^yfidSL7nkUp3;XW7odu9nZcqwT!}MWOS>&)qdGFyH
zoeX#-kN8Q~-F4weC(AyX*d5{hIz+dSDqE7Q5z&2@w=B0ohuPG|XewP(TBKj6fZ;h>
z8BvY%kzh1MibWZ*DT-sc_29H#d4r9}b>>(NLudSzH?SCeRW$n+0p^3y@}gico>dNP
zQbQ>R_`E5ScCq_-y(Ch>u?4j`V|$6TH>av(f88gMx!L@%872n9P~h1z!)OgMFUOs4
z32Wpa^bS6p18<CY9eoU>@G3l~gG8$%@h57o)cgx2i*|3bS-?}>?75}$(ZB&+{%N&$
zp?a|5F5o&BqZ0c?!H}vZ0PR@l<9_X2?60b73`y61)$M~p&ye;eCKps*EuCma$><|9
z=72_AJXKUliZZYBJ6&udlb9L<*Gar<9WJUhZefKP!vbWe!Tb;F+yFs<FR)TZkVkh1
zQzlt@UJr5dxYxfl82&P$ET6Hi9;-ob7y$)s6Zpv`+p}wpaKe1y6S9|P$)A`T)??W!
zdf9^YP;DbO$>Y;;pdOLx>&!jK5RX~AmPWJ`20no8jU7>l^s}8gIkb_X?kMRN^5D-=
zfW^wDF;+QKk{mp2;-tQ~3UrlHMPk><Dn7^S!be>-<w6nTGRj;i)jeKl?W`%Ex^xzT
z0uIZPH$Ng_%(NTi*v49lF{cMtt)X3oTkc+b5ZV|9oR|^p$C6#xtZ<Zt(ic>@Ty8MB
zc{eG0^!gk-M&}*k7OaANo_m~ur*a#*KBna`)okJ+kFfRGk|d`0+1M=U&o^QoW?4wx
zU;?UuvLg}u4#1?1)G=YIE9JqWj$mH}P-@29D5Y5C%SU?yJKIK`H5XuG>>RQp=1n*X
zGRlixxh@eS9c>oiS>sjT(RPSx_!>|TQ|kKV{rRz)3Hdbm(z>4vApTvZ;LNhc_yrHy
z3OReAtQ@_dera2CIK5K+!D1>F<~XfZo9=LEvYKTi^KP{$Q`D)zck8V;!s_51AURkl
ziA(W7RVE)z9;{D48emmaE&=?g`5O7*<PhK4eGN+xv;G_$SEN0l%Xw3TRh2US&AA;H
z1+@`Z=gjxxR0rfRV#ok<I`V>FcV+Tcq@`0}nZOFt@%-I;Qsc&=9jc~~yIYvkc{k)a
zY>tVJDwT^|#QSTbab>?Y9%8o$Se2pH>p50HoXzsnwQf?9P_zNrn3W1XRVP8>kNUiW
z+_N9_YHU2i0(gInDcx}+Olmq*Zy%Dnp|0zt%;)T}@&CF<$%Ka#`f$@7vQ!~X+>^Cc
zq@OJ=PrK-z({elQcXKM^sTPx5_4cnJp%g{B4EZ(Hty8#-$j3)e0<}v(d4qxb7@_v+
z);kB~x%F`<mw=CJsjr>=N^i0Az7~pj5aJI5nmfiJa;obH9>k@90cN;vKs5sLiDySX
zvQdINLRxda;@O094VF^uYxtYToiO_qPM7Ww%p>Zgw;x$FVwerL<331yci2n$=#sr{
zXPe?GxbmsJ$*uK#`cwNdVD56i21mvaM!pZMXP~3iX?wfoo;x_7JblYPSn+gupjgoL
z;@*b&&h<==#y1fgRp*m-eNpxh?tY5}s~^a@B=LFz0F!w+=}NAB-i)uBo7c5>GVeY1
zW1NRG-kakWKQoEq>kG7^TM4A$B0o{qCHh25M}buqVLrXFIkYkcn5lQYi!4XvJn68R
z*nl`+v6@Y>CU|wf$4iwo>`qH#8#7=_^|>WVA+-kLutFfe3Kr96J*bY7jd`kL8}(I<
zwt2$OD|%9*7*DDN`Kf$YhgZ_Wi&T1#ttEA+c)=0p@;buPqN8G=_<<#c`DHA{yCMFt
z6N1O9j!eg)y1xwp?{ZDikdWM<xViJpq8f_~{R7waBG<2&nS2iQaG~t=Cd;SPtwCGj
z6~Xg3`d;a|rn{zHhXXp4%cKky>h(E%d(*D7&<@04%#3%$1fC3ZYILn*=@cZs7A-XS
z+PGnlhvC1oybvW%m#i6x+kSVV`!3rzxjvT24>ZI|m%$YQO~YFxc`khEb_^bk8yGZG
z@>E}J2hgO#e@6*uZ<?OuR<2%I{tR`$+1Lbgo{jQ<SA~SlK_dEx+a?^XHh5y*Iq4Vc
z@p4<^)!cC?H`k3a2URRpde^Hhw2kJCO?gekRbRBz_c@SgrGjKcjB-RlrkQVyl7rUB
zRrr!DTD}+p_C=7+FWPaN-YxP)v$Vr|>C~Bai5E6~iZz?Fc70W)XhVaR37Y9H`rYoe
z@>X@<J%`VQ!o)7W*J7m8kPqM6X@JxO^z0Sxj8tsz-hUi{^DEYP>P6d!kB3q&e)eyV
zv^wip(Y!?VyDu6syX)=RwWIoZAPedhl;^t^UYijI<YQKisn35(&ZL(CSsyFsy3Qy%
zM@8X-M%=Rea}m5x5mlG^OXph~V%^Qqwe3-&8?>(7WHnC?_~n^SP={tJU@g0NS|AmE
zEvGRZK<0|C&CXS4f{KC&L`%ifpxw<LeY@y~V5>LY`$Kj<H8HDs)6l#+amenR<spHs
z$9zA~u}L{@QJu3UywzCn#aOh}lM`mwUzBXwJSQyzE4Jkl?1u3L%3GH!aJu@E{qk`7
z9De;Mr7)ROpRfv}MM*$=FwNgL^@A~MPV-%K)zh<v2NJ(d+_%7ap2Hs;3z2Pc40%md
za|G|Bz;g#jQTQ%q+=3$BkB8q!&krUS7dNMYdAagTY;paaS6m!R%C_Tp{iMX&T|(q8
z@%<3G=>e8=h<r#Ef{>si#xQ(bh?Tc5E=JQ7OwYV}=={VFD;zdr$h9%#tLzL>hAVRx
zI%Za-!q{Qt9=Q;_Qhrf~BF<;thV;!B$4yg?Q*KAC8o`H`ud5+G7pO0X_>;n7WL*M)
zC~-E~vj?}|&0ZfLTb#<td*FRQE^623c4hz$k+f1thp+wDZ%JN<5BV<#8;Bflm<LvV
z8;hRFmU(7S(>1@t|L*-+?w6?+D*izDL0v*hzLZQtnB178_%Gz<zz5P?0>y?VMj!tJ
znAEqYc1jG!QP*p@&9V@S+3X|yL;_|-K(IvzZy&Ds>L<dThGDHR{P^G^a}PUe9O;;L
z_q5xl+^vCxy<p*ChYah6bt1O69Qum`M5iu@95u)|#4!-1%0$?M{d|9w;EYY3Ty}fd
zy-Cc@#i*D-m?5P$+y1E4?@bEgb&ylqH+fDJ0!aJo^u~!h!XLu}uql4b6fz^+fT=7)
zqqG@@Z%`~6xRfWT_0@TBrs|;c!Ml+n`sSemZdOI;u%4q%ELb3yx$)2Qr@n-Ci5v5|
zOU<zT_|f)M5D(^ig!-VKR@?VcE^M_dk{>FK=Hnz#s5$XCDG=S?mP@&MOqE;V8loen
zh*02VxEG)~SM{lY1<^ZmljmLC0f!ueb{GW#yEtf4ADdKAOUOs8<l0FAAA5pGLg2f}
zm(=i!haeFek=V&nX@_Vk4>DvA#=;)*QyO44y0`#_@!Pw713?rHvMMevzzkl}{L_ws
z(f~zV7*+;sIaV~<JZ*evN8yu*$9`z0uXD@xr=>6HzqU`mPAtDCGu?3fYQ=0Ctn4bn
zLNt(vQ`bh7u0Y~IkK<;aTYXt8xhkc(hChn>uzf>hX^6Hsc|Z}m0O!Yt+sTQCIZ~pj
zB8L-oews>tz}NMG_8n7mid*mFTLv15i310MD?iZRhWV>M4Ra7^`)}8)4FG$Q{pn-<
zYp8RGMg6aa`d|56CEYKmhCetE_}g&*JO1j<rs_H5k6;b1v)l_sbH-`+9)^^CNk|(Y
zuwzf>_!(2EH`YnGoc$cXL!A^ITN%3-`{ox)9&zjAEn8`6+udBh>92YtwDdRIlYGA`
zu6HvEJuiP#*eqX&Ax+)>)=(A3bq(L3kEEmzL1nw^+o*bN4EOQ~1Z{alVE5jhzjmmT
zFdhopY8l}7Oc=~c`leGH6J;3qQS;7NoCwc#MRrk)#nO8G$Ta*LM_gZE9GUFTxN#Bs
z0OdFFszWc9oyMC--#qOo5xp}Ng23gbzk1ld6$Zapw(smXfzod_M^&&p#e9A*qbemd
zu{)&WGZ8c-@kyv#0pE+~UYJSlg*k}BV28T6VM23u>cS<C=Ox5MGdq6V3q~9ikUpvN
zrv3Z~s-p8iPeRR3o;P9eN*33E=FGjbWn#xmgmUNly@dLZ+@s#wk3#3HR6SnI*{WXh
zU)qH|?{eox*JvIXvb+V)2x50yM1JA?l+R#${gD;-U?;dH4>0Fol*tQIUYUIiLYGVw
z)Yy_Xj*%PEw-;V);P&h+jJ^9RY&jdDIFsMjndVuqKvKy+;#u92h9PO&lRh6gQ7zCI
zpV`T`;UVqTVI683`aagMNL9(i6h2Yoa7I^sZ`AX{Sd4BSe!9TA51{p+(Uapg(H08j
zJD9^M)Gc;h1AY<eHaW3N%b);ndrg*@`us&q2$F~2F|Oh@Hs_*|Pn*7zkss3#QGjjG
zgGoV1T)K+(GEvsrZFz4#n7^8^{FZzZ+_+7^F5Dl?Wd#aBw@5+=>37t0I4u^b-`AXK
z&N?xctz!<yiQ{WKA2KNH_y}q~o{VyVPc`?jT2w<`1adNSPZ{g{KkFWJsBU$CX@NO+
z4GH2P3y_`@i$`Y0SPW21>fTCbI))F*(cmjCChL0art3J1kvk2BdGi*uOW3jH+C!t8
zOk95oBKIV$MkOt?71aC^%;`B>a9dROT7G%z^Z8rFM&)VJd-QxhrZx;+X(SktfeE_-
z7Pyd-DPW-*2Hvz}RC2<Ius>S*xYy^qYIsq3{JC|Hy~+`NHl8kl5&kE0HN0P0j5TH%
zz3;QMHJkz;-eyxLdZRY3wiNPB3rlPGFtF+7I}TFW%d-8fV3Kicz%c(@c*3tpUs~|c
zL(P~2Xnnh48?o*-xwH5>v^{Cr)Nr6AWlp`e=mS{8Gvg}Bvz7@;vGlRnIN_xxcQhNS
z+I_&zXL|RcwLGmdX={j_mmqF}$*taX!7@EZtqHX|9_hNn{-eh5SN^xv(c_|T3eWX<
zURikJhSV(zrF;w~rHl`>jg{j<6M!_j+T1MpAjal}s@^5zoO+xPe1^uXQc7NuY;-+b
z7_0;7Ra9@xOpeHM=S9~$3djGv{?z#O^d-Ug!WPe}n)KaeUz}L{FHssH{7i?-*o)}T
z#vdLpa2iKH5>aDQ$>_w)4@(MdpWyLEHr&xH`YO40U5MUKob(D!)FRsU7M?uYk#;m+
zmf_hq{x(-djE9CSSP&gdm0JGLY9qGpD3VwKC{;|2iu(9`h?W2{U#Bk@CA{h~^Arp*
zkRc6;vAQoKFoElDij?-xwgj;=M&j+I9hMYdr9Y~vGAEM0*EMuakk|cY<vhNco(!a&
za$v<xmYB2YA1_m=uDxBwE7ajX$$y=0-V9u23VM!gJ&6kTs_7fDD%YMmuE_g*I6ZO&
zer_63zY5FrT022cSD`2}r~bsZZ{ngTSKIaB9s;_%+$h|^JtC09m@zgc7V6h4Q}eHK
zX>(SwiKJA-DVPyq+u20hsL|O$yYR6<tQ+l9ACb=<c|ylDXfAtS-sFrs*)zgpd17+q
zPup%IOZRrUJS0PqabEf3Miap^SC@7H0C5Vu_Qh!yA14uxKU-N9*g{SRnN^bhmiJ+q
zj``$<ySj)@wqY@90CO7@*zB}|^YD^=b$gY0ZQdF4x|n`J&aT3td}1ihMJP@x#YjA=
ztdJLlvZt-z^}^uz_L?}7UUS+~YLkSFmW#THIMwrH(HZM&5@eZIyOK518k+bWV7Y2}
zJ+7+m9cM^o6Qe-;ozrmJ$74;$kzV9tth}ej6@@wCwPJCgB9$>~J8^g%TH-hRAof;v
z634^t^FIxLbcQTR1FB1q!;NEFr5Q~HZ-YpF8YL`l^*bP4U!JextWf(2;djlUiLYmW
z_5|INMS5!(T;JN|z{p`=q&9msK<)b2j<tX7y4Qr2or9U*%RWcXXz$>3=Z>uG^u}&#
z+|9HYE6~C0!qseHxF;XqiiW&&Vp;IU4U<}8d|c+ny?UBbX%o4~z3u@o0xBSZjci3Z
ztEoQryO&*&g^{(RE^CytMd(4GqcAk{mhbGbh_$25@r?<YHx~?@;#^h=kb!KjtT&%i
zp{hfS!=W6eD9M{tv9MCx;P<l=`aKCXzNA@7o{q5qP1KmJVU;5o|2nbqpb+DSORb2!
z-@A#X&!n*4KUX3=`jis5Q%OGDt4)BHndDKGidP2e2yqTlxRw_wMNbUAx6)+3?*9nK
z#g7v#g{-?CLNZlKW-Wz;2}nV_FU*0+43@AIV!3aoJQ?3FY#169)5q*l#<{R?m6ttS
z4I5$a?#Gi(*&yS!$%{ldo&uS=tU9!{vEG=p=}?vRfV|0GH1)n|K;((iVfRK+;<@hC
z%l-Ia;q_+Rnel%Y2FTCtq6~kEguep`WD9~0goCY6{{H#@&uHR{0Jnqxk@BFokzjVx
zzic}-MKBB*=>Lb02bGQjbHV;mfqF%OnPAXppv6&ODR36_C<?3%d%*`v<R^u`j{y@y
zb7H}8Q2%H!5m*zN9u3w6*Fw*t!S7&K?LkRL_JseG{_%&PzA<1T1>pb?2x4z;;lXO{
z^3hI18V*$OCt@v4c+fv?(SHK^PrdV(Ui3%ye?G7v%>Tg{f3^wG%@{B?>>ujU-w;U&
zkp4^hCKLp+ab~lFm_aL|z*JDxSTGT6Z73+IJCqO_@}~*~zlV0kg7v^OP{KH{GHebX
z7+T2(Ci*LT1I>&3GaX!LM;urMtOiAm2Xnvq8%&o*B3vah2ox<00=@blcVH0tpJ48x
z#_@j~{0+t@9?S$5gqFmEIsd~`TKglBPX7S@6ORYme@*x=CFy^!z<<-0Kp?FD^1%od
zP5@J~{oj-RZ&mm|m*w9E`M<7%88jvVOi1we9{As${!gjcnE=Lvy#c_`_x@m_H~(uf
z{+5padolhMpBRZ?A}+&lFz6%XqlJs7qs4zs=RZ#15&nij`se!-2?WB60RP$he*jVJ
BS&;w$

diff --git a/openpype/hosts/aftereffects/api/extension/CSXS/manifest.xml b/openpype/hosts/aftereffects/api/extension/CSXS/manifest.xml
index 0057758320..7329a9e723 100644
--- a/openpype/hosts/aftereffects/api/extension/CSXS/manifest.xml
+++ b/openpype/hosts/aftereffects/api/extension/CSXS/manifest.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<ExtensionManifest Version="8.0" ExtensionBundleId="com.openpype.AE.panel" ExtensionBundleVersion="1.0.26"
+<ExtensionManifest Version="8.0" ExtensionBundleId="com.openpype.AE.panel" ExtensionBundleVersion="1.0.27"
 		ExtensionBundleName="com.openpype.AE.panel" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
 	<ExtensionList>
 		<Extension Id="com.openpype.AE.panel" Version="1.0" />
@@ -10,22 +10,22 @@
             <!-- Photoshop -->
             <!--<Host Name="PHXS" Version="[14.0,19.0]" /> -->
             <!-- <Host Name="PHSP" Version="[14.0,19.0]" /> -->
-            
+
             <!-- Illustrator -->
             <!-- <Host Name="ILST" Version="[18.0,22.0]" /> -->
-            
+
             <!-- InDesign -->
-            <!-- <Host Name="IDSN" Version="[10.0,13.0]" /> -->          
-            
+            <!-- <Host Name="IDSN" Version="[10.0,13.0]" /> -->
+
             <!-- Premiere -->
             <!-- <Host Name="PPRO" Version="[8.0,12.0]" /> -->
-            
+
             <!-- AfterEffects -->
             <Host Name="AEFT" Version="[13.0,99.0]" />
-            
-            <!-- PRELUDE -->            
+
+            <!-- PRELUDE -->
             <!-- <Host Name="PRLD" Version="[3.0,7.0]" />   -->
-            
+
             <!-- FLASH Pro -->
             <!-- <Host Name="FLPR" Version="[14.0,18.0]" /> -->
 
@@ -63,7 +63,7 @@
                             <Height>550</Height>
                             <Width>400</Width>
                         </MaxSize>-->
-                        
+
 					</Geometry>
 					<Icons>
 						<Icon Type="Normal">./icons/iconNormal.png</Icon>
@@ -71,9 +71,9 @@
 						<Icon Type="Disabled">./icons/iconDisabled.png</Icon>
 						<Icon Type="DarkNormal">./icons/iconDarkNormal.png</Icon>
 						<Icon Type="DarkRollOver">./icons/iconDarkRollover.png</Icon>
-					</Icons>					
+					</Icons>
 				</UI>
 			</DispatchInfo>
 		</Extension>
 	</DispatchInfoList>
-</ExtensionManifest>
\ No newline at end of file
+</ExtensionManifest>
diff --git a/openpype/hosts/aftereffects/api/extension/jsx/hostscript.jsx b/openpype/hosts/aftereffects/api/extension/jsx/hostscript.jsx
index bc443930df..c00844e637 100644
--- a/openpype/hosts/aftereffects/api/extension/jsx/hostscript.jsx
+++ b/openpype/hosts/aftereffects/api/extension/jsx/hostscript.jsx
@@ -215,6 +215,8 @@ function _getItem(item, comps, folders, footages){
      * Refactor
      */
     var item_type = '';
+    var path = '';
+    var containing_comps = [];
     if (item instanceof FolderItem){
         item_type = 'folder';
         if (!folders){
@@ -222,10 +224,18 @@ function _getItem(item, comps, folders, footages){
         }
     }
     if (item instanceof FootageItem){
-        item_type = 'footage';
         if (!footages){
             return "{}";
         }
+        item_type = 'footage';
+        if (item.file){
+            path = item.file.fsName;
+        }
+        if (item.usedIn){
+            for (j = 0; j < item.usedIn.length; ++j){
+                containing_comps.push(item.usedIn[j].id);
+            }
+        }
     }
     if (item instanceof CompItem){
         item_type = 'comp';
@@ -236,7 +246,9 @@ function _getItem(item, comps, folders, footages){
 
     var item = {"name": item.name,
                 "id": item.id,
-                "type": item_type};
+                "type": item_type,
+                "path": path,
+                "containing_comps": containing_comps};
     return JSON.stringify(item);
 }
 
diff --git a/openpype/hosts/aftereffects/api/ws_stub.py b/openpype/hosts/aftereffects/api/ws_stub.py
index f5b96fa63a..18f530e272 100644
--- a/openpype/hosts/aftereffects/api/ws_stub.py
+++ b/openpype/hosts/aftereffects/api/ws_stub.py
@@ -37,6 +37,9 @@ class AEItem(object):
     height = attr.ib(default=None)
     is_placeholder = attr.ib(default=False)
     uuid = attr.ib(default=False)
+    path = attr.ib(default=False)  # path to FootageItem to validate
+    # list of composition Footage is in
+    containing_comps = attr.ib(factory=list)
 
 
 class AfterEffectsServerStub():
@@ -704,7 +707,10 @@ class AfterEffectsServerStub():
                           d.get("instance_id"),
                           d.get("width"),
                           d.get("height"),
-                          d.get("is_placeholder"))
+                          d.get("is_placeholder"),
+                          d.get("uuid"),
+                          d.get("path"),
+                          d.get("containing_comps"),)
 
             ret.append(item)
         return ret
diff --git a/openpype/hosts/aftereffects/plugins/publish/help/validate_footage_items.xml b/openpype/hosts/aftereffects/plugins/publish/help/validate_footage_items.xml
new file mode 100644
index 0000000000..01c8966015
--- /dev/null
+++ b/openpype/hosts/aftereffects/plugins/publish/help/validate_footage_items.xml
@@ -0,0 +1,14 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<root>
+<error id="main">
+<title>Footage item missing</title>
+<description>
+## Footage item missing
+
+ FootageItem `{name}` contains missing `{path}`. Render will not produce any frames and AE will stop react to any integration
+### How to repair?
+
+Remove `{name}` or provide missing file.
+</description>
+</error>
+</root>
diff --git a/openpype/hosts/aftereffects/plugins/publish/validate_footage_items.py b/openpype/hosts/aftereffects/plugins/publish/validate_footage_items.py
new file mode 100644
index 0000000000..40a08a2c3f
--- /dev/null
+++ b/openpype/hosts/aftereffects/plugins/publish/validate_footage_items.py
@@ -0,0 +1,49 @@
+# -*- coding: utf-8 -*-
+"""Validate presence of footage items in composition
+Requires:
+"""
+import os
+
+import pyblish.api
+
+from openpype.pipeline import (
+    PublishXmlValidationError
+)
+from openpype.hosts.aftereffects.api import get_stub
+
+
+class ValidateFootageItems(pyblish.api.InstancePlugin):
+    """
+        Validates if FootageItems contained in composition exist.
+
+    AE fails silently and doesn't render anything if footage item file is
+    missing. This will result in nonresponsiveness of AE UI as it expects
+    reaction from user, but it will not provide dialog.
+    This validator tries to check existence of the files.
+    It will not protect from missing frame in multiframes though
+    (as AE api doesn't provide this information and it cannot be told how many
+    frames should be there easily). Missing frame is replaced by placeholder.
+    """
+
+    order = pyblish.api.ValidatorOrder
+    label = "Validate Footage Items"
+    families = ["render.farm", "render.local", "render"]
+    hosts = ["aftereffects"]
+    optional = True
+
+    def process(self, instance):
+        """Plugin entry point."""
+
+        comp_id = instance.data["comp_id"]
+        for footage_item in get_stub().get_items(comps=False, folders=False,
+                                                 footages=True):
+            self.log.info(footage_item)
+            if comp_id not in footage_item.containing_comps:
+                continue
+
+            path = footage_item.path
+            if path and not os.path.exists(path):
+                msg = f"File {path} not found."
+                formatting = {"name": footage_item.name, "path": path}
+                raise PublishXmlValidationError(self, msg,
+                                                formatting_data=formatting)
diff --git a/website/docs/admin_hosts_aftereffects.md b/website/docs/admin_hosts_aftereffects.md
index 974428fe06..72fdb32faf 100644
--- a/website/docs/admin_hosts_aftereffects.md
+++ b/website/docs/admin_hosts_aftereffects.md
@@ -18,6 +18,10 @@ Location: Settings > Project > AfterEffects
 
 ## Publish plugins
 
+### Collect Review
+
+Enable/disable creation of auto instance of review.
+
 ### Validate Scene Settings
 
 #### Skip Resolution Check for Tasks
@@ -28,6 +32,10 @@ Set regex pattern(s) to look for in a Task name to skip resolution check against
 
 Set regex pattern(s) to look for in a Task name to skip `frameStart`, `frameEnd` check against values from DB.
 
+### ValidateContainers
+
+By default this validator will look loaded items with lower version than latest. This validator is context wide so it must be disabled in Context button.
+
 ### AfterEffects Submit to Deadline
 
 * `Use Published scene` - Set to True (green) when Deadline should take published scene as a source instead of uploaded local one.

From 01282f3af797d2c3f879bd91de692965eb25ebdb Mon Sep 17 00:00:00 2001
From: Simone Barbieri <simone.barbieri@hey.com>
Date: Tue, 12 Sep 2023 11:47:48 +0100
Subject: [PATCH 203/366] Fix AOVs publish with multilayer EXR

---
 openpype/hosts/blender/plugins/create/create_render.py | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/openpype/hosts/blender/plugins/create/create_render.py b/openpype/hosts/blender/plugins/create/create_render.py
index fa3cae6cc8..84387ffb16 100644
--- a/openpype/hosts/blender/plugins/create/create_render.py
+++ b/openpype/hosts/blender/plugins/create/create_render.py
@@ -177,10 +177,15 @@ class CreateRenderlayer(plugin.Creator):
         # Create a new output node
         output = tree.nodes.new("CompositorNodeOutputFile")
 
+        aov_file_products = []
+
         if ext == "exr" and multilayer:
             output.layer_slots.clear()
             filepath = f"{name}{aov_sep}AOVs.####"
             output.base_path = os.path.join(output_path, filepath)
+
+            aov_file_products.append(
+                ("AOVs", os.path.join(output_path, filepath)))
         else:
             output.file_slots.clear()
             output.base_path = output_path
@@ -188,8 +193,6 @@ class CreateRenderlayer(plugin.Creator):
         image_settings = bpy.context.scene.render.image_settings
         output.format.file_format = image_settings.file_format
 
-        aov_file_products = []
-
         # For each active render pass, we add a new socket to the output node
         # and link it
         for render_pass in passes:

From d949041ad9013e4aa4d02fb0f8e4cd6e540019ed Mon Sep 17 00:00:00 2001
From: Simone Barbieri <simone.barbieri@hey.com>
Date: Tue, 12 Sep 2023 15:10:04 +0100
Subject: [PATCH 204/366] Change behaviour for multilayer exr

---
 .../blender/plugins/create/create_render.py   | 35 ++++++++-----------
 1 file changed, 15 insertions(+), 20 deletions(-)

diff --git a/openpype/hosts/blender/plugins/create/create_render.py b/openpype/hosts/blender/plugins/create/create_render.py
index 84387ffb16..1c7f883836 100644
--- a/openpype/hosts/blender/plugins/create/create_render.py
+++ b/openpype/hosts/blender/plugins/create/create_render.py
@@ -177,34 +177,29 @@ class CreateRenderlayer(plugin.Creator):
         # Create a new output node
         output = tree.nodes.new("CompositorNodeOutputFile")
 
-        aov_file_products = []
-
-        if ext == "exr" and multilayer:
-            output.layer_slots.clear()
-            filepath = f"{name}{aov_sep}AOVs.####"
-            output.base_path = os.path.join(output_path, filepath)
-
-            aov_file_products.append(
-                ("AOVs", os.path.join(output_path, filepath)))
-        else:
-            output.file_slots.clear()
-            output.base_path = output_path
-
         image_settings = bpy.context.scene.render.image_settings
         output.format.file_format = image_settings.file_format
 
+        # In case of a multilayer exr, we don't need to use the output node,
+        # because the blender render already outputs a multilayer exr.
+        if ext == "exr" and multilayer:
+            output.layer_slots.clear()
+            return []
+
+        output.file_slots.clear()
+        output.base_path = output_path
+
+        aov_file_products = []
+
         # For each active render pass, we add a new socket to the output node
         # and link it
         for render_pass in passes:
-            if ext == "exr" and multilayer:
-                output.layer_slots.new(render_pass.name)
-            else:
-                filepath = f"{name}{aov_sep}{render_pass.name}.####"
+            filepath = f"{name}{aov_sep}{render_pass.name}.####"
 
-                output.file_slots.new(filepath)
+            output.file_slots.new(filepath)
 
-                aov_file_products.append(
-                    (render_pass.name, os.path.join(output_path, filepath)))
+            aov_file_products.append(
+                (render_pass.name, os.path.join(output_path, filepath)))
 
             node_input = output.inputs[-1]
 

From 651177dedbfe75c03022c2b1f7930fdda5b93315 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <43494761+iLLiCiTiT@users.noreply.github.com>
Date: Tue, 12 Sep 2023 16:17:22 +0200
Subject: [PATCH 205/366] TVPaint: Fix tool callbacks (#5608)

* don't wait for tools to show

* use 'deque' instead of 'Queue'
---
 .../hosts/tvpaint/api/communication_server.py | 24 +++++++++----------
 1 file changed, 12 insertions(+), 12 deletions(-)

diff --git a/openpype/hosts/tvpaint/api/communication_server.py b/openpype/hosts/tvpaint/api/communication_server.py
index 6f76c25e0c..d67ef8f798 100644
--- a/openpype/hosts/tvpaint/api/communication_server.py
+++ b/openpype/hosts/tvpaint/api/communication_server.py
@@ -11,7 +11,7 @@ import filecmp
 import tempfile
 import threading
 import shutil
-from queue import Queue
+
 from contextlib import closing
 
 from aiohttp import web
@@ -319,19 +319,19 @@ class QtTVPaintRpc(BaseTVPaintRpc):
     async def workfiles_tool(self):
         log.info("Triggering Workfile tool")
         item = MainThreadItem(self.tools_helper.show_workfiles)
-        self._execute_in_main_thread(item)
+        self._execute_in_main_thread(item, wait=False)
         return
 
     async def loader_tool(self):
         log.info("Triggering Loader tool")
         item = MainThreadItem(self.tools_helper.show_loader)
-        self._execute_in_main_thread(item)
+        self._execute_in_main_thread(item, wait=False)
         return
 
     async def publish_tool(self):
         log.info("Triggering Publish tool")
         item = MainThreadItem(self.tools_helper.show_publisher_tool)
-        self._execute_in_main_thread(item)
+        self._execute_in_main_thread(item, wait=False)
         return
 
     async def scene_inventory_tool(self):
@@ -350,13 +350,13 @@ class QtTVPaintRpc(BaseTVPaintRpc):
     async def library_loader_tool(self):
         log.info("Triggering Library loader tool")
         item = MainThreadItem(self.tools_helper.show_library_loader)
-        self._execute_in_main_thread(item)
+        self._execute_in_main_thread(item, wait=False)
         return
 
     async def experimental_tools(self):
         log.info("Triggering Library loader tool")
         item = MainThreadItem(self.tools_helper.show_experimental_tools_dialog)
-        self._execute_in_main_thread(item)
+        self._execute_in_main_thread(item, wait=False)
         return
 
     async def _async_execute_in_main_thread(self, item, **kwargs):
@@ -867,7 +867,7 @@ class QtCommunicator(BaseCommunicator):
 
     def __init__(self, qt_app):
         super().__init__()
-        self.callback_queue = Queue()
+        self.callback_queue = collections.deque()
         self.qt_app = qt_app
 
     def _create_routes(self):
@@ -880,14 +880,14 @@ class QtCommunicator(BaseCommunicator):
 
     def execute_in_main_thread(self, main_thread_item, wait=True):
         """Add `MainThreadItem` to callback queue and wait for result."""
-        self.callback_queue.put(main_thread_item)
+        self.callback_queue.append(main_thread_item)
         if wait:
             return main_thread_item.wait()
         return
 
     async def async_execute_in_main_thread(self, main_thread_item, wait=True):
         """Add `MainThreadItem` to callback queue and wait for result."""
-        self.callback_queue.put(main_thread_item)
+        self.callback_queue.append(main_thread_item)
         if wait:
             return await main_thread_item.async_wait()
 
@@ -904,9 +904,9 @@ class QtCommunicator(BaseCommunicator):
             self._exit()
             return None
 
-        if self.callback_queue.empty():
-            return None
-        return self.callback_queue.get()
+        if self.callback_queue:
+            return self.callback_queue.popleft()
+        return None
 
     def _on_client_connect(self):
         super()._on_client_connect()

From 2142d596038aa37d382f5dd5c5df947ec437f58b Mon Sep 17 00:00:00 2001
From: Ynbot <bot@ynput.io>
Date: Tue, 12 Sep 2023 14:37:04 +0000
Subject: [PATCH 206/366] [Automated] Release

---
 CHANGELOG.md        | 237 ++++++++++++++++++++++++++++++++++++++++++++
 openpype/version.py |   2 +-
 pyproject.toml      |   2 +-
 3 files changed, 239 insertions(+), 2 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index c4f9ff57ea..0d7620869b 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,6 +1,243 @@
 # Changelog
 
 
+## [3.16.6](https://github.com/ynput/OpenPype/tree/3.16.6)
+
+
+[Full Changelog](https://github.com/ynput/OpenPype/compare/3.16.5...3.16.6)
+
+### **🆕 New features**
+
+
+<details>
+<summary>Workfiles tool: Refactor workfiles tool (for AYON) <a href="https://github.com/ynput/OpenPype/pull/5550">#5550</a></summary>
+
+Refactored workfiles tool to new tool. Separated backend and frontend logic. Refactored logic is AYON-centric and is used only in AYON mode, so it does not affect OpenPype.
+
+
+___
+
+</details>
+
+
+<details>
+<summary>AfterEffects: added validator for missing files in FootageItems <a href="https://github.com/ynput/OpenPype/pull/5590">#5590</a></summary>
+
+Published composition in AE could contain multiple FootageItems as a layers. If FootageItem contains imported file and it doesn't exist, render triggered by Publish process will silently fail and no output is generated. This could cause failure later in the process with unclear reason. (In `ExtractReview`).This PR adds validation to protect from this.
+
+
+___
+
+</details>
+
+### **🚀 Enhancements**
+
+
+<details>
+<summary>Maya: Yeti Cache Include viewport preview settings from source <a href="https://github.com/ynput/OpenPype/pull/5561">#5561</a></summary>
+
+When publishing and loading yeti caches persist the display output and preview colors + settings to ensure consistency in the view
+
+
+___
+
+</details>
+
+
+<details>
+<summary>Houdini: validate colorspace in review rop <a href="https://github.com/ynput/OpenPype/pull/5322">#5322</a></summary>
+
+Adding a validator that checks if 'OCIO Colorspace' parameter on  review rop was set to a valid value.It is a step towards managing colorspace in review ropvalid values are the ones in the dropdown menuthis validator also provides some helper actions This PR is related to #4836 and #4833
+
+
+___
+
+</details>
+
+
+<details>
+<summary>Colorspace: adding abstraction of publishing related functions <a href="https://github.com/ynput/OpenPype/pull/5497">#5497</a></summary>
+
+The functionality of Colorspace has been abstracted for greater usability.
+
+
+___
+
+</details>
+
+
+<details>
+<summary>Nuke: removing redundant workfile colorspace attributes <a href="https://github.com/ynput/OpenPype/pull/5580">#5580</a></summary>
+
+Nuke root workfile colorspace data type knobs are long time configured automatically via config roles or the default values are also working well. Therefore there is no need for pipeline managed knobs.
+
+
+___
+
+</details>
+
+
+<details>
+<summary>Ftrack: Less verbose logs for Ftrack integration in artist facing logs <a href="https://github.com/ynput/OpenPype/pull/5596">#5596</a></summary>
+
+- Reduce artist-facing logs for component integration for Ftrack
+- Avoid "Comment is not set" log in artist facing report for Kitsu and Ftrack
+- Remove info log about `ffprobe` inspecting a file (changed to debug log)
+- interesting to see however that it ffprobes the same jpeg twice - but maybe once for thumbnail?
+
+
+___
+
+</details>
+
+### **🐛 Bug fixes**
+
+
+<details>
+<summary>Maya: Fix rig validators for new out_SET and controls_SET names  <a href="https://github.com/ynput/OpenPype/pull/5595">#5595</a></summary>
+
+Fix usage of `out_SET` and `controls_SET` since #5310 because they can now be prefixed by the subset name.
+
+
+___
+
+</details>
+
+
+<details>
+<summary>TrayPublisher: set default frame values to sequential data <a href="https://github.com/ynput/OpenPype/pull/5530">#5530</a></summary>
+
+We are inheriting  default frame handles and fps data either from project or setting them to 0. This is just for case a production will decide not to injest the sequential representations with asset based metadata.
+
+
+___
+
+</details>
+
+
+<details>
+<summary>Publisher: Screenshot opacity value fix <a href="https://github.com/ynput/OpenPype/pull/5576">#5576</a></summary>
+
+Fix opacity value.
+
+
+___
+
+</details>
+
+
+<details>
+<summary>AfterEffects: fix imports of image sequences <a href="https://github.com/ynput/OpenPype/pull/5581">#5581</a></summary>
+
+#4602 broke imports of image sequences.
+
+
+___
+
+</details>
+
+
+<details>
+<summary>AYON: Fix representation context conversion <a href="https://github.com/ynput/OpenPype/pull/5591">#5591</a></summary>
+
+Do not fix `"folder"` key in representation context until it is needed.
+
+
+___
+
+</details>
+
+
+<details>
+<summary>ayon-nuke: default factory to lists  <a href="https://github.com/ynput/OpenPype/pull/5594">#5594</a></summary>
+
+Default factory were missing in settings schemas for complicated objects like lists and it was causing settings to be failing saving.
+
+
+___
+
+</details>
+
+
+<details>
+<summary>Maya: Fix look assigner showing no asset if 'not found' representations are present <a href="https://github.com/ynput/OpenPype/pull/5597">#5597</a></summary>
+
+Fix Maya Look assigner failing to show any content if it finds an invalid container for which it can't find the asset in the current project. (This can happen when e.g. loading something from a library project).There was logic already to avoid this but there was a bug where it used variable `_id` which did not exist and likely had to be `asset_id`.I've fixed that and improved the logged message a bit, e.g.:
+```
+// Warning: openpype.hosts.maya.tools.mayalookassigner.commands : Id found on 22 nodes for which no asset is found database, skipping '641d78ec85c3c5b102e836b0'
+```
+Example not found representation in Loader:The issue isn't necessarily related to NOT FOUND representations but in essence boils down to finding nodes with asset ids that do not exist in the current project which could very well just be local meshes in your scene.**Note:**I've excluded logging the nodes themselves because that tends to be a very long list of nodes. Only downside to removing that is that it's unclear which nodes are related to that `id`. If there are any ideas on how to still provide a concise informational message about that that'd be great so I could add it. Things I had considered:
+- Report the containers, issue here is that it's about asset ids on nodes which don't HAVE to be in containers - it could be local geometry
+- Report the namespaces, issue here is that it could be nodes without namespaces (plus potentially not about ALL nodes in a namespace)
+- Report the short names of the nodes; it's shorter and readable but still likely a lot of nodes.@tokejepsen @LiborBatek any other ideas?
+
+
+___
+
+</details>
+
+
+<details>
+<summary>Photoshop: fixed blank Flatten image <a href="https://github.com/ynput/OpenPype/pull/5600">#5600</a></summary>
+
+Flatten image is simplified publishing approach where all visible layers are "flatten" and published together. This image could be used as a reference etc.This is implemented by auto creator which wasn't updated after first publish. This would result in missing newly created layers after `auto_image` instance was created.
+
+
+___
+
+</details>
+
+
+<details>
+<summary>Blender: Remove Hardcoded Subset Name for Reviews <a href="https://github.com/ynput/OpenPype/pull/5603">#5603</a></summary>
+
+Fixes hardcoded subset name for Reviews in Blender.
+
+
+___
+
+</details>
+
+
+<details>
+<summary>TVPaint: Fix tool callbacks <a href="https://github.com/ynput/OpenPype/pull/5608">#5608</a></summary>
+
+Do not wait for callback to finish.
+
+
+___
+
+</details>
+
+### **🔀 Refactored code**
+
+
+<details>
+<summary>Chore: Remove unused variables and cleanup <a href="https://github.com/ynput/OpenPype/pull/5588">#5588</a></summary>
+
+Removing some unused variables. In some cases the unused variables _seemed like they should've been used - maybe?_ so please **double check the code whether it doesn't hint to an already existing bug**.Also tweaked some other small bugs in code + tweaked logging levels.
+
+
+___
+
+</details>
+
+### **Merged pull requests**
+
+
+<details>
+<summary>Chore: Loader log deprecation warning for 'fname' attribute <a href="https://github.com/ynput/OpenPype/pull/5587">#5587</a></summary>
+
+Since https://github.com/ynput/OpenPype/pull/4602 the `fname` attribute on the `LoaderPlugin` should've been deprecated and set for removal over time. However, no deprecation warning was logged whatsoever and thus one usage appears to have sneaked in (fixed with this PR) and a new one tried to sneak in with a recent PR
+
+
+___
+
+</details>
+
+
+
+
 ## [3.16.5](https://github.com/ynput/OpenPype/tree/3.16.5)
 
 
diff --git a/openpype/version.py b/openpype/version.py
index b6c56296bc..9d3938dc04 100644
--- a/openpype/version.py
+++ b/openpype/version.py
@@ -1,3 +1,3 @@
 # -*- coding: utf-8 -*-
 """Package declaring Pype version."""
-__version__ = "3.16.6-nightly.1"
+__version__ = "3.16.6"
diff --git a/pyproject.toml b/pyproject.toml
index 68fbf19c91..f859e1aff4 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "OpenPype"
-version = "3.16.5" # OpenPype
+version = "3.16.6" # OpenPype
 description = "Open VFX and Animation pipeline with support."
 authors = ["OpenPype Team <info@openpype.io>"]
 license = "MIT License"

From 9143703a73931b6a4b0c63d0aa939870186c8c43 Mon Sep 17 00:00:00 2001
From: "github-actions[bot]" <github-actions[bot]@users.noreply.github.com>
Date: Tue, 12 Sep 2023 14:38:07 +0000
Subject: [PATCH 207/366] chore(): update bug report / version

---
 .github/ISSUE_TEMPLATE/bug_report.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/ISSUE_TEMPLATE/bug_report.yml b/.github/ISSUE_TEMPLATE/bug_report.yml
index 7a39103859..eb8053f2b3 100644
--- a/.github/ISSUE_TEMPLATE/bug_report.yml
+++ b/.github/ISSUE_TEMPLATE/bug_report.yml
@@ -35,6 +35,7 @@ body:
       label: Version
       description: What version are you running? Look to OpenPype Tray
       options:
+        - 3.16.6
         - 3.16.6-nightly.1
         - 3.16.5
         - 3.16.5-nightly.5
@@ -134,7 +135,6 @@ body:
         - 3.14.9-nightly.5
         - 3.14.9-nightly.4
         - 3.14.9-nightly.3
-        - 3.14.9-nightly.2
     validations:
       required: true
   - type: dropdown

From df96f085f2e21d4a3c8a2cb5e3d33001eb40b99d Mon Sep 17 00:00:00 2001
From: Ynbot <bot@ynput.io>
Date: Wed, 13 Sep 2023 03:24:29 +0000
Subject: [PATCH 208/366] [Automated] Bump version

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

diff --git a/openpype/version.py b/openpype/version.py
index 9d3938dc04..c4a87e7843 100644
--- a/openpype/version.py
+++ b/openpype/version.py
@@ -1,3 +1,3 @@
 # -*- coding: utf-8 -*-
 """Package declaring Pype version."""
-__version__ = "3.16.6"
+__version__ = "3.16.7-nightly.1"

From 5de7dc96dda39f51e0664bbd3e572639cf3d3130 Mon Sep 17 00:00:00 2001
From: "github-actions[bot]" <github-actions[bot]@users.noreply.github.com>
Date: Wed, 13 Sep 2023 03:25:10 +0000
Subject: [PATCH 209/366] chore(): update bug report / version

---
 .github/ISSUE_TEMPLATE/bug_report.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/ISSUE_TEMPLATE/bug_report.yml b/.github/ISSUE_TEMPLATE/bug_report.yml
index eb8053f2b3..35564c2bf0 100644
--- a/.github/ISSUE_TEMPLATE/bug_report.yml
+++ b/.github/ISSUE_TEMPLATE/bug_report.yml
@@ -35,6 +35,7 @@ body:
       label: Version
       description: What version are you running? Look to OpenPype Tray
       options:
+        - 3.16.7-nightly.1
         - 3.16.6
         - 3.16.6-nightly.1
         - 3.16.5
@@ -134,7 +135,6 @@ body:
         - 3.14.9
         - 3.14.9-nightly.5
         - 3.14.9-nightly.4
-        - 3.14.9-nightly.3
     validations:
       required: true
   - type: dropdown

From 9369d4d931f8bd9f7e02e480099d64a4bb89f9b9 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <43494761+iLLiCiTiT@users.noreply.github.com>
Date: Wed, 13 Sep 2023 09:46:48 +0200
Subject: [PATCH 210/366] plugin does recreate menu items when reopened (#5610)

---
 .../tvpaint_plugin/plugin_code/library.cpp    | 106 +++++++++---------
 .../windows_x64/plugin/OpenPypePlugin.dll     | Bin 5811200 -> 5811200 bytes
 .../windows_x86/plugin/OpenPypePlugin.dll     | Bin 5571072 -> 5571072 bytes
 3 files changed, 56 insertions(+), 50 deletions(-)

diff --git a/openpype/hosts/tvpaint/tvpaint_plugin/plugin_code/library.cpp b/openpype/hosts/tvpaint/tvpaint_plugin/plugin_code/library.cpp
index 88106bc770..ec45a45123 100644
--- a/openpype/hosts/tvpaint/tvpaint_plugin/plugin_code/library.cpp
+++ b/openpype/hosts/tvpaint/tvpaint_plugin/plugin_code/library.cpp
@@ -573,56 +573,6 @@ void FAR PASCAL PI_Close( PIFilter* iFilter )
 }
 
 
-/**************************************************************************************/
-// we have something to do !
-
-int FAR PASCAL PI_Parameters( PIFilter* iFilter, char* iArg )
-{
-    if( !iArg )
-    {
-
-        // If the requester is not open, we open it.
-        if( Data.mReq == 0)
-        {
-            // Create empty requester because menu items are defined with
-            //  `define_menu` callback
-            DWORD  req = TVOpenFilterReqEx(
-                    iFilter,
-                    185,
-                    20,
-                    NULL,
-                    NULL,
-                    PIRF_STANDARD_REQ | PIRF_COLLAPSABLE_REQ,
-                    FILTERREQ_NO_TBAR
-            );
-            if( req == 0 )
-            {
-                TVWarning( iFilter, TXT_REQUESTER_ERROR );
-                return  0;
-            }
-
-
-            Data.mReq = req;
-            // This is a very simple requester, so we create it's content right here instead
-            // of waiting for the PICBREQ_OPEN message...
-            // Not recommended for more complex requesters. (see the other examples)
-
-            // Sets the title of the requester.
-            TVSetReqTitle( iFilter, Data.mReq, TXT_REQUESTER );
-            // Request to listen to ticks
-            TVGrabTicks(iFilter, req, PITICKS_FLAG_ON);
-        }
-        else
-        {
-            // If it is already open, we just put it on front of all other requesters.
-            TVReqToFront( iFilter, Data.mReq );
-        }
-    }
-
-    return  1;
-}
-
-
 int newMenuItemsProcess(PIFilter* iFilter) {
     // Menu items defined with `define_menu` should be propagated.
 
@@ -702,6 +652,62 @@ int newMenuItemsProcess(PIFilter* iFilter) {
 
     return 1;
 }
+
+/**************************************************************************************/
+// we have something to do !
+
+int FAR PASCAL PI_Parameters( PIFilter* iFilter, char* iArg )
+{
+    if( !iArg )
+    {
+
+        // If the requester is not open, we open it.
+        if( Data.mReq == 0)
+        {
+            // Create empty requester because menu items are defined with
+            //  `define_menu` callback
+            DWORD  req = TVOpenFilterReqEx(
+                    iFilter,
+                    185,
+                    20,
+                    NULL,
+                    NULL,
+                    PIRF_STANDARD_REQ | PIRF_COLLAPSABLE_REQ,
+                    FILTERREQ_NO_TBAR
+            );
+            if( req == 0 )
+            {
+                TVWarning( iFilter, TXT_REQUESTER_ERROR );
+                return  0;
+            }
+
+            Data.mReq = req;
+
+            // This is a very simple requester, so we create it's content right here instead
+            // of waiting for the PICBREQ_OPEN message...
+            // Not recommended for more complex requesters. (see the other examples)
+
+            // Sets the title of the requester.
+            TVSetReqTitle( iFilter, Data.mReq, TXT_REQUESTER );
+            // Request to listen to ticks
+            TVGrabTicks(iFilter, req, PITICKS_FLAG_ON);
+
+            if ( Data.firstParams == true ) {
+                Data.firstParams = false;
+            } else {
+                newMenuItemsProcess(iFilter);
+            }
+        }
+        else
+        {
+            // If it is already open, we just put it on front of all other requesters.
+            TVReqToFront( iFilter, Data.mReq );
+        }
+    }
+
+    return  1;
+}
+
 /**************************************************************************************/
 // something happened that needs our attention.
 // Global variable where current button up data are stored
diff --git a/openpype/hosts/tvpaint/tvpaint_plugin/plugin_files/windows_x64/plugin/OpenPypePlugin.dll b/openpype/hosts/tvpaint/tvpaint_plugin/plugin_files/windows_x64/plugin/OpenPypePlugin.dll
index 7081778beee266e9b08d20ba7e48710dd7c4f20c..9c6e969e24601f3686477dfe6d7127561f2a3d9a 100644
GIT binary patch
delta 102578
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
E0Vi#w%>V!Z

delta 102519
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

diff --git a/openpype/hosts/tvpaint/tvpaint_plugin/plugin_files/windows_x86/plugin/OpenPypePlugin.dll b/openpype/hosts/tvpaint/tvpaint_plugin/plugin_files/windows_x86/plugin/OpenPypePlugin.dll
index 0f2afec245f7f73ec3a8d0f72b5892653f5d51cd..b573476a21d7fd73ea1e4b4a53794377954fd845 100644
GIT binary patch
delta 108350
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
KTOZB1qWl|lUX3IG

delta 108259
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


From 2372e552d39137d0fecb3a93bf03dda1581c0361 Mon Sep 17 00:00:00 2001
From: Mustafa-Zarkash <mustafataherzaky@outlook.com>
Date: Wed, 13 Sep 2023 10:46:48 +0300
Subject: [PATCH 211/366] use more decriptive variable name

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

diff --git a/openpype/hosts/houdini/plugins/publish/extract_fbx.py b/openpype/hosts/houdini/plugins/publish/extract_fbx.py
index dd61e68f3b..7993b3352f 100644
--- a/openpype/hosts/houdini/plugins/publish/extract_fbx.py
+++ b/openpype/hosts/houdini/plugins/publish/extract_fbx.py
@@ -21,11 +21,11 @@ class ExtractFBX(publish.Extractor):
 
         # get rop node
         ropnode = hou.node(instance.data.get("instance_node"))
-        output_node = ropnode.evalParm("sopoutput")
+        output_file = ropnode.evalParm("sopoutput")
 
         # get staging_dir and file_name
-        staging_dir = os.path.normpath(os.path.dirname(output_node))
-        file_name = os.path.basename(output_node)
+        staging_dir = os.path.normpath(os.path.dirname(output_file))
+        file_name = os.path.basename(output_file)
 
         # render rop
         self.log.debug("Writing FBX '%s' to '%s'", file_name, staging_dir)

From e5bdb9e98d5c1291c4db2b573f26c34896100b2d Mon Sep 17 00:00:00 2001
From: Kayla Man <moonyuet2008@hotmail.com>
Date: Wed, 13 Sep 2023 18:16:35 +0800
Subject: [PATCH 212/366] unparenting all the objects to the containers & uses
 the OP data to get previous objects

---
 openpype/hosts/max/api/pipeline.py            | 23 ++++++--
 .../hosts/max/plugins/load/load_camera_fbx.py | 38 +++++-------
 .../hosts/max/plugins/load/load_max_scene.py  | 40 ++++++-------
 openpype/hosts/max/plugins/load/load_model.py | 20 +++----
 .../hosts/max/plugins/load/load_model_fbx.py  | 59 ++++++++-----------
 .../hosts/max/plugins/load/load_model_obj.py  | 32 +++++-----
 .../hosts/max/plugins/load/load_model_usd.py  | 55 ++++++++---------
 .../hosts/max/plugins/load/load_pointcache.py | 21 +++----
 .../hosts/max/plugins/load/load_pointcloud.py | 20 +++----
 .../max/plugins/load/load_redshift_proxy.py   | 24 +++-----
 10 files changed, 148 insertions(+), 184 deletions(-)

diff --git a/openpype/hosts/max/api/pipeline.py b/openpype/hosts/max/api/pipeline.py
index 72163f5ecf..6c40acc56b 100644
--- a/openpype/hosts/max/api/pipeline.py
+++ b/openpype/hosts/max/api/pipeline.py
@@ -164,12 +164,11 @@ def containerise(name: str, nodes: list, context,
         "loader": loader,
         "representation": context["representation"]["_id"],
     }
-
     container_name = f"{namespace}:{name}{suffix}"
     container = rt.container(name=container_name)
-    for node in nodes:
-        node.Parent = container
-
+    #for node in nodes:
+    #    node.Parent = container
+    import_custom_attribute_data(container, nodes)
     if not lib.imprint(container_name, data):
         print(f"imprinting of {container_name} failed.")
     return container
@@ -223,3 +222,19 @@ def update_custom_attribute_data(container: str, selections: list):
     if container.modifiers[0].name == "OP Data":
         rt.deleteModifier(container, container.modifiers[0])
     import_custom_attribute_data(container, selections)
+
+def get_previous_loaded_object(container: str):
+    """Get previous loaded_object through the OP data
+
+    Args:
+        container (str): the container which stores the OP data
+
+    Returns:
+        node_list(list): list of nodes which are previously loaded
+    """
+    node_list = []
+    sel_list = rt.getProperty(container.modifiers[0].openPypeData, "sel_list")
+    for obj in rt.Objects:
+        if str(obj) in sel_list:
+            node_list.append(obj)
+    return node_list
diff --git a/openpype/hosts/max/plugins/load/load_camera_fbx.py b/openpype/hosts/max/plugins/load/load_camera_fbx.py
index f040115417..39bbf79d0f 100644
--- a/openpype/hosts/max/plugins/load/load_camera_fbx.py
+++ b/openpype/hosts/max/plugins/load/load_camera_fbx.py
@@ -8,7 +8,7 @@ from openpype.hosts.max.api.lib import (
 )
 from openpype.hosts.max.api.pipeline import (
     containerise,
-    import_custom_attribute_data,
+    get_previous_loaded_object,
     update_custom_attribute_data
 )
 from openpype.pipeline import get_representation_path, load
@@ -22,7 +22,6 @@ class FbxLoader(load.LoaderPlugin):
     order = -9
     icon = "code-fork"
     color = "white"
-    postfix = "param"
 
     def load(self, context, name=None, namespace=None, data=None):
         from pymxs import runtime as rt
@@ -42,17 +41,13 @@ class FbxLoader(load.LoaderPlugin):
             name + "_",
             suffix="_",
         )
-        container = rt.container(
-            name=f"{namespace}:{name}_{self.postfix}")
         selections = rt.GetCurrentSelection()
-        import_custom_attribute_data(container, selections)
 
         for selection in selections:
-            selection.Parent = container
             selection.name = f"{namespace}:{selection.name}"
 
         return containerise(
-            name, [container], context,
+            name, selections, context,
             namespace, loader=self.__class__.__name__)
 
     def update(self, container, representation):
@@ -61,12 +56,13 @@ class FbxLoader(load.LoaderPlugin):
         path = get_representation_path(representation)
         node_name = container["instance_node"]
         node = rt.getNodeByName(node_name)
-        namespace, name = get_namespace(node_name)
-        sub_node_name = f"{namespace}:{name}_{self.postfix}"
-        inst_container = rt.getNodeByName(sub_node_name)
-        rt.Select(inst_container.Children)
-        transform_data = object_transform_set(inst_container.Children)
-        for prev_fbx_obj in rt.selection:
+        namespace, _ = get_namespace(node_name)
+
+        node_list = get_previous_loaded_object(node)
+        rt.Select(node_list)
+        prev_fbx_objects = rt.GetCurrentSelection()
+        transform_data = object_transform_set(prev_fbx_objects)
+        for prev_fbx_obj in prev_fbx_objects:
             if rt.isValidNode(prev_fbx_obj):
                 rt.Delete(prev_fbx_obj)
 
@@ -78,20 +74,14 @@ class FbxLoader(load.LoaderPlugin):
         rt.ImportFile(
             path, rt.name("noPrompt"), using=rt.FBXIMP)
         current_fbx_objects = rt.GetCurrentSelection()
+        update_custom_attribute_data(node, current_fbx_objects)
         for fbx_object in current_fbx_objects:
-            if fbx_object.Parent != inst_container:
-                fbx_object.Parent = inst_container
-                fbx_object.name = f"{namespace}:{fbx_object.name}"
+            fbx_object.name = f"{namespace}:{fbx_object.name}"
+            if fbx_object in node_list:
                 fbx_object.pos = transform_data[
-                    f"{fbx_object.name}.transform"]
+                    f"{fbx_object.name}.transform"] or fbx_object.pos
                 fbx_object.scale = transform_data[
-                    f"{fbx_object.name}.scale"]
-
-        for children in node.Children:
-            if rt.classOf(children) == rt.Container:
-                if children.name == sub_node_name:
-                    update_custom_attribute_data(
-                        children, current_fbx_objects)
+                    f"{fbx_object.name}.scale"] or  fbx_object.scale
 
         with maintained_selection():
             rt.Select(node)
diff --git a/openpype/hosts/max/plugins/load/load_max_scene.py b/openpype/hosts/max/plugins/load/load_max_scene.py
index 98e9be96e1..86b7637c90 100644
--- a/openpype/hosts/max/plugins/load/load_max_scene.py
+++ b/openpype/hosts/max/plugins/load/load_max_scene.py
@@ -7,7 +7,7 @@ from openpype.hosts.max.api.lib import (
     object_transform_set
 )
 from openpype.hosts.max.api.pipeline import (
-    containerise, import_custom_attribute_data,
+    containerise, get_previous_loaded_object,
     update_custom_attribute_data
 )
 from openpype.pipeline import get_representation_path, load
@@ -24,7 +24,6 @@ class MaxSceneLoader(load.LoaderPlugin):
     order = -8
     icon = "code-fork"
     color = "green"
-    postfix = "param"
 
     def load(self, context, name=None, namespace=None, data=None):
         from pymxs import runtime as rt
@@ -37,18 +36,14 @@ class MaxSceneLoader(load.LoaderPlugin):
         max_object_names = [obj.name for obj in max_objects]
         # implement the OP/AYON custom attributes before load
         max_container = []
-
         namespace = unique_namespace(
             name + "_",
             suffix="_",
         )
-        container_name = f"{namespace}:{name}_{self.postfix}"
-        container = rt.Container(name=container_name)
-        import_custom_attribute_data(container, max_objects)
-        max_container.append(container)
-        max_container.extend(max_objects)
         for max_obj, obj_name in zip(max_objects, max_object_names):
             max_obj.name = f"{namespace}:{obj_name}"
+            max_container.append(rt.getNodeByName(max_obj.name))
+
         return containerise(
             name, max_container, context,
             namespace, loader=self.__class__.__name__)
@@ -60,32 +55,31 @@ class MaxSceneLoader(load.LoaderPlugin):
         node_name = container["instance_node"]
 
         node = rt.getNodeByName(node_name)
-        namespace, name = get_namespace(node_name)
-        sub_container_name = f"{namespace}:{name}_{self.postfix}"
+        namespace, _ = get_namespace(node_name)
         # delete the old container with attribute
         # delete old duplicate
-        rt.Select(node.Children)
-        transform_data = object_transform_set(node.Children)
-        for prev_max_obj in rt.GetCurrentSelection():
-            if rt.isValidNode(prev_max_obj) and prev_max_obj.name != sub_container_name:  # noqa
+        # use the modifier OP data to delete the data
+        node_list = get_previous_loaded_object(node)
+        rt.Select(node_list)
+        prev_max_objects = rt.GetCurrentSelection()
+        transform_data = object_transform_set(prev_max_objects)
+        for prev_max_obj in prev_max_objects:
+            if rt.isValidNode(prev_max_obj):  # noqa
                 rt.Delete(prev_max_obj)
         rt.MergeMaxFile(path, rt.Name("deleteOldDups"))
 
         current_max_objects = rt.getLastMergedNodes()
         current_max_object_names = [obj.name for obj
                                     in current_max_objects]
-        sub_container = rt.getNodeByName(sub_container_name)
-        update_custom_attribute_data(sub_container, current_max_objects)
-        for max_object in current_max_objects:
-            max_object.Parent = node
+        update_custom_attribute_data(node, current_max_objects)
         for max_obj, obj_name in zip(current_max_objects,
                                      current_max_object_names):
             max_obj.name = f"{namespace}:{obj_name}"
-            max_obj.pos = transform_data[
-                f"{max_obj.name}.transform"]
-            max_obj.scale = transform_data[
-                f"{max_obj.name}.scale"]
-
+            if max_obj in node_list:
+                max_obj.pos = transform_data[
+                    f"{max_obj.name}.transform"] or max_obj.pos
+                max_obj.scale = transform_data[
+                    f"{max_obj.name}.scale"] or max_obj.scale
         lib.imprint(container["instance_node"], {
             "representation": str(representation["_id"])
         })
diff --git a/openpype/hosts/max/plugins/load/load_model.py b/openpype/hosts/max/plugins/load/load_model.py
index c5a73b4327..5acb57b923 100644
--- a/openpype/hosts/max/plugins/load/load_model.py
+++ b/openpype/hosts/max/plugins/load/load_model.py
@@ -2,8 +2,7 @@ import os
 from openpype.pipeline import load, get_representation_path
 from openpype.hosts.max.api.pipeline import (
     containerise,
-    import_custom_attribute_data,
-    update_custom_attribute_data
+    get_previous_loaded_object
 )
 from openpype.hosts.max.api import lib
 from openpype.hosts.max.api.lib import (
@@ -20,7 +19,6 @@ class ModelAbcLoader(load.LoaderPlugin):
     order = -10
     icon = "code-fork"
     color = "orange"
-    postfix = "param"
 
     def load(self, context, name=None, namespace=None, data=None):
         from pymxs import runtime as rt
@@ -52,21 +50,22 @@ class ModelAbcLoader(load.LoaderPlugin):
             self.log.error("Something failed when loading.")
 
         abc_container = abc_containers.pop()
-        import_custom_attribute_data(
-            abc_container, abc_container.Children)
 
         namespace = unique_namespace(
             name + "_",
             suffix="_",
         )
+        abc_objects = []
         for abc_object in abc_container.Children:
             abc_object.name = f"{namespace}:{abc_object.name}"
+            abc_objects.append(abc_object)
         # rename the abc container with namespace
-        abc_container_name = f"{namespace}:{name}_{self.postfix}"
+        abc_container_name = f"{namespace}:{name}"
         abc_container.name = abc_container_name
+        abc_objects.append(abc_container)
 
         return containerise(
-            name, [abc_container], context,
+            name, abc_objects, context,
             namespace, loader=self.__class__.__name__
         )
 
@@ -75,20 +74,19 @@ class ModelAbcLoader(load.LoaderPlugin):
 
         path = get_representation_path(representation)
         node = rt.GetNodeByName(container["instance_node"])
-
+        node_list = [n for n in get_previous_loaded_object(node)
+                     if rt.ClassOf(n) == rt.AlembicContainer]
         with maintained_selection():
-            rt.Select(node.Children)
+            rt.Select(node_list)
 
             for alembic in rt.Selection:
                 abc = rt.GetNodeByName(alembic.name)
-                update_custom_attribute_data(abc, abc.Children)
                 rt.Select(abc.Children)
                 for abc_con in abc.Children:
                     abc_con.source = path
                     rt.Select(abc_con.Children)
                     for abc_obj in abc_con.Children:
                         abc_obj.source = path
-
         lib.imprint(
             container["instance_node"],
             {"representation": str(representation["_id"])},
diff --git a/openpype/hosts/max/plugins/load/load_model_fbx.py b/openpype/hosts/max/plugins/load/load_model_fbx.py
index 56c8768675..a8f6ea90d6 100644
--- a/openpype/hosts/max/plugins/load/load_model_fbx.py
+++ b/openpype/hosts/max/plugins/load/load_model_fbx.py
@@ -1,7 +1,7 @@
 import os
 from openpype.pipeline import load, get_representation_path
 from openpype.hosts.max.api.pipeline import (
-    containerise, import_custom_attribute_data,
+    containerise, get_previous_loaded_object,
     update_custom_attribute_data
 )
 from openpype.hosts.max.api import lib
@@ -21,79 +21,68 @@ class FbxModelLoader(load.LoaderPlugin):
     order = -9
     icon = "code-fork"
     color = "white"
-    postfix = "param"
 
     def load(self, context, name=None, namespace=None, data=None):
         from pymxs import runtime as rt
-
-        filepath = os.path.normpath(self.filepath_from_context(context))
+        filepath = self.filepath_from_context(context)
+        filepath = os.path.normpath(filepath)
         rt.FBXImporterSetParam("Animation", False)
         rt.FBXImporterSetParam("Cameras", False)
         rt.FBXImporterSetParam("Mode", rt.Name("create"))
         rt.FBXImporterSetParam("Preserveinstances", True)
-        rt.importFile(filepath, rt.name("noPrompt"), using=rt.FBXIMP)
+        rt.importFile(
+            filepath, rt.name("noPrompt"), using=rt.FBXIMP)
 
         namespace = unique_namespace(
             name + "_",
             suffix="_",
         )
-        container = rt.container(
-            name=f"{namespace}:{name}_{self.postfix}")
         selections = rt.GetCurrentSelection()
-        import_custom_attribute_data(container, selections)
 
         for selection in selections:
-            selection.Parent = container
             selection.name = f"{namespace}:{selection.name}"
 
         return containerise(
-            name, [container], context,
-            namespace, loader=self.__class__.__name__
-        )
+            name, selections, context,
+            namespace, loader=self.__class__.__name__)
 
     def update(self, container, representation):
         from pymxs import runtime as rt
+
         path = get_representation_path(representation)
         node_name = container["instance_node"]
         node = rt.getNodeByName(node_name)
-        namespace, name = get_namespace(node_name)
-        sub_node_name = f"{namespace}:{name}_{self.postfix}"
-        inst_container = rt.getNodeByName(sub_node_name)
-        rt.Select(inst_container.Children)
-        transform_data = object_transform_set(inst_container.Children)
-        for prev_fbx_obj in rt.selection:
+        namespace, _ = get_namespace(node_name)
+
+        node_list = get_previous_loaded_object(node)
+        rt.Select(node_list)
+        prev_fbx_objects = rt.GetCurrentSelection()
+        transform_data = object_transform_set(prev_fbx_objects)
+        for prev_fbx_obj in prev_fbx_objects:
             if rt.isValidNode(prev_fbx_obj):
                 rt.Delete(prev_fbx_obj)
 
         rt.FBXImporterSetParam("Animation", False)
         rt.FBXImporterSetParam("Cameras", False)
-        rt.FBXImporterSetParam("Mode", rt.Name("merge"))
-        rt.FBXImporterSetParam("AxisConversionMethod", True)
+        rt.FBXImporterSetParam("Mode", rt.Name("create"))
         rt.FBXImporterSetParam("Preserveinstances", True)
         rt.importFile(path, rt.name("noPrompt"), using=rt.FBXIMP)
         current_fbx_objects = rt.GetCurrentSelection()
+        update_custom_attribute_data(node, current_fbx_objects)
         for fbx_object in current_fbx_objects:
-            if fbx_object.Parent != inst_container:
-                fbx_object.Parent = inst_container
-                fbx_object.name = f"{namespace}:{fbx_object.name}"
+            fbx_object.name = f"{namespace}:{fbx_object.name}"
+            if fbx_object in node_list:
                 fbx_object.pos = transform_data[
-                    f"{fbx_object.name}.transform"]
+                    f"{fbx_object.name}.transform"] or fbx_object.pos
                 fbx_object.scale = transform_data[
-                    f"{fbx_object.name}.scale"]
-
-        for children in node.Children:
-            if rt.classOf(children) == rt.Container:
-                if children.name == sub_node_name:
-                    update_custom_attribute_data(
-                        children, current_fbx_objects)
+                    f"{fbx_object.name}.scale"] or fbx_object.scale
 
         with maintained_selection():
             rt.Select(node)
 
-        lib.imprint(
-            node_name,
-            {"representation": str(representation["_id"])},
-        )
+        lib.imprint(container["instance_node"], {
+            "representation": str(representation["_id"])
+        })
 
     def switch(self, container, representation):
         self.update(container, representation)
diff --git a/openpype/hosts/max/plugins/load/load_model_obj.py b/openpype/hosts/max/plugins/load/load_model_obj.py
index 314889e6ec..421bd34e62 100644
--- a/openpype/hosts/max/plugins/load/load_model_obj.py
+++ b/openpype/hosts/max/plugins/load/load_model_obj.py
@@ -10,7 +10,7 @@ from openpype.hosts.max.api.lib import (
 from openpype.hosts.max.api.lib import maintained_selection
 from openpype.hosts.max.api.pipeline import (
     containerise,
-    import_custom_attribute_data,
+    get_previous_loaded_object,
     update_custom_attribute_data
 )
 from openpype.pipeline import get_representation_path, load
@@ -24,7 +24,6 @@ class ObjLoader(load.LoaderPlugin):
     order = -9
     icon = "code-fork"
     color = "white"
-    postfix = "param"
 
     def load(self, context, name=None, namespace=None, data=None):
         from pymxs import runtime as rt
@@ -39,15 +38,12 @@ class ObjLoader(load.LoaderPlugin):
             suffix="_",
         )
         # create "missing" container for obj import
-        container = rt.Container(name=f"{namespace}:{name}_{self.postfix}")
         selections = rt.GetCurrentSelection()
-        import_custom_attribute_data(container, selections)
         # get current selection
         for selection in selections:
-            selection.Parent = container
             selection.name = f"{namespace}:{selection.name}"
         return containerise(
-            name, [container], context,
+            name, selections, context,
             namespace, loader=self.__class__.__name__)
 
     def update(self, container, representation):
@@ -56,26 +52,26 @@ class ObjLoader(load.LoaderPlugin):
         path = get_representation_path(representation)
         node_name = container["instance_node"]
         node = rt.getNodeByName(node_name)
-        namespace, name = get_namespace(node_name)
-        sub_node_name = f"{namespace}:{name}_{self.postfix}"
-        inst_container = rt.getNodeByName(sub_node_name)
-        rt.Select(inst_container.Children)
-        transform_data = object_transform_set(inst_container.Children)
-        for prev_obj in rt.selection:
+        namespace, _ = get_namespace(node_name)
+        node_list = get_previous_loaded_object(node)
+        rt.Select(node_list)
+        previous_objects = rt.GetCurrentSelection()
+        transform_data = object_transform_set(previous_objects)
+        for prev_obj in previous_objects:
             if rt.isValidNode(prev_obj):
                 rt.Delete(prev_obj)
 
         rt.Execute(f'importFile @"{path}" #noPrompt using:ObjImp')
         # get current selection
         selections = rt.GetCurrentSelection()
-        update_custom_attribute_data(inst_container, selections)
         for selection in selections:
-            selection.Parent = inst_container
             selection.name = f"{namespace}:{selection.name}"
-            selection.pos = transform_data[
-                f"{selection.name}.transform"]
-            selection.scale = transform_data[
-                f"{selection.name}.scale"]
+            if selection in node_list:
+                selection.pos = transform_data[
+                    f"{selection.name}.transform"] or selection.pos
+                selection.scale = transform_data[
+                    f"{selection.name}.scale"] or selection.scale
+        update_custom_attribute_data(node, selections)
         with maintained_selection():
             rt.Select(node)
 
diff --git a/openpype/hosts/max/plugins/load/load_model_usd.py b/openpype/hosts/max/plugins/load/load_model_usd.py
index f35d8e6327..09566c2e78 100644
--- a/openpype/hosts/max/plugins/load/load_model_usd.py
+++ b/openpype/hosts/max/plugins/load/load_model_usd.py
@@ -1,5 +1,7 @@
 import os
 
+from pymxs import runtime as rt
+
 from openpype.hosts.max.api import lib
 from openpype.hosts.max.api.lib import (
     unique_namespace,
@@ -9,7 +11,8 @@ from openpype.hosts.max.api.lib import (
 from openpype.hosts.max.api.lib import maintained_selection
 from openpype.hosts.max.api.pipeline import (
     containerise,
-    import_custom_attribute_data
+    get_previous_loaded_object,
+    update_custom_attribute_data
 )
 from openpype.pipeline import get_representation_path, load
 
@@ -23,16 +26,13 @@ class ModelUSDLoader(load.LoaderPlugin):
     order = -10
     icon = "code-fork"
     color = "orange"
-    postfix = "param"
 
     def load(self, context, name=None, namespace=None, data=None):
-        from pymxs import runtime as rt
-
         # asset_filepath
         filepath = os.path.normpath(self.filepath_from_context(context))
         import_options = rt.USDImporter.CreateOptions()
         base_filename = os.path.basename(filepath)
-        filename, ext = os.path.splitext(base_filename)
+        _, ext = os.path.splitext(base_filename)
         log_filepath = filepath.replace(ext, "txt")
 
         rt.LogPath = log_filepath
@@ -44,35 +44,32 @@ class ModelUSDLoader(load.LoaderPlugin):
             suffix="_",
         )
         asset = rt.GetNodeByName(name)
-        import_custom_attribute_data(asset, asset.Children)
+        usd_objects = []
+
         for usd_asset in asset.Children:
             usd_asset.name = f"{namespace}:{usd_asset.name}"
+            usd_objects.append(usd_asset)
 
-        asset_name = f"{namespace}:{name}_{self.postfix}"
+        asset_name = f"{namespace}:{name}"
         asset.name = asset_name
         # need to get the correct container after renamed
         asset = rt.GetNodeByName(asset_name)
-
+        usd_objects.append(asset)
 
         return containerise(
-            name, [asset], context,
+            name, usd_objects, context,
             namespace, loader=self.__class__.__name__)
 
     def update(self, container, representation):
-        from pymxs import runtime as rt
-
         path = get_representation_path(representation)
         node_name = container["instance_node"]
         node = rt.GetNodeByName(node_name)
         namespace, name = get_namespace(node_name)
-        sub_node_name = f"{namespace}:{name}_{self.postfix}"
-        transform_data = None
-        for n in node.Children:
-            rt.Select(n.Children)
-            transform_data = object_transform_set(n.Children)
-            for prev_usd_asset in rt.selection:
-                if rt.isValidNode(prev_usd_asset):
-                    rt.Delete(prev_usd_asset)
+        node_list = get_previous_loaded_object(node)
+        rt.Select(node_list)
+        prev_objects = rt.GetCurrentSelection()
+        transform_data = object_transform_set(prev_objects)
+        for n in prev_objects:
             rt.Delete(n)
 
         import_options = rt.USDImporter.CreateOptions()
@@ -86,17 +83,19 @@ class ModelUSDLoader(load.LoaderPlugin):
             path, importOptions=import_options)
 
         asset = rt.GetNodeByName(name)
-        asset.Parent = node
-        import_custom_attribute_data(asset, asset.Children)
+        usd_objects = []
         for children in asset.Children:
             children.name = f"{namespace}:{children.name}"
-            children.pos = transform_data[
-                f"{children.name}.transform"]
-            children.scale = transform_data[
-                f"{children.name}.scale"]
-
-        asset.name = sub_node_name
+            usd_objects.append(children)
+            if children in node_list:
+                children.pos = transform_data[
+                    f"{children.name}.transform"] or children.pos
+                children.scale = transform_data[
+                    f"{children.name}.scale"] or children.scale
 
+        asset.name = f"{namespace}:{asset.name}"
+        usd_objects.append(asset)
+        update_custom_attribute_data(node, usd_objects)
         with maintained_selection():
             rt.Select(node)
 
@@ -108,7 +107,5 @@ class ModelUSDLoader(load.LoaderPlugin):
         self.update(container, representation)
 
     def remove(self, container):
-        from pymxs import runtime as rt
-
         node = rt.GetNodeByName(container["instance_node"])
         rt.Delete(node)
diff --git a/openpype/hosts/max/plugins/load/load_pointcache.py b/openpype/hosts/max/plugins/load/load_pointcache.py
index 070dea88d4..995e56ca37 100644
--- a/openpype/hosts/max/plugins/load/load_pointcache.py
+++ b/openpype/hosts/max/plugins/load/load_pointcache.py
@@ -10,8 +10,7 @@ from openpype.hosts.max.api import lib, maintained_selection
 from openpype.hosts.max.api.lib import unique_namespace
 from openpype.hosts.max.api.pipeline import (
     containerise,
-    import_custom_attribute_data,
-    update_custom_attribute_data
+    get_previous_loaded_object
 )
 
 
@@ -24,7 +23,6 @@ class AbcLoader(load.LoaderPlugin):
     order = -10
     icon = "code-fork"
     color = "orange"
-    postfix = "param"
 
     def load(self, context, name=None, namespace=None, data=None):
         from pymxs import runtime as rt
@@ -55,8 +53,6 @@ class AbcLoader(load.LoaderPlugin):
 
         abc_container = abc_containers.pop()
         selections = rt.GetCurrentSelection()
-        import_custom_attribute_data(
-            abc_container, abc_container.Children)
         for abc in selections:
             for cam_shape in abc.Children:
                 cam_shape.playbackType = 2
@@ -65,15 +61,17 @@ class AbcLoader(load.LoaderPlugin):
             name + "_",
             suffix="_",
         )
-
+        abc_objects = []
         for abc_object in abc_container.Children:
             abc_object.name = f"{namespace}:{abc_object.name}"
+            abc_objects.append(abc_object)
         # rename the abc container with namespace
-        abc_container_name = f"{namespace}:{name}_{self.postfix}"
+        abc_container_name = f"{namespace}:{name}"
         abc_container.name = abc_container_name
+        abc_objects.append(abc_container)
 
         return containerise(
-            name, [abc_container], context,
+            name, abc_objects, context,
             namespace, loader=self.__class__.__name__
         )
 
@@ -82,20 +80,19 @@ class AbcLoader(load.LoaderPlugin):
 
         path = get_representation_path(representation)
         node = rt.GetNodeByName(container["instance_node"])
-
+        abc_container = [n for n in get_previous_loaded_object(node)
+                         if rt.ClassOf(n) == rt.AlembicContainer]
         with maintained_selection():
-            rt.Select(node.Children)
+            rt.Select(abc_container)
 
             for alembic in rt.Selection:
                 abc = rt.GetNodeByName(alembic.name)
-                update_custom_attribute_data(abc, abc.Children)
                 rt.Select(abc.Children)
                 for abc_con in abc.Children:
                     abc_con.source = path
                     rt.Select(abc_con.Children)
                     for abc_obj in abc_con.Children:
                         abc_obj.source = path
-
         lib.imprint(
             container["instance_node"],
             {"representation": str(representation["_id"])},
diff --git a/openpype/hosts/max/plugins/load/load_pointcloud.py b/openpype/hosts/max/plugins/load/load_pointcloud.py
index c4c4cfbc6c..2309d3aebf 100644
--- a/openpype/hosts/max/plugins/load/load_pointcloud.py
+++ b/openpype/hosts/max/plugins/load/load_pointcloud.py
@@ -2,11 +2,11 @@ import os
 
 from openpype.hosts.max.api import lib, maintained_selection
 from openpype.hosts.max.api.lib import (
-    unique_namespace, get_namespace
+    unique_namespace
 )
 from openpype.hosts.max.api.pipeline import (
     containerise,
-    import_custom_attribute_data,
+    get_previous_loaded_object,
     update_custom_attribute_data
 )
 from openpype.pipeline import get_representation_path, load
@@ -34,14 +34,10 @@ class PointCloudLoader(load.LoaderPlugin):
             name + "_",
             suffix="_",
         )
-        prt_container = rt.Container(
-            name=f"{namespace}:{name}_{self.postfix}")
-        import_custom_attribute_data(prt_container, [obj])
-        obj.Parent = prt_container
         obj.name = f"{namespace}:{obj.name}"
 
         return containerise(
-            name, [prt_container], context,
+            name, [obj], context,
             namespace, loader=self.__class__.__name__)
 
     def update(self, container, representation):
@@ -50,14 +46,12 @@ class PointCloudLoader(load.LoaderPlugin):
 
         path = get_representation_path(representation)
         node = rt.GetNodeByName(container["instance_node"])
-        namespace, name = get_namespace(container["instance_node"])
-        sub_node_name = f"{namespace}:{name}_{self.postfix}"
-        inst_container = rt.getNodeByName(sub_node_name)
+        node_list = get_previous_loaded_object(node)
         update_custom_attribute_data(
-            inst_container, inst_container.Children)
+            node, node_list)
         with maintained_selection():
-            rt.Select(node.Children)
-            for prt in inst_container.Children:
+            rt.Select(node_list)
+            for prt in rt.Selection:
                 prt.filename = path
         lib.imprint(container["instance_node"], {
             "representation": str(representation["_id"])
diff --git a/openpype/hosts/max/plugins/load/load_redshift_proxy.py b/openpype/hosts/max/plugins/load/load_redshift_proxy.py
index f7dd95962b..36bc7ac9e2 100644
--- a/openpype/hosts/max/plugins/load/load_redshift_proxy.py
+++ b/openpype/hosts/max/plugins/load/load_redshift_proxy.py
@@ -7,12 +7,12 @@ from openpype.pipeline import (
 )
 from openpype.hosts.max.api.pipeline import (
     containerise,
-    import_custom_attribute_data,
-    update_custom_attribute_data
+    update_custom_attribute_data,
+    get_previous_loaded_object
 )
 from openpype.hosts.max.api import lib
 from openpype.hosts.max.api.lib import (
-    unique_namespace, get_namespace
+    unique_namespace
 )
 
 
@@ -25,7 +25,6 @@ class RedshiftProxyLoader(load.LoaderPlugin):
     order = -9
     icon = "code-fork"
     color = "white"
-    postfix = "param"
 
     def load(self, context, name=None, namespace=None, data=None):
         from pymxs import runtime as rt
@@ -42,27 +41,22 @@ class RedshiftProxyLoader(load.LoaderPlugin):
             name + "_",
             suffix="_",
         )
-        container = rt.Container(
-            name=f"{namespace}:{name}_{self.postfix}")
-        rs_proxy.Parent = container
         rs_proxy.name = f"{namespace}:{rs_proxy.name}"
-        import_custom_attribute_data(container, [rs_proxy])
 
         return containerise(
-            name, [container], context,
+            name, [rs_proxy], context,
             namespace, loader=self.__class__.__name__)
 
     def update(self, container, representation):
         from pymxs import runtime as rt
 
         path = get_representation_path(representation)
-        namespace, name = get_namespace(container["instance_node"])
-        sub_node_name = f"{namespace}:{name}_{self.postfix}"
-        inst_container = rt.getNodeByName(sub_node_name)
-
+        node = rt.getNodeByName(container["instance_node"])
+        node_list = get_previous_loaded_object(node)
+        rt.Select(node_list)
         update_custom_attribute_data(
-            inst_container, inst_container.Children)
-        for proxy in inst_container.Children:
+            node, rt.Selection)
+        for proxy in rt.Selection:
             proxy.file = path
 
         lib.imprint(container["instance_node"], {

From 78ec30cb392bd3fbe686101329089d63da797e86 Mon Sep 17 00:00:00 2001
From: Kayla Man <moonyuet2008@hotmail.com>
Date: Wed, 13 Sep 2023 18:21:17 +0800
Subject: [PATCH 213/366] hound

---
 openpype/hosts/max/api/pipeline.py                 | 4 ++--
 openpype/hosts/max/plugins/load/load_camera_fbx.py | 2 +-
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/openpype/hosts/max/api/pipeline.py b/openpype/hosts/max/api/pipeline.py
index 6c40acc56b..86a0a99ca9 100644
--- a/openpype/hosts/max/api/pipeline.py
+++ b/openpype/hosts/max/api/pipeline.py
@@ -166,8 +166,6 @@ def containerise(name: str, nodes: list, context,
     }
     container_name = f"{namespace}:{name}{suffix}"
     container = rt.container(name=container_name)
-    #for node in nodes:
-    #    node.Parent = container
     import_custom_attribute_data(container, nodes)
     if not lib.imprint(container_name, data):
         print(f"imprinting of {container_name} failed.")
@@ -211,6 +209,7 @@ def import_custom_attribute_data(container: str, selections: list):
         container.modifiers[0].openPypeData,
         "sel_list", sel_list)
 
+
 def update_custom_attribute_data(container: str, selections: list):
     """Updating the Openpype/AYON custom parameter built by the creator
 
@@ -223,6 +222,7 @@ def update_custom_attribute_data(container: str, selections: list):
         rt.deleteModifier(container, container.modifiers[0])
     import_custom_attribute_data(container, selections)
 
+
 def get_previous_loaded_object(container: str):
     """Get previous loaded_object through the OP data
 
diff --git a/openpype/hosts/max/plugins/load/load_camera_fbx.py b/openpype/hosts/max/plugins/load/load_camera_fbx.py
index 39bbf79d0f..d28364d5c2 100644
--- a/openpype/hosts/max/plugins/load/load_camera_fbx.py
+++ b/openpype/hosts/max/plugins/load/load_camera_fbx.py
@@ -81,7 +81,7 @@ class FbxLoader(load.LoaderPlugin):
                 fbx_object.pos = transform_data[
                     f"{fbx_object.name}.transform"] or fbx_object.pos
                 fbx_object.scale = transform_data[
-                    f"{fbx_object.name}.scale"] or  fbx_object.scale
+                    f"{fbx_object.name}.scale"] or fbx_object.scale
 
         with maintained_selection():
             rt.Select(node)

From bdaeb3c92f3ba5c2744ce69fa3aadd3135f33699 Mon Sep 17 00:00:00 2001
From: Kayla Man <moonyuet2008@hotmail.com>
Date: Wed, 13 Sep 2023 19:08:09 +0800
Subject: [PATCH 214/366] add loadError for loaders which uses external plugins

---
 openpype/hosts/max/api/lib.py                    | 16 ++++++++++++++++
 .../hosts/max/plugins/load/load_model_usd.py     |  8 ++++++--
 .../hosts/max/plugins/load/load_pointcloud.py    |  4 ++--
 .../max/plugins/load/load_redshift_proxy.py      |  8 ++++++--
 4 files changed, 30 insertions(+), 6 deletions(-)

diff --git a/openpype/hosts/max/api/lib.py b/openpype/hosts/max/api/lib.py
index 8287341456..4a150067e1 100644
--- a/openpype/hosts/max/api/lib.py
+++ b/openpype/hosts/max/api/lib.py
@@ -407,3 +407,19 @@ def object_transform_set(container_children):
         name = f"{node.name}.scale"
         transform_set[name] = node.scale
     return transform_set
+
+
+def get_plugins() -> list:
+    """Get all loaded plugins in 3dsMax
+
+    Returns:
+        plugin_info_list: a list of loaded plugins
+    """
+    manager = rt.PluginManager
+    count = manager.pluginDllCount
+    plugin_info_list = []
+    for p in range(1, count + 1):
+        plugin_info = manager.pluginDllName(p)
+        plugin_info_list.append(plugin_info)
+
+    return plugin_info_list
diff --git a/openpype/hosts/max/plugins/load/load_model_usd.py b/openpype/hosts/max/plugins/load/load_model_usd.py
index 09566c2e78..67d0e75259 100644
--- a/openpype/hosts/max/plugins/load/load_model_usd.py
+++ b/openpype/hosts/max/plugins/load/load_model_usd.py
@@ -1,12 +1,13 @@
 import os
 
 from pymxs import runtime as rt
-
+from openpype.pipeline.load import LoadError
 from openpype.hosts.max.api import lib
 from openpype.hosts.max.api.lib import (
     unique_namespace,
     get_namespace,
-    object_transform_set
+    object_transform_set,
+    get_plugins
 )
 from openpype.hosts.max.api.lib import maintained_selection
 from openpype.hosts.max.api.pipeline import (
@@ -29,6 +30,9 @@ class ModelUSDLoader(load.LoaderPlugin):
 
     def load(self, context, name=None, namespace=None, data=None):
         # asset_filepath
+        plugin_info = get_plugins()
+        if "usdimport.dli" not in plugin_info:
+            raise LoadError("No USDImporter loaded/installed in Max..")
         filepath = os.path.normpath(self.filepath_from_context(context))
         import_options = rt.USDImporter.CreateOptions()
         base_filename = os.path.basename(filepath)
diff --git a/openpype/hosts/max/plugins/load/load_pointcloud.py b/openpype/hosts/max/plugins/load/load_pointcloud.py
index 2309d3aebf..e0317a2e22 100644
--- a/openpype/hosts/max/plugins/load/load_pointcloud.py
+++ b/openpype/hosts/max/plugins/load/load_pointcloud.py
@@ -2,7 +2,8 @@ import os
 
 from openpype.hosts.max.api import lib, maintained_selection
 from openpype.hosts.max.api.lib import (
-    unique_namespace
+    unique_namespace,
+
 )
 from openpype.hosts.max.api.pipeline import (
     containerise,
@@ -25,7 +26,6 @@ class PointCloudLoader(load.LoaderPlugin):
     def load(self, context, name=None, namespace=None, data=None):
         """load point cloud by tyCache"""
         from pymxs import runtime as rt
-
         filepath = os.path.normpath(self.filepath_from_context(context))
         obj = rt.tyCache()
         obj.filename = filepath
diff --git a/openpype/hosts/max/plugins/load/load_redshift_proxy.py b/openpype/hosts/max/plugins/load/load_redshift_proxy.py
index 36bc7ac9e2..daf6d3e169 100644
--- a/openpype/hosts/max/plugins/load/load_redshift_proxy.py
+++ b/openpype/hosts/max/plugins/load/load_redshift_proxy.py
@@ -5,6 +5,7 @@ from openpype.pipeline import (
     load,
     get_representation_path
 )
+from openpype.pipeline.load import LoadError
 from openpype.hosts.max.api.pipeline import (
     containerise,
     update_custom_attribute_data,
@@ -12,7 +13,8 @@ from openpype.hosts.max.api.pipeline import (
 )
 from openpype.hosts.max.api import lib
 from openpype.hosts.max.api.lib import (
-    unique_namespace
+    unique_namespace,
+    get_plugins
 )
 
 
@@ -28,7 +30,9 @@ class RedshiftProxyLoader(load.LoaderPlugin):
 
     def load(self, context, name=None, namespace=None, data=None):
         from pymxs import runtime as rt
-
+        plugin_info = get_plugins()
+        if "redshift4max.dlr" not in plugin_info:
+            raise LoadError("Redshift not loaded/installed in Max..")
         filepath = self.filepath_from_context(context)
         rs_proxy = rt.RedshiftProxy()
         rs_proxy.file = filepath

From c292a11939a7cf3f980d018031e3da86335925c5 Mon Sep 17 00:00:00 2001
From: Kayla Man <moonyuet2008@hotmail.com>
Date: Wed, 13 Sep 2023 19:10:52 +0800
Subject: [PATCH 215/366] typo for LoadError

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

diff --git a/openpype/hosts/max/plugins/load/load_pointcache_ornatrix.py b/openpype/hosts/max/plugins/load/load_pointcache_ornatrix.py
index d87d6b1bfe..f8aadb53c0 100644
--- a/openpype/hosts/max/plugins/load/load_pointcache_ornatrix.py
+++ b/openpype/hosts/max/plugins/load/load_pointcache_ornatrix.py
@@ -1,6 +1,6 @@
 import os
 from openpype.pipeline import load, get_representation_path
-from openpype.pipeline.load import LoaderError
+from openpype.pipeline.load import LoadError
 from openpype.hosts.max.api.pipeline import (
     containerise,
     import_custom_attribute_data,
@@ -30,8 +30,8 @@ class OxAbcLoader(load.LoaderPlugin):
     def load(self, context, name=None, namespace=None, data=None):
         plugin_list = get_plugins()
         if "ephere.plugins.autodesk.max.ornatrix.dlo" not in plugin_list:
-            raise LoaderError("Ornatrix plugin not "
-                              "found/installed in Max yet..")
+            raise LoadError("Ornatrix plugin not "
+                            "found/installed in Max yet..")
 
         file_path = os.path.normpath(self.filepath_from_context(context))
         rt.AlembicImport.ImportToRoot = True

From 8c890641ad9bb8a6f30f82fb2b668e0a6c05281d Mon Sep 17 00:00:00 2001
From: Kayla Man <moonyuet2008@hotmail.com>
Date: Wed, 13 Sep 2023 21:18:30 +0800
Subject: [PATCH 216/366] fixing the issue of duplciated contents during
 switching assets

---
 openpype/hosts/max/plugins/load/load_camera_fbx.py | 4 ++--
 openpype/hosts/max/plugins/load/load_max_scene.py  | 7 +++----
 openpype/hosts/max/plugins/load/load_model_fbx.py  | 4 ++--
 openpype/hosts/max/plugins/load/load_model_obj.py  | 4 ++--
 openpype/hosts/max/plugins/load/load_model_usd.py  | 4 ++--
 5 files changed, 11 insertions(+), 12 deletions(-)

diff --git a/openpype/hosts/max/plugins/load/load_camera_fbx.py b/openpype/hosts/max/plugins/load/load_camera_fbx.py
index d28364d5c2..156e8dcaf6 100644
--- a/openpype/hosts/max/plugins/load/load_camera_fbx.py
+++ b/openpype/hosts/max/plugins/load/load_camera_fbx.py
@@ -79,9 +79,9 @@ class FbxLoader(load.LoaderPlugin):
             fbx_object.name = f"{namespace}:{fbx_object.name}"
             if fbx_object in node_list:
                 fbx_object.pos = transform_data[
-                    f"{fbx_object.name}.transform"] or fbx_object.pos
+                    f"{fbx_object.name}.transform"] or 0
                 fbx_object.scale = transform_data[
-                    f"{fbx_object.name}.scale"] or fbx_object.scale
+                    f"{fbx_object.name}.scale"] or 0
 
         with maintained_selection():
             rt.Select(node)
diff --git a/openpype/hosts/max/plugins/load/load_max_scene.py b/openpype/hosts/max/plugins/load/load_max_scene.py
index 86b7637c90..b7ce5bfe39 100644
--- a/openpype/hosts/max/plugins/load/load_max_scene.py
+++ b/openpype/hosts/max/plugins/load/load_max_scene.py
@@ -60,8 +60,7 @@ class MaxSceneLoader(load.LoaderPlugin):
         # delete old duplicate
         # use the modifier OP data to delete the data
         node_list = get_previous_loaded_object(node)
-        rt.Select(node_list)
-        prev_max_objects = rt.GetCurrentSelection()
+        prev_max_objects = rt.getLastMergedNodes()
         transform_data = object_transform_set(prev_max_objects)
         for prev_max_obj in prev_max_objects:
             if rt.isValidNode(prev_max_obj):  # noqa
@@ -77,9 +76,9 @@ class MaxSceneLoader(load.LoaderPlugin):
             max_obj.name = f"{namespace}:{obj_name}"
             if max_obj in node_list:
                 max_obj.pos = transform_data[
-                    f"{max_obj.name}.transform"] or max_obj.pos
+                    f"{max_obj.name}.transform"] or 0
                 max_obj.scale = transform_data[
-                    f"{max_obj.name}.scale"] or max_obj.scale
+                    f"{max_obj.name}.scale"] or 0
         lib.imprint(container["instance_node"], {
             "representation": str(representation["_id"])
         })
diff --git a/openpype/hosts/max/plugins/load/load_model_fbx.py b/openpype/hosts/max/plugins/load/load_model_fbx.py
index a8f6ea90d6..bea4d28fb7 100644
--- a/openpype/hosts/max/plugins/load/load_model_fbx.py
+++ b/openpype/hosts/max/plugins/load/load_model_fbx.py
@@ -73,9 +73,9 @@ class FbxModelLoader(load.LoaderPlugin):
             fbx_object.name = f"{namespace}:{fbx_object.name}"
             if fbx_object in node_list:
                 fbx_object.pos = transform_data[
-                    f"{fbx_object.name}.transform"] or fbx_object.pos
+                    f"{fbx_object.name}.transform"] or 0
                 fbx_object.scale = transform_data[
-                    f"{fbx_object.name}.scale"] or fbx_object.scale
+                    f"{fbx_object.name}.scale"] or 0
 
         with maintained_selection():
             rt.Select(node)
diff --git a/openpype/hosts/max/plugins/load/load_model_obj.py b/openpype/hosts/max/plugins/load/load_model_obj.py
index 421bd34e62..ca970fb9d7 100644
--- a/openpype/hosts/max/plugins/load/load_model_obj.py
+++ b/openpype/hosts/max/plugins/load/load_model_obj.py
@@ -68,9 +68,9 @@ class ObjLoader(load.LoaderPlugin):
             selection.name = f"{namespace}:{selection.name}"
             if selection in node_list:
                 selection.pos = transform_data[
-                    f"{selection.name}.transform"] or selection.pos
+                    f"{selection.name}.transform"] or 0
                 selection.scale = transform_data[
-                    f"{selection.name}.scale"] or selection.scale
+                    f"{selection.name}.scale"] or 0
         update_custom_attribute_data(node, selections)
         with maintained_selection():
             rt.Select(node)
diff --git a/openpype/hosts/max/plugins/load/load_model_usd.py b/openpype/hosts/max/plugins/load/load_model_usd.py
index 67d0e75259..6476f65a04 100644
--- a/openpype/hosts/max/plugins/load/load_model_usd.py
+++ b/openpype/hosts/max/plugins/load/load_model_usd.py
@@ -93,9 +93,9 @@ class ModelUSDLoader(load.LoaderPlugin):
             usd_objects.append(children)
             if children in node_list:
                 children.pos = transform_data[
-                    f"{children.name}.transform"] or children.pos
+                    f"{children.name}.transform"] or 0
                 children.scale = transform_data[
-                    f"{children.name}.scale"] or children.scale
+                    f"{children.name}.scale"] or 0
 
         asset.name = f"{namespace}:{asset.name}"
         usd_objects.append(asset)

From 70bab9fdb8e673350e76e2e7fc18e967b86c6e8e Mon Sep 17 00:00:00 2001
From: Kayla Man <moonyuet2008@hotmail.com>
Date: Wed, 13 Sep 2023 21:59:57 +0800
Subject: [PATCH 217/366] fixing the issue of duplciated contents during
 switching assets

---
 openpype/hosts/max/plugins/load/load_camera_fbx.py | 5 ++++-
 openpype/hosts/max/plugins/load/load_model_fbx.py  | 4 +++-
 openpype/hosts/max/plugins/load/load_model_obj.py  | 4 +++-
 openpype/hosts/max/plugins/load/load_model_usd.py  | 4 +++-
 4 files changed, 13 insertions(+), 4 deletions(-)

diff --git a/openpype/hosts/max/plugins/load/load_camera_fbx.py b/openpype/hosts/max/plugins/load/load_camera_fbx.py
index 156e8dcaf6..5e4623fe4c 100644
--- a/openpype/hosts/max/plugins/load/load_camera_fbx.py
+++ b/openpype/hosts/max/plugins/load/load_camera_fbx.py
@@ -73,7 +73,10 @@ class FbxLoader(load.LoaderPlugin):
         rt.FBXImporterSetParam("Preserveinstances", True)
         rt.ImportFile(
             path, rt.name("noPrompt"), using=rt.FBXIMP)
-        current_fbx_objects = rt.GetCurrentSelection()
+        current_fbx_objects = [sel for sel in rt.GetCurrentSelection()
+                               if sel != rt.Container
+                               and sel.name == node_name]
+
         update_custom_attribute_data(node, current_fbx_objects)
         for fbx_object in current_fbx_objects:
             fbx_object.name = f"{namespace}:{fbx_object.name}"
diff --git a/openpype/hosts/max/plugins/load/load_model_fbx.py b/openpype/hosts/max/plugins/load/load_model_fbx.py
index bea4d28fb7..9542eaa74e 100644
--- a/openpype/hosts/max/plugins/load/load_model_fbx.py
+++ b/openpype/hosts/max/plugins/load/load_model_fbx.py
@@ -56,7 +56,9 @@ class FbxModelLoader(load.LoaderPlugin):
 
         node_list = get_previous_loaded_object(node)
         rt.Select(node_list)
-        prev_fbx_objects = rt.GetCurrentSelection()
+        prev_fbx_objects = [sel for sel in rt.GetCurrentSelection()
+                            if sel != rt.Container
+                            and sel.name == node_name]
         transform_data = object_transform_set(prev_fbx_objects)
         for prev_fbx_obj in prev_fbx_objects:
             if rt.isValidNode(prev_fbx_obj):
diff --git a/openpype/hosts/max/plugins/load/load_model_obj.py b/openpype/hosts/max/plugins/load/load_model_obj.py
index ca970fb9d7..38ba5e3e8f 100644
--- a/openpype/hosts/max/plugins/load/load_model_obj.py
+++ b/openpype/hosts/max/plugins/load/load_model_obj.py
@@ -55,7 +55,9 @@ class ObjLoader(load.LoaderPlugin):
         namespace, _ = get_namespace(node_name)
         node_list = get_previous_loaded_object(node)
         rt.Select(node_list)
-        previous_objects = rt.GetCurrentSelection()
+        previous_objects = [sel for sel in rt.GetCurrentSelection()
+                            if sel != rt.Container
+                            and sel.name == node_name]
         transform_data = object_transform_set(previous_objects)
         for prev_obj in previous_objects:
             if rt.isValidNode(prev_obj):
diff --git a/openpype/hosts/max/plugins/load/load_model_usd.py b/openpype/hosts/max/plugins/load/load_model_usd.py
index 6476f65a04..cabcdaa6b5 100644
--- a/openpype/hosts/max/plugins/load/load_model_usd.py
+++ b/openpype/hosts/max/plugins/load/load_model_usd.py
@@ -71,7 +71,9 @@ class ModelUSDLoader(load.LoaderPlugin):
         namespace, name = get_namespace(node_name)
         node_list = get_previous_loaded_object(node)
         rt.Select(node_list)
-        prev_objects = rt.GetCurrentSelection()
+        prev_objects = [sel for sel in rt.GetCurrentSelection()
+                        if sel != rt.Container
+                        and sel.name == node_name]
         transform_data = object_transform_set(prev_objects)
         for n in prev_objects:
             rt.Delete(n)

From c53abb50f07c5e7e1df185425e034f744d2314a8 Mon Sep 17 00:00:00 2001
From: Kayla Man <moonyuet2008@hotmail.com>
Date: Wed, 13 Sep 2023 22:06:11 +0800
Subject: [PATCH 218/366] fixing the issue of duplciated contents during
 switching assets

---
 openpype/hosts/max/plugins/load/load_camera_fbx.py | 2 +-
 openpype/hosts/max/plugins/load/load_model_fbx.py  | 2 +-
 openpype/hosts/max/plugins/load/load_model_usd.py  | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/openpype/hosts/max/plugins/load/load_camera_fbx.py b/openpype/hosts/max/plugins/load/load_camera_fbx.py
index 5e4623fe4c..1f891e19b3 100644
--- a/openpype/hosts/max/plugins/load/load_camera_fbx.py
+++ b/openpype/hosts/max/plugins/load/load_camera_fbx.py
@@ -75,7 +75,7 @@ class FbxLoader(load.LoaderPlugin):
             path, rt.name("noPrompt"), using=rt.FBXIMP)
         current_fbx_objects = [sel for sel in rt.GetCurrentSelection()
                                if sel != rt.Container
-                               and sel.name == node_name]
+                               and sel.name != node_name]
 
         update_custom_attribute_data(node, current_fbx_objects)
         for fbx_object in current_fbx_objects:
diff --git a/openpype/hosts/max/plugins/load/load_model_fbx.py b/openpype/hosts/max/plugins/load/load_model_fbx.py
index 9542eaa74e..cdc5667d78 100644
--- a/openpype/hosts/max/plugins/load/load_model_fbx.py
+++ b/openpype/hosts/max/plugins/load/load_model_fbx.py
@@ -58,7 +58,7 @@ class FbxModelLoader(load.LoaderPlugin):
         rt.Select(node_list)
         prev_fbx_objects = [sel for sel in rt.GetCurrentSelection()
                             if sel != rt.Container
-                            and sel.name == node_name]
+                            and sel.name != node_name]
         transform_data = object_transform_set(prev_fbx_objects)
         for prev_fbx_obj in prev_fbx_objects:
             if rt.isValidNode(prev_fbx_obj):
diff --git a/openpype/hosts/max/plugins/load/load_model_usd.py b/openpype/hosts/max/plugins/load/load_model_usd.py
index cabcdaa6b5..38233cfd62 100644
--- a/openpype/hosts/max/plugins/load/load_model_usd.py
+++ b/openpype/hosts/max/plugins/load/load_model_usd.py
@@ -73,7 +73,7 @@ class ModelUSDLoader(load.LoaderPlugin):
         rt.Select(node_list)
         prev_objects = [sel for sel in rt.GetCurrentSelection()
                         if sel != rt.Container
-                        and sel.name == node_name]
+                        and sel.name != node_name]
         transform_data = object_transform_set(prev_objects)
         for n in prev_objects:
             rt.Delete(n)

From 54a62348d02585ea9b186df2cabafb0f2748f6d0 Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Wed, 13 Sep 2023 22:16:14 +0200
Subject: [PATCH 219/366] Remove unused functions from Fusion integration

---
 openpype/hosts/fusion/api/__init__.py         |  6 +-
 openpype/hosts/fusion/api/lib.py              | 74 -------------------
 openpype/hosts/fusion/api/pipeline.py         | 43 -----------
 .../tests/test_lib_restructuralization.py     |  2 -
 4 files changed, 3 insertions(+), 122 deletions(-)

diff --git a/openpype/hosts/fusion/api/__init__.py b/openpype/hosts/fusion/api/__init__.py
index dba55a98d9..aabc624016 100644
--- a/openpype/hosts/fusion/api/__init__.py
+++ b/openpype/hosts/fusion/api/__init__.py
@@ -3,9 +3,7 @@ from .pipeline import (
     ls,
 
     imprint_container,
-    parse_container,
-    list_instances,
-    remove_instance
+    parse_container
 )
 
 from .lib import (
@@ -22,6 +20,7 @@ from .menu import launch_openpype_menu
 
 __all__ = [
     # pipeline
+    "FusionHost",
     "ls",
 
     "imprint_container",
@@ -32,6 +31,7 @@ __all__ = [
     "update_frame_range",
     "set_asset_framerange",
     "get_current_comp",
+    "get_bmd_library",
     "comp_lock_and_undo_chunk",
 
     # menu
diff --git a/openpype/hosts/fusion/api/lib.py b/openpype/hosts/fusion/api/lib.py
index d96557571b..c4a1488606 100644
--- a/openpype/hosts/fusion/api/lib.py
+++ b/openpype/hosts/fusion/api/lib.py
@@ -181,80 +181,6 @@ def validate_comp_prefs(comp=None, force_repair=False):
         dialog.setStyleSheet(load_stylesheet())
 
 
-def switch_item(container,
-                asset_name=None,
-                subset_name=None,
-                representation_name=None):
-    """Switch container asset, subset or representation of a container by name.
-
-    It'll always switch to the latest version - of course a different
-    approach could be implemented.
-
-    Args:
-        container (dict): data of the item to switch with
-        asset_name (str): name of the asset
-        subset_name (str): name of the subset
-        representation_name (str): name of the representation
-
-    Returns:
-        dict
-
-    """
-
-    if all(not x for x in [asset_name, subset_name, representation_name]):
-        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.
-    project_name = get_current_project_name()
-    if any(not x for x in [asset_name, subset_name, representation_name]):
-        repre_id = container["representation"]
-        representation = get_representation_by_id(project_name, repre_id)
-        repre_parent_docs = get_representation_parents(
-            project_name, 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"]
-
-        if subset_name is None:
-            subset_name = subset["name"]
-
-        if representation_name is None:
-            representation_name = representation["name"]
-
-    # Find the new one
-    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 = 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 = 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 = 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)
-
-    switch_container(container, representation)
-
-    return representation
-
-
 @contextlib.contextmanager
 def maintained_selection(comp=None):
     """Reset comp selection from before the context after the context"""
diff --git a/openpype/hosts/fusion/api/pipeline.py b/openpype/hosts/fusion/api/pipeline.py
index a768a3f0f8..a886086758 100644
--- a/openpype/hosts/fusion/api/pipeline.py
+++ b/openpype/hosts/fusion/api/pipeline.py
@@ -287,49 +287,6 @@ def parse_container(tool):
     return container
 
 
-# TODO: Function below is currently unused prototypes
-def list_instances(creator_id=None):
-    """Return created instances in current workfile which will be published.
-    Returns:
-        (list) of dictionaries matching instances format
-    """
-
-    comp = get_current_comp()
-    tools = comp.GetToolList(False).values()
-
-    instance_signature = {
-        "id": "pyblish.avalon.instance",
-        "identifier": creator_id
-    }
-    instances = []
-    for tool in tools:
-
-        data = tool.GetData('openpype')
-        if not isinstance(data, dict):
-            continue
-
-        if data.get("id") != instance_signature["id"]:
-            continue
-
-        if creator_id and data.get("identifier") != creator_id:
-            continue
-
-        instances.append(tool)
-
-    return instances
-
-
-# TODO: Function below is currently unused prototypes
-def remove_instance(instance):
-    """Remove instance from current workfile.
-
-    Args:
-        instance (dict): instance representation from subsetmanager model
-    """
-    # Assume instance is a Fusion tool directly
-    instance["tool"].Delete()
-
-
 class FusionEventThread(QtCore.QThread):
     """QThread which will periodically ping Fusion app for any events.
     The fusion.UIManager must be set up to be notified of events before they'll
diff --git a/openpype/tests/test_lib_restructuralization.py b/openpype/tests/test_lib_restructuralization.py
index 669706d470..a91d65f7a8 100644
--- a/openpype/tests/test_lib_restructuralization.py
+++ b/openpype/tests/test_lib_restructuralization.py
@@ -18,8 +18,6 @@ def test_backward_compatibility(printer):
 
         from openpype.lib import get_ffprobe_streams
 
-        from openpype.hosts.fusion.lib import switch_item
-
         from openpype.lib import source_hash
         from openpype.lib import run_subprocess
 

From 5f2756b95ee0d06b1ac2748b736db93dc47a7f46 Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Wed, 13 Sep 2023 22:42:33 +0200
Subject: [PATCH 220/366] Skip view capture when Maya is in headless mode

Co-authored-by: Toke Jepsen <tokejepsen@gmail.com>
---
 .../plugins/publish/extract_active_view_thumbnail.py   | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/openpype/hosts/maya/plugins/publish/extract_active_view_thumbnail.py b/openpype/hosts/maya/plugins/publish/extract_active_view_thumbnail.py
index b4e62f8acc..71a0ba877b 100644
--- a/openpype/hosts/maya/plugins/publish/extract_active_view_thumbnail.py
+++ b/openpype/hosts/maya/plugins/publish/extract_active_view_thumbnail.py
@@ -4,6 +4,9 @@ import maya.api.OpenMayaUI as omui
 import pyblish.api
 import tempfile
 
+from openpype.hosts.maya.lib import IS_HEADLESS
+
+
 
 class ExtractActiveViewThumbnail(pyblish.api.InstancePlugin):
     """Set instance thumbnail to a screengrab of current active viewport.
@@ -19,6 +22,13 @@ class ExtractActiveViewThumbnail(pyblish.api.InstancePlugin):
     hosts = ["maya"]
 
     def process(self, instance):
+        if IS_HEADLESS:
+            self.log.debug(
+                "Skip extraction of active view thumbnail, due to being in"
+                "headless mode."
+            )
+            return
+
         thumbnail = instance.data.get("thumbnailPath")
         if not thumbnail:
             view_thumbnail = self.get_view_thumbnail(instance)

From ef843e25ca35b2e0ab6b0be47f214093131e9c7c Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Wed, 13 Sep 2023 23:01:58 +0200
Subject: [PATCH 221/366] Update
 openpype/hosts/maya/plugins/publish/extract_active_view_thumbnail.py

---
 .../hosts/maya/plugins/publish/extract_active_view_thumbnail.py  | 1 -
 1 file changed, 1 deletion(-)

diff --git a/openpype/hosts/maya/plugins/publish/extract_active_view_thumbnail.py b/openpype/hosts/maya/plugins/publish/extract_active_view_thumbnail.py
index 71a0ba877b..f47dd5e084 100644
--- a/openpype/hosts/maya/plugins/publish/extract_active_view_thumbnail.py
+++ b/openpype/hosts/maya/plugins/publish/extract_active_view_thumbnail.py
@@ -7,7 +7,6 @@ import tempfile
 from openpype.hosts.maya.lib import IS_HEADLESS
 
 
-
 class ExtractActiveViewThumbnail(pyblish.api.InstancePlugin):
     """Set instance thumbnail to a screengrab of current active viewport.
 

From dbd03c6c5a2b851ca6a8708cf6e290fd498e5192 Mon Sep 17 00:00:00 2001
From: Toke Stuart Jepsen <tokejepsen@gmail.com>
Date: Thu, 14 Sep 2023 08:38:51 +0100
Subject: [PATCH 222/366] Missing "data" field and enabling of audio

---
 openpype/hosts/maya/plugins/load/load_audio.py | 10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)

diff --git a/openpype/hosts/maya/plugins/load/load_audio.py b/openpype/hosts/maya/plugins/load/load_audio.py
index 265b15f4ae..eaaf81d873 100644
--- a/openpype/hosts/maya/plugins/load/load_audio.py
+++ b/openpype/hosts/maya/plugins/load/load_audio.py
@@ -61,6 +61,14 @@ class AudioLoader(load.LoaderPlugin):
 
         path = get_representation_path(representation)
         cmds.setAttr("{}.filename".format(audio_node), path, type="string")
+
+        cmds.timeControl(
+            mel.eval("$tmpVar=$gPlayBackSlider"),
+            edit=True,
+            sound=audio_node,
+            displaySound=True
+        )
+
         cmds.setAttr(
             container["objectName"] + ".representation",
             str(representation["_id"]),
@@ -76,7 +84,7 @@ class AudioLoader(load.LoaderPlugin):
             project_name, version["parent"], fields=["parent"]
         )
         asset = get_asset_by_id(
-            project_name, subset["parent"], fields=["parent"]
+            project_name, subset["parent"], fields=["parent", "data"]
         )
 
         source_start = 1 - asset["data"]["frameStart"]

From 559021b5f6d42d644ed0efde7ae09ccba2399c6f Mon Sep 17 00:00:00 2001
From: Kayla Man <moonyuet2008@hotmail.com>
Date: Thu, 14 Sep 2023 16:27:49 +0800
Subject: [PATCH 223/366] fix the bug of the 3dsmax OP data not being collected
 during switching version

---
 .../hosts/max/plugins/load/load_camera_fbx.py | 18 ++++++-------
 .../hosts/max/plugins/load/load_max_scene.py  | 25 ++++++++++++-------
 .../hosts/max/plugins/load/load_model_fbx.py  | 17 +++++++------
 .../hosts/max/plugins/load/load_model_obj.py  | 10 +++-----
 .../hosts/max/plugins/load/load_model_usd.py  |  6 ++---
 5 files changed, 39 insertions(+), 37 deletions(-)

diff --git a/openpype/hosts/max/plugins/load/load_camera_fbx.py b/openpype/hosts/max/plugins/load/load_camera_fbx.py
index 1f891e19b3..ce1427a980 100644
--- a/openpype/hosts/max/plugins/load/load_camera_fbx.py
+++ b/openpype/hosts/max/plugins/load/load_camera_fbx.py
@@ -73,22 +73,18 @@ class FbxLoader(load.LoaderPlugin):
         rt.FBXImporterSetParam("Preserveinstances", True)
         rt.ImportFile(
             path, rt.name("noPrompt"), using=rt.FBXIMP)
-        current_fbx_objects = [sel for sel in rt.GetCurrentSelection()
-                               if sel != rt.Container
-                               and sel.name != node_name]
-
-        update_custom_attribute_data(node, current_fbx_objects)
+        current_fbx_objects = rt.GetCurrentSelection()
+        fbx_objects = []
         for fbx_object in current_fbx_objects:
             fbx_object.name = f"{namespace}:{fbx_object.name}"
-            if fbx_object in node_list:
-                fbx_object.pos = transform_data[
-                    f"{fbx_object.name}.transform"] or 0
+            fbx_objects.append(fbx_object)
+            fbx_transform = f"{fbx_object.name}.transform"
+            if fbx_transform in transform_data.keys():
+                fbx_object.pos = transform_data[fbx_transform] or 0
                 fbx_object.scale = transform_data[
                     f"{fbx_object.name}.scale"] or 0
 
-        with maintained_selection():
-            rt.Select(node)
-
+        update_custom_attribute_data(node, fbx_objects)
         lib.imprint(container["instance_node"], {
             "representation": str(representation["_id"])
         })
diff --git a/openpype/hosts/max/plugins/load/load_max_scene.py b/openpype/hosts/max/plugins/load/load_max_scene.py
index b7ce5bfe39..4b66dbff6f 100644
--- a/openpype/hosts/max/plugins/load/load_max_scene.py
+++ b/openpype/hosts/max/plugins/load/load_max_scene.py
@@ -43,7 +43,6 @@ class MaxSceneLoader(load.LoaderPlugin):
         for max_obj, obj_name in zip(max_objects, max_object_names):
             max_obj.name = f"{namespace}:{obj_name}"
             max_container.append(rt.getNodeByName(max_obj.name))
-
         return containerise(
             name, max_container, context,
             namespace, loader=self.__class__.__name__)
@@ -53,32 +52,40 @@ class MaxSceneLoader(load.LoaderPlugin):
 
         path = get_representation_path(representation)
         node_name = container["instance_node"]
-
+        print(node_name)
         node = rt.getNodeByName(node_name)
         namespace, _ = get_namespace(node_name)
         # delete the old container with attribute
         # delete old duplicate
         # use the modifier OP data to delete the data
         node_list = get_previous_loaded_object(node)
-        prev_max_objects = rt.getLastMergedNodes()
+        rt.select(node_list)
+        prev_max_objects = rt.GetCurrentSelection()
+        print(f"{node_list}")
         transform_data = object_transform_set(prev_max_objects)
+
         for prev_max_obj in prev_max_objects:
             if rt.isValidNode(prev_max_obj):  # noqa
                 rt.Delete(prev_max_obj)
-        rt.MergeMaxFile(path, rt.Name("deleteOldDups"))
+        rt.MergeMaxFile(path, quiet=True)
 
         current_max_objects = rt.getLastMergedNodes()
+
         current_max_object_names = [obj.name for obj
                                     in current_max_objects]
-        update_custom_attribute_data(node, current_max_objects)
+
+        max_objects = []
         for max_obj, obj_name in zip(current_max_objects,
-                                     current_max_object_names):
+                                    current_max_object_names):
             max_obj.name = f"{namespace}:{obj_name}"
-            if max_obj in node_list:
-                max_obj.pos = transform_data[
-                    f"{max_obj.name}.transform"] or 0
+            max_objects.append(max_obj)
+            max_transform = f"{max_obj.name}.transform"
+            if max_transform in transform_data.keys():
+                max_obj.pos = transform_data[max_transform] or 0
                 max_obj.scale = transform_data[
                     f"{max_obj.name}.scale"] or 0
+
+        update_custom_attribute_data(node, max_objects)
         lib.imprint(container["instance_node"], {
             "representation": str(representation["_id"])
         })
diff --git a/openpype/hosts/max/plugins/load/load_model_fbx.py b/openpype/hosts/max/plugins/load/load_model_fbx.py
index cdc5667d78..71fc382eed 100644
--- a/openpype/hosts/max/plugins/load/load_model_fbx.py
+++ b/openpype/hosts/max/plugins/load/load_model_fbx.py
@@ -52,13 +52,13 @@ class FbxModelLoader(load.LoaderPlugin):
         path = get_representation_path(representation)
         node_name = container["instance_node"]
         node = rt.getNodeByName(node_name)
+        if not node:
+            rt.Container(name=node_name)
         namespace, _ = get_namespace(node_name)
 
         node_list = get_previous_loaded_object(node)
         rt.Select(node_list)
-        prev_fbx_objects = [sel for sel in rt.GetCurrentSelection()
-                            if sel != rt.Container
-                            and sel.name != node_name]
+        prev_fbx_objects = rt.GetCurrentSelection()
         transform_data = object_transform_set(prev_fbx_objects)
         for prev_fbx_obj in prev_fbx_objects:
             if rt.isValidNode(prev_fbx_obj):
@@ -70,18 +70,19 @@ class FbxModelLoader(load.LoaderPlugin):
         rt.FBXImporterSetParam("Preserveinstances", True)
         rt.importFile(path, rt.name("noPrompt"), using=rt.FBXIMP)
         current_fbx_objects = rt.GetCurrentSelection()
-        update_custom_attribute_data(node, current_fbx_objects)
+        fbx_objects = []
         for fbx_object in current_fbx_objects:
             fbx_object.name = f"{namespace}:{fbx_object.name}"
-            if fbx_object in node_list:
-                fbx_object.pos = transform_data[
-                    f"{fbx_object.name}.transform"] or 0
+            fbx_objects.append(fbx_object)
+            fbx_transform = f"{fbx_object.name}.transform"
+            if fbx_transform in transform_data.keys():
+                fbx_object.pos = transform_data[fbx_transform] or 0
                 fbx_object.scale = transform_data[
                     f"{fbx_object.name}.scale"] or 0
 
         with maintained_selection():
             rt.Select(node)
-
+        update_custom_attribute_data(node, fbx_objects)
         lib.imprint(container["instance_node"], {
             "representation": str(representation["_id"])
         })
diff --git a/openpype/hosts/max/plugins/load/load_model_obj.py b/openpype/hosts/max/plugins/load/load_model_obj.py
index 38ba5e3e8f..aedb288a2d 100644
--- a/openpype/hosts/max/plugins/load/load_model_obj.py
+++ b/openpype/hosts/max/plugins/load/load_model_obj.py
@@ -55,9 +55,7 @@ class ObjLoader(load.LoaderPlugin):
         namespace, _ = get_namespace(node_name)
         node_list = get_previous_loaded_object(node)
         rt.Select(node_list)
-        previous_objects = [sel for sel in rt.GetCurrentSelection()
-                            if sel != rt.Container
-                            and sel.name == node_name]
+        previous_objects = rt.GetCurrentSelection()
         transform_data = object_transform_set(previous_objects)
         for prev_obj in previous_objects:
             if rt.isValidNode(prev_obj):
@@ -68,9 +66,9 @@ class ObjLoader(load.LoaderPlugin):
         selections = rt.GetCurrentSelection()
         for selection in selections:
             selection.name = f"{namespace}:{selection.name}"
-            if selection in node_list:
-                selection.pos = transform_data[
-                    f"{selection.name}.transform"] or 0
+            selection_transform = f"{selection.name}.transform"
+            if selection_transform in transform_data.keys():
+                selection.pos = transform_data[selection_transform] or 0
                 selection.scale = transform_data[
                     f"{selection.name}.scale"] or 0
         update_custom_attribute_data(node, selections)
diff --git a/openpype/hosts/max/plugins/load/load_model_usd.py b/openpype/hosts/max/plugins/load/load_model_usd.py
index 38233cfd62..bce4bd4a9a 100644
--- a/openpype/hosts/max/plugins/load/load_model_usd.py
+++ b/openpype/hosts/max/plugins/load/load_model_usd.py
@@ -93,9 +93,9 @@ class ModelUSDLoader(load.LoaderPlugin):
         for children in asset.Children:
             children.name = f"{namespace}:{children.name}"
             usd_objects.append(children)
-            if children in node_list:
-                children.pos = transform_data[
-                    f"{children.name}.transform"] or 0
+            children_transform = f"{children.name}.transform"
+            if children_transform in transform_data.keys():
+                children.pos = transform_data[children_transform] or 0
                 children.scale = transform_data[
                     f"{children.name}.scale"] or 0
 

From cad715ad0182cbfaa2093b7217723170af293887 Mon Sep 17 00:00:00 2001
From: Kayla Man <moonyuet2008@hotmail.com>
Date: Thu, 14 Sep 2023 16:32:04 +0800
Subject: [PATCH 224/366] remove print & hound

---
 openpype/hosts/max/plugins/load/load_max_scene.py | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/openpype/hosts/max/plugins/load/load_max_scene.py b/openpype/hosts/max/plugins/load/load_max_scene.py
index 4b66dbff6f..0b5f0a2858 100644
--- a/openpype/hosts/max/plugins/load/load_max_scene.py
+++ b/openpype/hosts/max/plugins/load/load_max_scene.py
@@ -52,7 +52,6 @@ class MaxSceneLoader(load.LoaderPlugin):
 
         path = get_representation_path(representation)
         node_name = container["instance_node"]
-        print(node_name)
         node = rt.getNodeByName(node_name)
         namespace, _ = get_namespace(node_name)
         # delete the old container with attribute
@@ -61,7 +60,6 @@ class MaxSceneLoader(load.LoaderPlugin):
         node_list = get_previous_loaded_object(node)
         rt.select(node_list)
         prev_max_objects = rt.GetCurrentSelection()
-        print(f"{node_list}")
         transform_data = object_transform_set(prev_max_objects)
 
         for prev_max_obj in prev_max_objects:
@@ -76,7 +74,7 @@ class MaxSceneLoader(load.LoaderPlugin):
 
         max_objects = []
         for max_obj, obj_name in zip(current_max_objects,
-                                    current_max_object_names):
+                                     current_max_object_names):
             max_obj.name = f"{namespace}:{obj_name}"
             max_objects.append(max_obj)
             max_transform = f"{max_obj.name}.transform"

From 5e20dd3f9cb553c053f35baf0fb321e6b46a3f43 Mon Sep 17 00:00:00 2001
From: Toke Jepsen <tokejepsen@gmail.com>
Date: Thu, 14 Sep 2023 09:54:32 +0100
Subject: [PATCH 225/366] Update
 openpype/hosts/maya/plugins/publish/extract_active_view_thumbnail.py

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

diff --git a/openpype/hosts/maya/plugins/publish/extract_active_view_thumbnail.py b/openpype/hosts/maya/plugins/publish/extract_active_view_thumbnail.py
index f47dd5e084..483ae6d9d3 100644
--- a/openpype/hosts/maya/plugins/publish/extract_active_view_thumbnail.py
+++ b/openpype/hosts/maya/plugins/publish/extract_active_view_thumbnail.py
@@ -4,7 +4,7 @@ import maya.api.OpenMayaUI as omui
 import pyblish.api
 import tempfile
 
-from openpype.hosts.maya.lib import IS_HEADLESS
+from openpype.hosts.maya.api.lib import IS_HEADLESS
 
 
 class ExtractActiveViewThumbnail(pyblish.api.InstancePlugin):

From cdc6366662b00a3e0f413cdba8e1eb1784f10e28 Mon Sep 17 00:00:00 2001
From: Kayla Man <moonyuet2008@hotmail.com>
Date: Thu, 14 Sep 2023 17:42:35 +0800
Subject: [PATCH 226/366] update the OP data after the merge of #5424

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

diff --git a/openpype/hosts/max/plugins/load/load_pointcache_ornatrix.py b/openpype/hosts/max/plugins/load/load_pointcache_ornatrix.py
index f8aadb53c0..0f32b7938f 100644
--- a/openpype/hosts/max/plugins/load/load_pointcache_ornatrix.py
+++ b/openpype/hosts/max/plugins/load/load_pointcache_ornatrix.py
@@ -50,19 +50,13 @@ class OxAbcLoader(load.LoaderPlugin):
             name + "_",
             suffix="_",
         )
-
-        abc_container = rt.Container()
+        abc_container =[]
         for abc in scene_object:
-            abc.Parent = abc_container
             abc.name = f"{namespace}:{abc.name}"
-        # rename the abc container with namespace
-        abc_container_name = f"{namespace}:{name}_{self.postfix}"
-        abc_container.name = abc_container_name
-        import_custom_attribute_data(
-            abc_container, abc_container.Children)
+            abc_container.append(abc)
 
         return containerise(
-            name, [abc_container], context,
+            name, abc_container, context,
             namespace, loader=self.__class__.__name__
         )
 
@@ -89,14 +83,17 @@ class OxAbcLoader(load.LoaderPlugin):
             obj_type = rt.ClassOf(obj)
             if str(obj_type).startswith("Ox_"):
                 scene_object.append(obj)
-        update_custom_attribute_data(
-            inst_container, scene_object.Children)
+        ox_abc_objects = []
         for abc in scene_object:
             abc.Parent = container
             abc.name = f"{namespace}:{abc.name}"
-            abc.pos = transform_data[f"{abc.name}.transform"]
-            abc.scale = transform_data[f"{abc.name}.scale"]
-
+            ox_abc_objects.append(abc)
+            ox_transform = f"{abc.name}.transform"
+            if ox_transform in transform_data.keys():
+                abc.pos = transform_data[ox_transform] or 0
+                abc.scale = transform_data[f"{abc.name}.scale"] or 0
+        update_custom_attribute_data(
+            inst_container, ox_abc_objects)
         lib.imprint(
             container["instance_node"],
             {"representation": str(representation["_id"])},

From 2bd4d295afda0e5f64434e6119d802180f4ca618 Mon Sep 17 00:00:00 2001
From: Kayla Man <moonyuet2008@hotmail.com>
Date: Thu, 14 Sep 2023 17:46:32 +0800
Subject: [PATCH 227/366] update the Data & hound

---
 .../plugins/load/load_pointcache_ornatrix.py   | 18 +++++++++---------
 1 file changed, 9 insertions(+), 9 deletions(-)

diff --git a/openpype/hosts/max/plugins/load/load_pointcache_ornatrix.py b/openpype/hosts/max/plugins/load/load_pointcache_ornatrix.py
index 0f32b7938f..cbd15ae6b8 100644
--- a/openpype/hosts/max/plugins/load/load_pointcache_ornatrix.py
+++ b/openpype/hosts/max/plugins/load/load_pointcache_ornatrix.py
@@ -3,7 +3,7 @@ from openpype.pipeline import load, get_representation_path
 from openpype.pipeline.load import LoadError
 from openpype.hosts.max.api.pipeline import (
     containerise,
-    import_custom_attribute_data,
+    get_previous_loaded_object,
     update_custom_attribute_data
 )
 
@@ -50,7 +50,7 @@ class OxAbcLoader(load.LoaderPlugin):
             name + "_",
             suffix="_",
         )
-        abc_container =[]
+        abc_container = []
         for abc in scene_object:
             abc.name = f"{namespace}:{abc.name}"
             abc_container.append(abc)
@@ -64,11 +64,12 @@ class OxAbcLoader(load.LoaderPlugin):
         path = get_representation_path(representation)
         node_name = container["instance_node"]
         namespace, name = get_namespace(node_name)
-        sub_node_name = f"{namespace}:{name}_{self.postfix}"
-        inst_container = rt.getNodeByName(sub_node_name)
-        rt.Select(inst_container.Children)
-        transform_data = object_transform_set(inst_container.Children)
-        for prev_obj in rt.selection:
+        node = rt.getNodeByName(node_name)
+        node_list = get_previous_loaded_object(node)
+        rt.Select(node_list)
+        selections = rt.getCurrentSelection()
+        transform_data = object_transform_set(selections)
+        for prev_obj in selections:
             if rt.isValidNode(prev_obj):
                 rt.Delete(prev_obj)
 
@@ -92,8 +93,7 @@ class OxAbcLoader(load.LoaderPlugin):
             if ox_transform in transform_data.keys():
                 abc.pos = transform_data[ox_transform] or 0
                 abc.scale = transform_data[f"{abc.name}.scale"] or 0
-        update_custom_attribute_data(
-            inst_container, ox_abc_objects)
+        update_custom_attribute_data(node, ox_abc_objects)
         lib.imprint(
             container["instance_node"],
             {"representation": str(representation["_id"])},

From 963f3f42ff287742e6aa2004292dc513464bcaa8 Mon Sep 17 00:00:00 2001
From: Kayla Man <moonyuet2008@hotmail.com>
Date: Thu, 14 Sep 2023 17:48:18 +0800
Subject: [PATCH 228/366] use the get_plugins function from max.api.lib

---
 .../max/plugins/load/load_pointcache_ornatrix.py  | 15 ++-------------
 1 file changed, 2 insertions(+), 13 deletions(-)

diff --git a/openpype/hosts/max/plugins/load/load_pointcache_ornatrix.py b/openpype/hosts/max/plugins/load/load_pointcache_ornatrix.py
index cbd15ae6b8..96060a6a6f 100644
--- a/openpype/hosts/max/plugins/load/load_pointcache_ornatrix.py
+++ b/openpype/hosts/max/plugins/load/load_pointcache_ornatrix.py
@@ -10,7 +10,8 @@ from openpype.hosts.max.api.pipeline import (
 from openpype.hosts.max.api.lib import (
     unique_namespace,
     get_namespace,
-    object_transform_set
+    object_transform_set,
+    get_plugins
 )
 from openpype.hosts.max.api import lib
 from pymxs import runtime as rt
@@ -105,15 +106,3 @@ class OxAbcLoader(load.LoaderPlugin):
     def remove(self, container):
         node = rt.GetNodeByName(container["instance_node"])
         rt.Delete(node)
-
-
-def get_plugins() -> list:
-    """Get plugin list from 3ds max."""
-    manager = rt.PluginManager
-    count = manager.pluginDllCount
-    plugin_info_list = []
-    for p in range(1, count + 1):
-        plugin_info = manager.pluginDllName(p)
-        plugin_info_list.append(plugin_info)
-
-    return plugin_info_list

From 4d22b6cf4b31465833bc239b16e46ec2b1d1f942 Mon Sep 17 00:00:00 2001
From: Toke Jepsen <tokejepsen@gmail.com>
Date: Thu, 14 Sep 2023 11:53:06 +0100
Subject: [PATCH 229/366] Update openpype/hosts/maya/plugins/load/load_audio.py

Co-authored-by: Roy Nieterau <roy_nieterau@hotmail.com>
---
 openpype/hosts/maya/plugins/load/load_audio.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/hosts/maya/plugins/load/load_audio.py b/openpype/hosts/maya/plugins/load/load_audio.py
index eaaf81d873..7114d92daa 100644
--- a/openpype/hosts/maya/plugins/load/load_audio.py
+++ b/openpype/hosts/maya/plugins/load/load_audio.py
@@ -84,7 +84,7 @@ class AudioLoader(load.LoaderPlugin):
             project_name, version["parent"], fields=["parent"]
         )
         asset = get_asset_by_id(
-            project_name, subset["parent"], fields=["parent", "data"]
+            project_name, subset["parent"], fields=["parent", "data.frameStart", "data.frameEnd"]
         )
 
         source_start = 1 - asset["data"]["frameStart"]

From a029031b58cd95663e018d3e8dd38a23e8475cdb Mon Sep 17 00:00:00 2001
From: Toke Jepsen <tokejepsen@gmail.com>
Date: Thu, 14 Sep 2023 11:53:53 +0100
Subject: [PATCH 230/366] Update openpype/hosts/maya/plugins/load/load_audio.py

---
 openpype/hosts/maya/plugins/load/load_audio.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/openpype/hosts/maya/plugins/load/load_audio.py b/openpype/hosts/maya/plugins/load/load_audio.py
index 7114d92daa..9c2fdfb6d3 100644
--- a/openpype/hosts/maya/plugins/load/load_audio.py
+++ b/openpype/hosts/maya/plugins/load/load_audio.py
@@ -84,7 +84,8 @@ class AudioLoader(load.LoaderPlugin):
             project_name, version["parent"], fields=["parent"]
         )
         asset = get_asset_by_id(
-            project_name, subset["parent"], fields=["parent", "data.frameStart", "data.frameEnd"]
+            project_name, subset["parent"],
+            fields=["parent", "data.frameStart", "data.frameEnd"]
         )
 
         source_start = 1 - asset["data"]["frameStart"]

From 887127828887d0642d1e77c2f92b7f3a441135a7 Mon Sep 17 00:00:00 2001
From: Toke Jepsen <tokejepsen@gmail.com>
Date: Thu, 14 Sep 2023 11:54:14 +0100
Subject: [PATCH 231/366] Update openpype/hosts/maya/plugins/load/load_audio.py

---
 openpype/hosts/maya/plugins/load/load_audio.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/openpype/hosts/maya/plugins/load/load_audio.py b/openpype/hosts/maya/plugins/load/load_audio.py
index 9c2fdfb6d3..17c7d442ae 100644
--- a/openpype/hosts/maya/plugins/load/load_audio.py
+++ b/openpype/hosts/maya/plugins/load/load_audio.py
@@ -84,7 +84,8 @@ class AudioLoader(load.LoaderPlugin):
             project_name, version["parent"], fields=["parent"]
         )
         asset = get_asset_by_id(
-            project_name, subset["parent"],
+            project_name,
+            subset["parent"],
             fields=["parent", "data.frameStart", "data.frameEnd"]
         )
 

From 3903071f21f2d2e7ec426d287fe1713c8cf7122b Mon Sep 17 00:00:00 2001
From: Toke Stuart Jepsen <tokejepsen@gmail.com>
Date: Thu, 14 Sep 2023 11:55:50 +0100
Subject: [PATCH 232/366] Check current sound on timeline

---
 .../hosts/maya/plugins/load/load_audio.py     | 20 +++++++++++++------
 1 file changed, 14 insertions(+), 6 deletions(-)

diff --git a/openpype/hosts/maya/plugins/load/load_audio.py b/openpype/hosts/maya/plugins/load/load_audio.py
index 17c7d442ae..6e2f2e89bc 100644
--- a/openpype/hosts/maya/plugins/load/load_audio.py
+++ b/openpype/hosts/maya/plugins/load/load_audio.py
@@ -59,15 +59,23 @@ class AudioLoader(load.LoaderPlugin):
         assert audio_nodes is not None, "Audio node not found."
         audio_node = audio_nodes[0]
 
+        current_sound = cmds.timeControl(
+            mel.eval("$tmpVar=$gPlayBackSlider"),
+            query=True,
+            sound=True
+        )
+        activate_sound = current_sound == audio_node
+
         path = get_representation_path(representation)
         cmds.setAttr("{}.filename".format(audio_node), path, type="string")
 
-        cmds.timeControl(
-            mel.eval("$tmpVar=$gPlayBackSlider"),
-            edit=True,
-            sound=audio_node,
-            displaySound=True
-        )
+        if activate_sound:
+            cmds.timeControl(
+                mel.eval("$tmpVar=$gPlayBackSlider"),
+                edit=True,
+                sound=audio_node,
+                displaySound=True
+            )
 
         cmds.setAttr(
             container["objectName"] + ".representation",

From 93fb76f359c1d511eb491667a771088e02bb5131 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <43494761+iLLiCiTiT@users.noreply.github.com>
Date: Thu, 14 Sep 2023 13:55:25 +0200
Subject: [PATCH 233/366] Extract Review: Multilayer specification for ffmpeg
 (#5613)

* added function to extract more information about channels

* specify layer name which should be used for ffmpeg

* changed 'get_channels_info_by_layer_name' to 'get_review_info_by_layer_name'

* modify docstring

* fix dosctring again
---
 openpype/lib/transcoding.py                | 168 ++++++++++++++++-----
 openpype/plugins/publish/extract_review.py |  32 +++-
 2 files changed, 160 insertions(+), 40 deletions(-)

diff --git a/openpype/lib/transcoding.py b/openpype/lib/transcoding.py
index 6e323f55c1..97c8dd41ab 100644
--- a/openpype/lib/transcoding.py
+++ b/openpype/lib/transcoding.py
@@ -315,6 +315,92 @@ def parse_oiio_xml_output(xml_string, logger=None):
     return output
 
 
+def get_review_info_by_layer_name(channel_names):
+    """Get channels info grouped by layer name.
+
+    Finds all layers in channel names and returns list of dictionaries with
+    information about channels in layer.
+    Example output (not real world example):
+        [
+            {
+                "name": "Main",
+                "review_channels": {
+                    "R": "Main.red",
+                    "G": "Main.green",
+                    "B": "Main.blue",
+                    "A": None,
+                }
+            },
+            {
+                "name": "Composed",
+                "review_channels": {
+                    "R": "Composed.R",
+                    "G": "Composed.G",
+                    "B": "Composed.B",
+                    "A": "Composed.A",
+                }
+            },
+            ...
+        ]
+
+    Args:
+        channel_names (list[str]): List of channel names.
+
+    Returns:
+        list[dict]: List of channels information.
+    """
+
+    layer_names_order = []
+    rgba_by_layer_name = collections.defaultdict(dict)
+    channels_by_layer_name = collections.defaultdict(dict)
+
+    for channel_name in channel_names:
+        layer_name = ""
+        last_part = channel_name
+        if "." in channel_name:
+            layer_name, last_part = channel_name.rsplit(".", 1)
+
+        channels_by_layer_name[layer_name][channel_name] = last_part
+        if last_part.lower() not in {
+            "r", "red",
+            "g", "green",
+            "b", "blue",
+            "a", "alpha"
+        }:
+            continue
+
+        if layer_name not in layer_names_order:
+            layer_names_order.append(layer_name)
+        # R, G, B or A
+        channel = last_part[0].upper()
+        rgba_by_layer_name[layer_name][channel] = channel_name
+
+    # Put empty layer to the beginning of the list
+    # - if input has R, G, B, A channels they should be used for review
+    if "" in layer_names_order:
+        layer_names_order.remove("")
+        layer_names_order.insert(0, "")
+
+    output = []
+    for layer_name in layer_names_order:
+        rgba_layer_info = rgba_by_layer_name[layer_name]
+        red = rgba_layer_info.get("R")
+        green = rgba_layer_info.get("G")
+        blue = rgba_layer_info.get("B")
+        if not red or not green or not blue:
+            continue
+        output.append({
+            "name": layer_name,
+            "review_channels": {
+                "R": red,
+                "G": green,
+                "B": blue,
+                "A": rgba_layer_info.get("A"),
+            }
+        })
+    return output
+
+
 def get_convert_rgb_channels(channel_names):
     """Get first available RGB(A) group from channels info.
 
@@ -323,7 +409,7 @@ def get_convert_rgb_channels(channel_names):
     # Ideal situation
     channels_info: [
         "R", "G", "B", "A"
-    }
+    ]
     ```
     Result will be `("R", "G", "B", "A")`
 
@@ -331,50 +417,60 @@ def get_convert_rgb_channels(channel_names):
     # Not ideal situation
     channels_info: [
         "beauty.red",
-        "beuaty.green",
+        "beauty.green",
         "beauty.blue",
         "depth.Z"
     ]
     ```
     Result will be `("beauty.red", "beauty.green", "beauty.blue", None)`
 
+    Args:
+        channel_names (list[str]): List of channel names.
+
     Returns:
-        NoneType: There is not channel combination that matches RGB
-            combination.
-        tuple: Tuple of 4 channel names defying channel names for R, G, B, A
-            where A can be None.
+        Union[NoneType, tuple[str, str, str, Union[str, None]]]: Tuple of
+            4 channel names defying channel names for R, G, B, A or None
+            if there is not any layer with RGB combination.
     """
-    rgb_by_main_name = collections.defaultdict(dict)
-    main_name_order = [""]
-    for channel_name in channel_names:
-        name_parts = channel_name.split(".")
-        rgb_part = name_parts.pop(-1).lower()
-        main_name = ".".join(name_parts)
-        if rgb_part in ("r", "red"):
-            rgb_by_main_name[main_name]["R"] = channel_name
-        elif rgb_part in ("g", "green"):
-            rgb_by_main_name[main_name]["G"] = channel_name
-        elif rgb_part in ("b", "blue"):
-            rgb_by_main_name[main_name]["B"] = channel_name
-        elif rgb_part in ("a", "alpha"):
-            rgb_by_main_name[main_name]["A"] = channel_name
-        else:
-            continue
-        if main_name not in main_name_order:
-            main_name_order.append(main_name)
 
-    output = None
-    for main_name in main_name_order:
-        colors = rgb_by_main_name.get(main_name) or {}
-        red = colors.get("R")
-        green = colors.get("G")
-        blue = colors.get("B")
-        alpha = colors.get("A")
-        if red is not None and green is not None and blue is not None:
-            output = (red, green, blue, alpha)
-            break
+    channels_info = get_review_info_by_layer_name(channel_names)
+    for item in channels_info:
+        review_channels = item["review_channels"]
+        return (
+            review_channels["R"],
+            review_channels["G"],
+            review_channels["B"],
+            review_channels["A"]
+        )
+    return None
 
-    return output
+
+def get_review_layer_name(src_filepath):
+    """Find layer name that could be used for review.
+
+    Args:
+        src_filepath (str): Path to input file.
+
+    Returns:
+        Union[str, None]: Layer name of None.
+    """
+
+    ext = os.path.splitext(src_filepath)[-1].lower()
+    if ext != ".exr":
+        return None
+
+    # Load info about file from oiio tool
+    input_info = get_oiio_info_for_input(src_filepath)
+    if not input_info:
+        return None
+
+    channel_names = input_info["channelnames"]
+    channels_info = get_review_info_by_layer_name(channel_names)
+    for item in channels_info:
+        # Layer name can be '', when review channels are 'R', 'G', 'B'
+        #   without layer
+        return item["name"] or None
+    return None
 
 
 def should_convert_for_ffmpeg(src_filepath):
@@ -395,7 +491,7 @@ def should_convert_for_ffmpeg(src_filepath):
     if not is_oiio_supported():
         return None
 
-    # Load info about info from oiio tool
+    # Load info about file from oiio tool
     input_info = get_oiio_info_for_input(src_filepath)
     if not input_info:
         return None
diff --git a/openpype/plugins/publish/extract_review.py b/openpype/plugins/publish/extract_review.py
index 9cc456872e..0ae941511c 100644
--- a/openpype/plugins/publish/extract_review.py
+++ b/openpype/plugins/publish/extract_review.py
@@ -21,6 +21,7 @@ from openpype.lib.transcoding import (
     IMAGE_EXTENSIONS,
     get_ffprobe_streams,
     should_convert_for_ffmpeg,
+    get_review_layer_name,
     convert_input_paths_for_ffmpeg,
     get_transcode_temp_directory,
 )
@@ -266,6 +267,8 @@ class ExtractReview(pyblish.api.InstancePlugin):
                 ))
                 continue
 
+            layer_name = get_review_layer_name(first_input_path)
+
             # Do conversion if needed
             #   - change staging dir of source representation
             #   - must be set back after output definitions processing
@@ -284,7 +287,8 @@ class ExtractReview(pyblish.api.InstancePlugin):
                     instance,
                     repre,
                     src_repre_staging_dir,
-                    filtered_output_defs
+                    filtered_output_defs,
+                    layer_name
                 )
 
             finally:
@@ -298,7 +302,12 @@ class ExtractReview(pyblish.api.InstancePlugin):
                         shutil.rmtree(new_staging_dir)
 
     def _render_output_definitions(
-        self, instance, repre, src_repre_staging_dir, output_definitions
+        self,
+        instance,
+        repre,
+        src_repre_staging_dir,
+        output_definitions,
+        layer_name
     ):
         fill_data = copy.deepcopy(instance.data["anatomyData"])
         for _output_def in output_definitions:
@@ -370,7 +379,12 @@ class ExtractReview(pyblish.api.InstancePlugin):
 
             try:  # temporary until oiiotool is supported cross platform
                 ffmpeg_args = self._ffmpeg_arguments(
-                    output_def, instance, new_repre, temp_data, fill_data
+                    output_def,
+                    instance,
+                    new_repre,
+                    temp_data,
+                    fill_data,
+                    layer_name,
                 )
             except ZeroDivisionError:
                 # TODO recalculate width and height using OIIO before
@@ -531,7 +545,13 @@ class ExtractReview(pyblish.api.InstancePlugin):
         }
 
     def _ffmpeg_arguments(
-        self, output_def, instance, new_repre, temp_data, fill_data
+        self,
+        output_def,
+        instance,
+        new_repre,
+        temp_data,
+        fill_data,
+        layer_name
     ):
         """Prepares ffmpeg arguments for expected extraction.
 
@@ -599,6 +619,10 @@ class ExtractReview(pyblish.api.InstancePlugin):
 
         duration_seconds = float(output_frames_len / temp_data["fps"])
 
+        # Define which layer should be used
+        if layer_name:
+            ffmpeg_input_args.extend(["-layer", layer_name])
+
         if temp_data["input_is_sequence"]:
             # Set start frame of input sequence (just frame in filename)
             # - definition of input filepath

From 39dad459d588486a5711cecf79419c24d99524ed Mon Sep 17 00:00:00 2001
From: Toke Jepsen <tokejepsen@gmail.com>
Date: Thu, 14 Sep 2023 15:16:28 +0100
Subject: [PATCH 234/366] Update openpype/hosts/maya/plugins/load/load_audio.py

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

diff --git a/openpype/hosts/maya/plugins/load/load_audio.py b/openpype/hosts/maya/plugins/load/load_audio.py
index 6e2f2e89bc..fedb985e0b 100644
--- a/openpype/hosts/maya/plugins/load/load_audio.py
+++ b/openpype/hosts/maya/plugins/load/load_audio.py
@@ -60,7 +60,7 @@ class AudioLoader(load.LoaderPlugin):
         audio_node = audio_nodes[0]
 
         current_sound = cmds.timeControl(
-            mel.eval("$tmpVar=$gPlayBackSlider"),
+            mel.eval("$gPlayBackSlider=$gPlayBackSlider"),
             query=True,
             sound=True
         )

From 2c2aef60de3b9e66e3efb79cf2d01578dcf829df Mon Sep 17 00:00:00 2001
From: Toke Jepsen <tokejepsen@gmail.com>
Date: Thu, 14 Sep 2023 15:16:52 +0100
Subject: [PATCH 235/366] Update openpype/hosts/maya/plugins/load/load_audio.py

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

diff --git a/openpype/hosts/maya/plugins/load/load_audio.py b/openpype/hosts/maya/plugins/load/load_audio.py
index fedb985e0b..7750d41e97 100644
--- a/openpype/hosts/maya/plugins/load/load_audio.py
+++ b/openpype/hosts/maya/plugins/load/load_audio.py
@@ -71,7 +71,7 @@ class AudioLoader(load.LoaderPlugin):
 
         if activate_sound:
             cmds.timeControl(
-                mel.eval("$tmpVar=$gPlayBackSlider"),
+                mel.eval("$gPlayBackSlider=$gPlayBackSlider"),
                 edit=True,
                 sound=audio_node,
                 displaySound=True

From a4b1797b2abc2869d15f343f8f00894783fa5270 Mon Sep 17 00:00:00 2001
From: Toke Stuart Jepsen <tokejepsen@gmail.com>
Date: Thu, 14 Sep 2023 15:18:13 +0100
Subject: [PATCH 236/366] tmpVar > gPlayBackSlider

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

diff --git a/openpype/hosts/maya/plugins/load/load_audio.py b/openpype/hosts/maya/plugins/load/load_audio.py
index 7750d41e97..d3a670398b 100644
--- a/openpype/hosts/maya/plugins/load/load_audio.py
+++ b/openpype/hosts/maya/plugins/load/load_audio.py
@@ -30,7 +30,7 @@ class AudioLoader(load.LoaderPlugin):
             file=context["representation"]["data"]["path"], offset=start_frame
         )
         cmds.timeControl(
-            mel.eval("$tmpVar=$gPlayBackSlider"),
+            mel.eval("$gPlayBackSlider=$gPlayBackSlider"),
             edit=True,
             sound=sound_node,
             displaySound=True

From 2c2b5a35057ed10d060f5fc645b9ed53f5e5560c Mon Sep 17 00:00:00 2001
From: Toke Jepsen <tokejepsen@gmail.com>
Date: Thu, 14 Sep 2023 15:39:00 +0100
Subject: [PATCH 237/366] Update openpype/hosts/maya/plugins/load/load_audio.py

Co-authored-by: Roy Nieterau <roy_nieterau@hotmail.com>
---
 openpype/hosts/maya/plugins/load/load_audio.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/openpype/hosts/maya/plugins/load/load_audio.py b/openpype/hosts/maya/plugins/load/load_audio.py
index d3a670398b..2da5a6f1c2 100644
--- a/openpype/hosts/maya/plugins/load/load_audio.py
+++ b/openpype/hosts/maya/plugins/load/load_audio.py
@@ -70,6 +70,7 @@ class AudioLoader(load.LoaderPlugin):
         cmds.setAttr("{}.filename".format(audio_node), path, type="string")
 
         if activate_sound:
+            # maya by default deactivates it from timeline on file change
             cmds.timeControl(
                 mel.eval("$gPlayBackSlider=$gPlayBackSlider"),
                 edit=True,

From 8729cf023c3138e5c69b32dac21eb6def73c41fc Mon Sep 17 00:00:00 2001
From: Jakub Trllo <43494761+iLLiCiTiT@users.noreply.github.com>
Date: Thu, 14 Sep 2023 18:57:23 +0200
Subject: [PATCH 238/366] Publisher: Fix screenshot widget (#5615)

* fix called super method name

* remove fade animation

* use paths to draw background

* use same opacity for lines

* add render hints

* minor cleanup
---
 .../publisher/widgets/screenshot_widget.py    | 44 +++++++------------
 1 file changed, 17 insertions(+), 27 deletions(-)

diff --git a/openpype/tools/publisher/widgets/screenshot_widget.py b/openpype/tools/publisher/widgets/screenshot_widget.py
index 64cccece6c..3504b419b4 100644
--- a/openpype/tools/publisher/widgets/screenshot_widget.py
+++ b/openpype/tools/publisher/widgets/screenshot_widget.py
@@ -26,14 +26,6 @@ class ScreenMarquee(QtWidgets.QDialog):
         self.setCursor(QtCore.Qt.CrossCursor)
         self.setMouseTracking(True)
 
-        fade_anim = QtCore.QVariantAnimation()
-        fade_anim.setStartValue(0)
-        fade_anim.setEndValue(50)
-        fade_anim.setDuration(200)
-        fade_anim.setEasingCurve(QtCore.QEasingCurve.OutCubic)
-
-        fade_anim.valueChanged.connect(self._on_fade_anim)
-
         app = QtWidgets.QApplication.instance()
         if hasattr(app, "screenAdded"):
             app.screenAdded.connect(self._on_screen_added)
@@ -45,12 +37,10 @@ class ScreenMarquee(QtWidgets.QDialog):
         for screen in QtWidgets.QApplication.screens():
             screen.geometryChanged.connect(self._fit_screen_geometry)
 
-        self._opacity = fade_anim.startValue()
+        self._opacity = 50
         self._click_pos = None
         self._capture_rect = None
 
-        self._fade_anim = fade_anim
-
     def get_captured_pixmap(self):
         if self._capture_rect is None:
             return QtGui.QPixmap()
@@ -67,28 +57,33 @@ class ScreenMarquee(QtWidgets.QDialog):
             click_pos = self.mapFromGlobal(self._click_pos)
 
         painter = QtGui.QPainter(self)
+        painter.setRenderHints(
+            QtGui.QPainter.Antialiasing
+            | QtGui.QPainter.SmoothPixmapTransform
+        )
 
         # Draw background. Aside from aesthetics, this makes the full
         # tool region accept mouse events.
         painter.setBrush(QtGui.QColor(0, 0, 0, self._opacity))
         painter.setPen(QtCore.Qt.NoPen)
-        painter.drawRect(event.rect())
+        rect = event.rect()
+        fill_path = QtGui.QPainterPath()
+        fill_path.addRect(rect)
 
         # Clear the capture area
         if click_pos is not None:
+            sub_path = QtGui.QPainterPath()
             capture_rect = QtCore.QRect(click_pos, mouse_pos)
-            painter.setCompositionMode(
-                QtGui.QPainter.CompositionMode_Clear)
-            painter.drawRect(capture_rect)
-            painter.setCompositionMode(
-                QtGui.QPainter.CompositionMode_SourceOver)
+            sub_path.addRect(capture_rect)
+            fill_path = fill_path.subtracted(sub_path)
 
-        pen_color = QtGui.QColor(255, 255, 255, 64)
+        painter.drawPath(fill_path)
+
+        pen_color = QtGui.QColor(255, 255, 255, self._opacity)
         pen = QtGui.QPen(pen_color, 1, QtCore.Qt.DotLine)
         painter.setPen(pen)
 
         # Draw cropping markers at click position
-        rect = event.rect()
         if click_pos is not None:
             painter.drawLine(
                 rect.left(), click_pos.y(),
@@ -108,6 +103,7 @@ class ScreenMarquee(QtWidgets.QDialog):
             mouse_pos.x(), rect.top(),
             mouse_pos.x(), rect.bottom()
         )
+        painter.end()
 
     def mousePressEvent(self, event):
         """Mouse click event"""
@@ -138,13 +134,13 @@ class ScreenMarquee(QtWidgets.QDialog):
         if event.key() == QtCore.Qt.Key_Escape:
             self._click_pos = None
             self._capture_rect = None
+            event.accept()
             self.close()
             return
-        return super(ScreenMarquee, self).mousePressEvent(event)
+        return super(ScreenMarquee, self).keyPressEvent(event)
 
     def showEvent(self, event):
         self._fit_screen_geometry()
-        self._fade_anim.start()
 
     def _fit_screen_geometry(self):
         # Compute the union of all screen geometries, and resize to fit.
@@ -153,12 +149,6 @@ class ScreenMarquee(QtWidgets.QDialog):
             workspace_rect = workspace_rect.united(screen.geometry())
         self.setGeometry(workspace_rect)
 
-    def _on_fade_anim(self):
-        """Animation callback for opacity."""
-
-        self._opacity = self._fade_anim.currentValue()
-        self.repaint()
-
     def _on_screen_added(self):
         for screen in QtGui.QGuiApplication.screens():
             screen.geometryChanged.connect(self._fit_screen_geometry)

From 254a1859632b9b5ce59fb58c8cdb47a754ae746d Mon Sep 17 00:00:00 2001
From: Mustafa-Zarkash <mustafataherzaky@outlook.com>
Date: Thu, 14 Sep 2023 22:35:04 +0300
Subject: [PATCH 239/366] set PATH environment in deadline jobs

---
 .../repository/custom/plugins/GlobalJobPreLoad.py      | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/openpype/modules/deadline/repository/custom/plugins/GlobalJobPreLoad.py b/openpype/modules/deadline/repository/custom/plugins/GlobalJobPreLoad.py
index 97875215ae..79cd3968fb 100644
--- a/openpype/modules/deadline/repository/custom/plugins/GlobalJobPreLoad.py
+++ b/openpype/modules/deadline/repository/custom/plugins/GlobalJobPreLoad.py
@@ -385,6 +385,11 @@ def inject_openpype_environment(deadlinePlugin):
         for key, value in contents.items():
             deadlinePlugin.SetProcessEnvironmentVariable(key, value)
 
+        if "PATH" in contents:
+            PATH = contents["PATH"]
+            print(f">>> Set 'PATH' Environment to: {PATH}")
+            os.environ["PATH"] = PATH
+
         script_url = job.GetJobPluginInfoKeyValue("ScriptFilename")
         if script_url:
             script_url = script_url.format(**contents).replace("\\", "/")
@@ -509,6 +514,11 @@ def inject_ayon_environment(deadlinePlugin):
         for key, value in contents.items():
             deadlinePlugin.SetProcessEnvironmentVariable(key, value)
 
+        if "PATH" in contents:
+            PATH = contents["PATH"]
+            print(f">>> Set 'PATH' Environment to: {PATH}")
+            os.environ["PATH"] = PATH
+
         script_url = job.GetJobPluginInfoKeyValue("ScriptFilename")
         if script_url:
             script_url = script_url.format(**contents).replace("\\", "/")

From f7cc7f1908948fc0aa1526987b8cc12a20dd4736 Mon Sep 17 00:00:00 2001
From: Mustafa-Zarkash <mustafataherzaky@outlook.com>
Date: Thu, 14 Sep 2023 23:17:52 +0300
Subject: [PATCH 240/366] BigRoy's comment

---
 .../deadline/repository/custom/plugins/GlobalJobPreLoad.py    | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/openpype/modules/deadline/repository/custom/plugins/GlobalJobPreLoad.py b/openpype/modules/deadline/repository/custom/plugins/GlobalJobPreLoad.py
index 79cd3968fb..24bfd983f3 100644
--- a/openpype/modules/deadline/repository/custom/plugins/GlobalJobPreLoad.py
+++ b/openpype/modules/deadline/repository/custom/plugins/GlobalJobPreLoad.py
@@ -387,7 +387,7 @@ def inject_openpype_environment(deadlinePlugin):
 
         if "PATH" in contents:
             PATH = contents["PATH"]
-            print(f">>> Set 'PATH' Environment to: {PATH}")
+            print(f">>> Setting 'PATH' Environment to: {PATH}")
             os.environ["PATH"] = PATH
 
         script_url = job.GetJobPluginInfoKeyValue("ScriptFilename")
@@ -516,7 +516,7 @@ def inject_ayon_environment(deadlinePlugin):
 
         if "PATH" in contents:
             PATH = contents["PATH"]
-            print(f">>> Set 'PATH' Environment to: {PATH}")
+            print(f">>> Setting 'PATH' Environment to: {PATH}")
             os.environ["PATH"] = PATH
 
         script_url = job.GetJobPluginInfoKeyValue("ScriptFilename")

From 1ec11da6f7c25550edd030461845b88681c1b4a6 Mon Sep 17 00:00:00 2001
From: Mustafa-Zarkash <mustafataherzaky@outlook.com>
Date: Thu, 14 Sep 2023 23:23:31 +0300
Subject: [PATCH 241/366] add a developer note

---
 .../deadline/repository/custom/plugins/GlobalJobPreLoad.py    | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/openpype/modules/deadline/repository/custom/plugins/GlobalJobPreLoad.py b/openpype/modules/deadline/repository/custom/plugins/GlobalJobPreLoad.py
index 24bfd983f3..044a953083 100644
--- a/openpype/modules/deadline/repository/custom/plugins/GlobalJobPreLoad.py
+++ b/openpype/modules/deadline/repository/custom/plugins/GlobalJobPreLoad.py
@@ -386,6 +386,8 @@ def inject_openpype_environment(deadlinePlugin):
             deadlinePlugin.SetProcessEnvironmentVariable(key, value)
 
         if "PATH" in contents:
+            # Set os.environ[PATH] so studio settings' path entries
+            # can be used to define search path for executables.
             PATH = contents["PATH"]
             print(f">>> Setting 'PATH' Environment to: {PATH}")
             os.environ["PATH"] = PATH
@@ -515,6 +517,8 @@ def inject_ayon_environment(deadlinePlugin):
             deadlinePlugin.SetProcessEnvironmentVariable(key, value)
 
         if "PATH" in contents:
+            # Set os.environ[PATH] so studio settings' path entries
+            # can be used to define search path for executables.
             PATH = contents["PATH"]
             print(f">>> Setting 'PATH' Environment to: {PATH}")
             os.environ["PATH"] = PATH

From 0c09a6772ce3c0f3c9ce47547e937e9dc254d6fe Mon Sep 17 00:00:00 2001
From: Mustafa-Zarkash <mustafataherzaky@outlook.com>
Date: Fri, 15 Sep 2023 09:50:13 +0300
Subject: [PATCH 242/366] BigRoy's comment

---
 .../repository/custom/plugins/GlobalJobPreLoad.py      | 10 ++++------
 1 file changed, 4 insertions(+), 6 deletions(-)

diff --git a/openpype/modules/deadline/repository/custom/plugins/GlobalJobPreLoad.py b/openpype/modules/deadline/repository/custom/plugins/GlobalJobPreLoad.py
index 044a953083..e9b81369ca 100644
--- a/openpype/modules/deadline/repository/custom/plugins/GlobalJobPreLoad.py
+++ b/openpype/modules/deadline/repository/custom/plugins/GlobalJobPreLoad.py
@@ -388,9 +388,8 @@ def inject_openpype_environment(deadlinePlugin):
         if "PATH" in contents:
             # Set os.environ[PATH] so studio settings' path entries
             # can be used to define search path for executables.
-            PATH = contents["PATH"]
-            print(f">>> Setting 'PATH' Environment to: {PATH}")
-            os.environ["PATH"] = PATH
+            print(f">>> Setting 'PATH' Environment to: {contents['PATH']}")
+            os.environ["PATH"] = contents["PATH"]
 
         script_url = job.GetJobPluginInfoKeyValue("ScriptFilename")
         if script_url:
@@ -519,9 +518,8 @@ def inject_ayon_environment(deadlinePlugin):
         if "PATH" in contents:
             # Set os.environ[PATH] so studio settings' path entries
             # can be used to define search path for executables.
-            PATH = contents["PATH"]
-            print(f">>> Setting 'PATH' Environment to: {PATH}")
-            os.environ["PATH"] = PATH
+            print(f">>> Setting 'PATH' Environment to: {contents['PATH']}")
+            os.environ["PATH"] = contents["PATH"]
 
         script_url = job.GetJobPluginInfoKeyValue("ScriptFilename")
         if script_url:

From b50258874360687b4a1e36eff9935084db526456 Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Fri, 15 Sep 2023 10:54:53 +0200
Subject: [PATCH 243/366] Fix - images without alpha will not fail (#5620)

---
 .../photoshop/plugins/publish/extract_review.py      | 12 ++++++++----
 1 file changed, 8 insertions(+), 4 deletions(-)

diff --git a/openpype/hosts/photoshop/plugins/publish/extract_review.py b/openpype/hosts/photoshop/plugins/publish/extract_review.py
index afddbdba31..d5dac417d7 100644
--- a/openpype/hosts/photoshop/plugins/publish/extract_review.py
+++ b/openpype/hosts/photoshop/plugins/publish/extract_review.py
@@ -140,10 +140,14 @@ class ExtractReview(publish.Extractor):
         _, ext = os.path.splitext(repre_file["files"])
         if ext != ".jpg":
             im = Image.open(source_file_path)
-            # without this it produces messy low quality jpg
-            rgb_im = Image.new("RGBA", (im.width, im.height), "#ffffff")
-            rgb_im.alpha_composite(im)
-            rgb_im.convert("RGB").save(os.path.join(staging_dir, img_file))
+            if (im.mode in ('RGBA', 'LA') or (
+                    im.mode == 'P' and 'transparency' in im.info)):
+                # without this it produces messy low quality jpg
+                rgb_im = Image.new("RGBA", (im.width, im.height), "#ffffff")
+                rgb_im.alpha_composite(im)
+                rgb_im.convert("RGB").save(os.path.join(staging_dir, img_file))
+            else:
+                im.save(os.path.join(staging_dir, img_file))
         else:
             # handles already .jpg
             shutil.copy(source_file_path,

From 67abbaad3c2bdbbf561bc7d30d6ac1adc5b21ed8 Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Fri, 15 Sep 2023 11:02:37 +0200
Subject: [PATCH 244/366] Fussion: added support for Fusion 17 (#5614)

* OP-6780 - vendorized necessary libraries for Python 3.6

* OP-6780 - better resolution of app_version

* Update openpype/hosts/fusion/addon.py

Co-authored-by: Roy Nieterau <roy_nieterau@hotmail.com>

* OP-6780 - add vendorized libraries even before menu creation

This should help when version of Fusion > 17, but it is still using 3.6

* OP-6780 - added todo message to remember to remove this

* OP-6780 - move injection of PYTHONPATH much sooner

At previous position it was too late.

* OP-6780 - better capture of broken imports

* OP-6780 - SyntaxError is thrown only if directly importing

* OP-6780 - remove unnecessary imports

Only urllib3 and attrs are actually needed

* OP-6780 - vendorize even directly in Fusion if Python < 3.7

* OP-6780 - remove update of PYTHONPATH in addon

More important and required is check directly in interpreter in Fusion, it doesn't make sense to pollute addon and have it on two places. It might get removed altogether in next-minor.

* OP-6780 - added comment

---------

Co-authored-by: Roy Nieterau <roy_nieterau@hotmail.com>
---
 openpype/hosts/fusion/addon.py                |    3 +-
 .../deploy/MenuScripts/openpype_menu.py       |   13 +
 openpype/hosts/fusion/vendor/attr/__init__.py |   78 +
 .../hosts/fusion/vendor/attr/__init__.pyi     |  475 +++
 openpype/hosts/fusion/vendor/attr/_cmp.py     |  152 +
 openpype/hosts/fusion/vendor/attr/_cmp.pyi    |   14 +
 openpype/hosts/fusion/vendor/attr/_compat.py  |  242 ++
 openpype/hosts/fusion/vendor/attr/_config.py  |   23 +
 openpype/hosts/fusion/vendor/attr/_funcs.py   |  395 +++
 openpype/hosts/fusion/vendor/attr/_make.py    | 3052 +++++++++++++++++
 .../hosts/fusion/vendor/attr/_next_gen.py     |  158 +
 .../hosts/fusion/vendor/attr/_version_info.py |   85 +
 .../fusion/vendor/attr/_version_info.pyi      |    9 +
 .../hosts/fusion/vendor/attr/converters.py    |  111 +
 .../hosts/fusion/vendor/attr/converters.pyi   |   13 +
 .../hosts/fusion/vendor/attr/exceptions.py    |   92 +
 .../hosts/fusion/vendor/attr/exceptions.pyi   |   18 +
 openpype/hosts/fusion/vendor/attr/filters.py  |   52 +
 openpype/hosts/fusion/vendor/attr/filters.pyi |    7 +
 openpype/hosts/fusion/vendor/attr/py.typed    |    0
 openpype/hosts/fusion/vendor/attr/setters.py  |   77 +
 openpype/hosts/fusion/vendor/attr/setters.pyi |   20 +
 .../hosts/fusion/vendor/attr/validators.py    |  379 ++
 .../hosts/fusion/vendor/attr/validators.pyi   |   68 +
 .../hosts/fusion/vendor/urllib3/__init__.py   |   85 +
 .../fusion/vendor/urllib3/_collections.py     |  337 ++
 .../hosts/fusion/vendor/urllib3/_version.py   |    2 +
 .../hosts/fusion/vendor/urllib3/connection.py |  539 +++
 .../fusion/vendor/urllib3/connectionpool.py   | 1067 ++++++
 .../fusion/vendor/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     |  396 +++
 .../vendor/urllib3/contrib/appengine.py       |  314 ++
 .../fusion/vendor/urllib3/contrib/ntlmpool.py |  130 +
 .../vendor/urllib3/contrib/pyopenssl.py       |  511 +++
 .../vendor/urllib3/contrib/securetransport.py |  922 +++++
 .../fusion/vendor/urllib3/contrib/socks.py    |  216 ++
 .../hosts/fusion/vendor/urllib3/exceptions.py |  323 ++
 .../hosts/fusion/vendor/urllib3/fields.py     |  274 ++
 .../hosts/fusion/vendor/urllib3/filepost.py   |   98 +
 .../vendor/urllib3/packages/__init__.py       |    5 +
 .../urllib3/packages/backports/__init__.py    |    0
 .../urllib3/packages/backports/makefile.py    |   51 +
 .../fusion/vendor/urllib3/packages/six.py     | 1077 ++++++
 .../packages/ssl_match_hostname/__init__.py   |   24 +
 .../ssl_match_hostname/_implementation.py     |  160 +
 .../fusion/vendor/urllib3/poolmanager.py      |  536 +++
 .../hosts/fusion/vendor/urllib3/request.py    |  170 +
 .../hosts/fusion/vendor/urllib3/response.py   |  821 +++++
 .../fusion/vendor/urllib3/util/__init__.py    |   49 +
 .../fusion/vendor/urllib3/util/connection.py  |  150 +
 .../hosts/fusion/vendor/urllib3/util/proxy.py |   56 +
 .../hosts/fusion/vendor/urllib3/util/queue.py |   22 +
 .../fusion/vendor/urllib3/util/request.py     |  143 +
 .../fusion/vendor/urllib3/util/response.py    |  107 +
 .../hosts/fusion/vendor/urllib3/util/retry.py |  602 ++++
 .../hosts/fusion/vendor/urllib3/util/ssl_.py  |  495 +++
 .../vendor/urllib3/util/ssltransport.py       |  221 ++
 .../fusion/vendor/urllib3/util/timeout.py     |  268 ++
 .../hosts/fusion/vendor/urllib3/util/url.py   |  432 +++
 .../hosts/fusion/vendor/urllib3/util/wait.py  |  153 +
 63 files changed, 16846 insertions(+), 1 deletion(-)
 create mode 100644 openpype/hosts/fusion/vendor/attr/__init__.py
 create mode 100644 openpype/hosts/fusion/vendor/attr/__init__.pyi
 create mode 100644 openpype/hosts/fusion/vendor/attr/_cmp.py
 create mode 100644 openpype/hosts/fusion/vendor/attr/_cmp.pyi
 create mode 100644 openpype/hosts/fusion/vendor/attr/_compat.py
 create mode 100644 openpype/hosts/fusion/vendor/attr/_config.py
 create mode 100644 openpype/hosts/fusion/vendor/attr/_funcs.py
 create mode 100644 openpype/hosts/fusion/vendor/attr/_make.py
 create mode 100644 openpype/hosts/fusion/vendor/attr/_next_gen.py
 create mode 100644 openpype/hosts/fusion/vendor/attr/_version_info.py
 create mode 100644 openpype/hosts/fusion/vendor/attr/_version_info.pyi
 create mode 100644 openpype/hosts/fusion/vendor/attr/converters.py
 create mode 100644 openpype/hosts/fusion/vendor/attr/converters.pyi
 create mode 100644 openpype/hosts/fusion/vendor/attr/exceptions.py
 create mode 100644 openpype/hosts/fusion/vendor/attr/exceptions.pyi
 create mode 100644 openpype/hosts/fusion/vendor/attr/filters.py
 create mode 100644 openpype/hosts/fusion/vendor/attr/filters.pyi
 create mode 100644 openpype/hosts/fusion/vendor/attr/py.typed
 create mode 100644 openpype/hosts/fusion/vendor/attr/setters.py
 create mode 100644 openpype/hosts/fusion/vendor/attr/setters.pyi
 create mode 100644 openpype/hosts/fusion/vendor/attr/validators.py
 create mode 100644 openpype/hosts/fusion/vendor/attr/validators.pyi
 create mode 100644 openpype/hosts/fusion/vendor/urllib3/__init__.py
 create mode 100644 openpype/hosts/fusion/vendor/urllib3/_collections.py
 create mode 100644 openpype/hosts/fusion/vendor/urllib3/_version.py
 create mode 100644 openpype/hosts/fusion/vendor/urllib3/connection.py
 create mode 100644 openpype/hosts/fusion/vendor/urllib3/connectionpool.py
 create mode 100644 openpype/hosts/fusion/vendor/urllib3/contrib/__init__.py
 create mode 100644 openpype/hosts/fusion/vendor/urllib3/contrib/_appengine_environ.py
 create mode 100644 openpype/hosts/fusion/vendor/urllib3/contrib/_securetransport/__init__.py
 create mode 100644 openpype/hosts/fusion/vendor/urllib3/contrib/_securetransport/bindings.py
 create mode 100644 openpype/hosts/fusion/vendor/urllib3/contrib/_securetransport/low_level.py
 create mode 100644 openpype/hosts/fusion/vendor/urllib3/contrib/appengine.py
 create mode 100644 openpype/hosts/fusion/vendor/urllib3/contrib/ntlmpool.py
 create mode 100644 openpype/hosts/fusion/vendor/urllib3/contrib/pyopenssl.py
 create mode 100644 openpype/hosts/fusion/vendor/urllib3/contrib/securetransport.py
 create mode 100644 openpype/hosts/fusion/vendor/urllib3/contrib/socks.py
 create mode 100644 openpype/hosts/fusion/vendor/urllib3/exceptions.py
 create mode 100644 openpype/hosts/fusion/vendor/urllib3/fields.py
 create mode 100644 openpype/hosts/fusion/vendor/urllib3/filepost.py
 create mode 100644 openpype/hosts/fusion/vendor/urllib3/packages/__init__.py
 create mode 100644 openpype/hosts/fusion/vendor/urllib3/packages/backports/__init__.py
 create mode 100644 openpype/hosts/fusion/vendor/urllib3/packages/backports/makefile.py
 create mode 100644 openpype/hosts/fusion/vendor/urllib3/packages/six.py
 create mode 100644 openpype/hosts/fusion/vendor/urllib3/packages/ssl_match_hostname/__init__.py
 create mode 100644 openpype/hosts/fusion/vendor/urllib3/packages/ssl_match_hostname/_implementation.py
 create mode 100644 openpype/hosts/fusion/vendor/urllib3/poolmanager.py
 create mode 100644 openpype/hosts/fusion/vendor/urllib3/request.py
 create mode 100644 openpype/hosts/fusion/vendor/urllib3/response.py
 create mode 100644 openpype/hosts/fusion/vendor/urllib3/util/__init__.py
 create mode 100644 openpype/hosts/fusion/vendor/urllib3/util/connection.py
 create mode 100644 openpype/hosts/fusion/vendor/urllib3/util/proxy.py
 create mode 100644 openpype/hosts/fusion/vendor/urllib3/util/queue.py
 create mode 100644 openpype/hosts/fusion/vendor/urllib3/util/request.py
 create mode 100644 openpype/hosts/fusion/vendor/urllib3/util/response.py
 create mode 100644 openpype/hosts/fusion/vendor/urllib3/util/retry.py
 create mode 100644 openpype/hosts/fusion/vendor/urllib3/util/ssl_.py
 create mode 100644 openpype/hosts/fusion/vendor/urllib3/util/ssltransport.py
 create mode 100644 openpype/hosts/fusion/vendor/urllib3/util/timeout.py
 create mode 100644 openpype/hosts/fusion/vendor/urllib3/util/url.py
 create mode 100644 openpype/hosts/fusion/vendor/urllib3/util/wait.py

diff --git a/openpype/hosts/fusion/addon.py b/openpype/hosts/fusion/addon.py
index 45683cfbde..8343f3c79d 100644
--- a/openpype/hosts/fusion/addon.py
+++ b/openpype/hosts/fusion/addon.py
@@ -60,8 +60,9 @@ class FusionAddon(OpenPypeModule, IHostAddon):
             return []
         return [os.path.join(FUSION_HOST_DIR, "hooks")]
 
-    def add_implementation_envs(self, env, _app):
+    def add_implementation_envs(self, env, app):
         # Set default values if are not already set via settings
+
         defaults = {"OPENPYPE_LOG_NO_COLORS": "Yes"}
         for key, value in defaults.items():
             if not env.get(key):
diff --git a/openpype/hosts/fusion/deploy/MenuScripts/openpype_menu.py b/openpype/hosts/fusion/deploy/MenuScripts/openpype_menu.py
index 685e58d58f..1c58ee50e4 100644
--- a/openpype/hosts/fusion/deploy/MenuScripts/openpype_menu.py
+++ b/openpype/hosts/fusion/deploy/MenuScripts/openpype_menu.py
@@ -1,6 +1,19 @@
 import os
 import sys
 
+if sys.version_info < (3, 7):
+    # hack to handle discrepancy between distributed libraries and Python 3.6
+    # mostly because wrong version of urllib3
+    # TODO remove when not necessary
+    from openpype import PACKAGE_DIR
+    FUSION_HOST_DIR = os.path.join(PACKAGE_DIR, "hosts", "fusion")
+
+    vendor_path = os.path.join(FUSION_HOST_DIR, "vendor")
+    if vendor_path not in sys.path:
+        sys.path.insert(0, vendor_path)
+
+    print(f"Added vendorized libraries from {vendor_path}")
+
 from openpype.lib import Logger
 from openpype.pipeline import (
     install_host,
diff --git a/openpype/hosts/fusion/vendor/attr/__init__.py b/openpype/hosts/fusion/vendor/attr/__init__.py
new file mode 100644
index 0000000000..b1ce7fe248
--- /dev/null
+++ b/openpype/hosts/fusion/vendor/attr/__init__.py
@@ -0,0 +1,78 @@
+from __future__ import absolute_import, division, print_function
+
+import sys
+
+from functools import partial
+
+from . import converters, exceptions, filters, setters, validators
+from ._cmp import cmp_using
+from ._config import get_run_validators, set_run_validators
+from ._funcs import asdict, assoc, astuple, evolve, has, resolve_types
+from ._make import (
+    NOTHING,
+    Attribute,
+    Factory,
+    attrib,
+    attrs,
+    fields,
+    fields_dict,
+    make_class,
+    validate,
+)
+from ._version_info import VersionInfo
+
+
+__version__ = "21.2.0"
+__version_info__ = VersionInfo._from_version_string(__version__)
+
+__title__ = "attrs"
+__description__ = "Classes Without Boilerplate"
+__url__ = "https://www.attrs.org/"
+__uri__ = __url__
+__doc__ = __description__ + " <" + __uri__ + ">"
+
+__author__ = "Hynek Schlawack"
+__email__ = "hs@ox.cx"
+
+__license__ = "MIT"
+__copyright__ = "Copyright (c) 2015 Hynek Schlawack"
+
+
+s = attributes = attrs
+ib = attr = attrib
+dataclass = partial(attrs, auto_attribs=True)  # happy Easter ;)
+
+__all__ = [
+    "Attribute",
+    "Factory",
+    "NOTHING",
+    "asdict",
+    "assoc",
+    "astuple",
+    "attr",
+    "attrib",
+    "attributes",
+    "attrs",
+    "cmp_using",
+    "converters",
+    "evolve",
+    "exceptions",
+    "fields",
+    "fields_dict",
+    "filters",
+    "get_run_validators",
+    "has",
+    "ib",
+    "make_class",
+    "resolve_types",
+    "s",
+    "set_run_validators",
+    "setters",
+    "validate",
+    "validators",
+]
+
+if sys.version_info[:2] >= (3, 6):
+    from ._next_gen import define, field, frozen, mutable
+
+    __all__.extend((define, field, frozen, mutable))
diff --git a/openpype/hosts/fusion/vendor/attr/__init__.pyi b/openpype/hosts/fusion/vendor/attr/__init__.pyi
new file mode 100644
index 0000000000..3503b073b4
--- /dev/null
+++ b/openpype/hosts/fusion/vendor/attr/__init__.pyi
@@ -0,0 +1,475 @@
+import sys
+
+from typing import (
+    Any,
+    Callable,
+    Dict,
+    Generic,
+    List,
+    Mapping,
+    Optional,
+    Sequence,
+    Tuple,
+    Type,
+    TypeVar,
+    Union,
+    overload,
+)
+
+# `import X as X` is required to make these public
+from . import converters as converters
+from . import exceptions as exceptions
+from . import filters as filters
+from . import setters as setters
+from . import validators as validators
+from ._version_info import VersionInfo
+
+
+__version__: str
+__version_info__: VersionInfo
+__title__: str
+__description__: str
+__url__: str
+__uri__: str
+__author__: str
+__email__: str
+__license__: str
+__copyright__: str
+
+_T = TypeVar("_T")
+_C = TypeVar("_C", bound=type)
+
+_EqOrderType = Union[bool, Callable[[Any], Any]]
+_ValidatorType = Callable[[Any, Attribute[_T], _T], Any]
+_ConverterType = Callable[[Any], Any]
+_FilterType = Callable[[Attribute[_T], _T], bool]
+_ReprType = Callable[[Any], str]
+_ReprArgType = Union[bool, _ReprType]
+_OnSetAttrType = Callable[[Any, Attribute[Any], Any], Any]
+_OnSetAttrArgType = Union[
+    _OnSetAttrType, List[_OnSetAttrType], setters._NoOpType
+]
+_FieldTransformer = Callable[[type, List[Attribute[Any]]], List[Attribute[Any]]]
+# FIXME: in reality, if multiple validators are passed they must be in a list
+# or tuple, but those are invariant and so would prevent subtypes of
+# _ValidatorType from working when passed in a list or tuple.
+_ValidatorArgType = Union[_ValidatorType[_T], Sequence[_ValidatorType[_T]]]
+
+# _make --
+
+NOTHING: object
+
+# NOTE: Factory lies about its return type to make this possible:
+# `x: List[int] # = Factory(list)`
+# Work around mypy issue #4554 in the common case by using an overload.
+if sys.version_info >= (3, 8):
+    from typing import Literal
+
+    @overload
+    def Factory(factory: Callable[[], _T]) -> _T: ...
+    @overload
+    def Factory(
+        factory: Callable[[Any], _T],
+        takes_self: Literal[True],
+    ) -> _T: ...
+    @overload
+    def Factory(
+        factory: Callable[[], _T],
+        takes_self: Literal[False],
+    ) -> _T: ...
+else:
+    @overload
+    def Factory(factory: Callable[[], _T]) -> _T: ...
+    @overload
+    def Factory(
+        factory: Union[Callable[[Any], _T], Callable[[], _T]],
+        takes_self: bool = ...,
+    ) -> _T: ...
+
+# Static type inference support via __dataclass_transform__ implemented as per:
+# https://github.com/microsoft/pyright/blob/1.1.135/specs/dataclass_transforms.md
+# This annotation must be applied to all overloads of "define" and "attrs"
+#
+# NOTE: This is a typing construct and does not exist at runtime.  Extensions
+# wrapping attrs decorators should declare a separate __dataclass_transform__
+# signature in the extension module using the specification linked above to
+# provide pyright support.
+def __dataclass_transform__(
+    *,
+    eq_default: bool = True,
+    order_default: bool = False,
+    kw_only_default: bool = False,
+    field_descriptors: Tuple[Union[type, Callable[..., Any]], ...] = (()),
+) -> Callable[[_T], _T]: ...
+
+class Attribute(Generic[_T]):
+    name: str
+    default: Optional[_T]
+    validator: Optional[_ValidatorType[_T]]
+    repr: _ReprArgType
+    cmp: _EqOrderType
+    eq: _EqOrderType
+    order: _EqOrderType
+    hash: Optional[bool]
+    init: bool
+    converter: Optional[_ConverterType]
+    metadata: Dict[Any, Any]
+    type: Optional[Type[_T]]
+    kw_only: bool
+    on_setattr: _OnSetAttrType
+
+    def evolve(self, **changes: Any) -> "Attribute[Any]": ...
+
+# NOTE: We had several choices for the annotation to use for type arg:
+# 1) Type[_T]
+#   - Pros: Handles simple cases correctly
+#   - Cons: Might produce less informative errors in the case of conflicting
+#     TypeVars e.g. `attr.ib(default='bad', type=int)`
+# 2) Callable[..., _T]
+#   - Pros: Better error messages than #1 for conflicting TypeVars
+#   - Cons: Terrible error messages for validator checks.
+#   e.g. attr.ib(type=int, validator=validate_str)
+#        -> error: Cannot infer function type argument
+# 3) type (and do all of the work in the mypy plugin)
+#   - Pros: Simple here, and we could customize the plugin with our own errors.
+#   - Cons: Would need to write mypy plugin code to handle all the cases.
+# We chose option #1.
+
+# `attr` lies about its return type to make the following possible:
+#     attr()    -> Any
+#     attr(8)   -> int
+#     attr(validator=<some callable>)  -> Whatever the callable expects.
+# This makes this type of assignments possible:
+#     x: int = attr(8)
+#
+# This form catches explicit None or no default but with no other arguments
+# returns Any.
+@overload
+def attrib(
+    default: None = ...,
+    validator: None = ...,
+    repr: _ReprArgType = ...,
+    cmp: Optional[_EqOrderType] = ...,
+    hash: Optional[bool] = ...,
+    init: bool = ...,
+    metadata: Optional[Mapping[Any, Any]] = ...,
+    type: None = ...,
+    converter: None = ...,
+    factory: None = ...,
+    kw_only: bool = ...,
+    eq: Optional[_EqOrderType] = ...,
+    order: Optional[_EqOrderType] = ...,
+    on_setattr: Optional[_OnSetAttrArgType] = ...,
+) -> Any: ...
+
+# This form catches an explicit None or no default and infers the type from the
+# other arguments.
+@overload
+def attrib(
+    default: None = ...,
+    validator: Optional[_ValidatorArgType[_T]] = ...,
+    repr: _ReprArgType = ...,
+    cmp: Optional[_EqOrderType] = ...,
+    hash: Optional[bool] = ...,
+    init: bool = ...,
+    metadata: Optional[Mapping[Any, Any]] = ...,
+    type: Optional[Type[_T]] = ...,
+    converter: Optional[_ConverterType] = ...,
+    factory: Optional[Callable[[], _T]] = ...,
+    kw_only: bool = ...,
+    eq: Optional[_EqOrderType] = ...,
+    order: Optional[_EqOrderType] = ...,
+    on_setattr: Optional[_OnSetAttrArgType] = ...,
+) -> _T: ...
+
+# This form catches an explicit default argument.
+@overload
+def attrib(
+    default: _T,
+    validator: Optional[_ValidatorArgType[_T]] = ...,
+    repr: _ReprArgType = ...,
+    cmp: Optional[_EqOrderType] = ...,
+    hash: Optional[bool] = ...,
+    init: bool = ...,
+    metadata: Optional[Mapping[Any, Any]] = ...,
+    type: Optional[Type[_T]] = ...,
+    converter: Optional[_ConverterType] = ...,
+    factory: Optional[Callable[[], _T]] = ...,
+    kw_only: bool = ...,
+    eq: Optional[_EqOrderType] = ...,
+    order: Optional[_EqOrderType] = ...,
+    on_setattr: Optional[_OnSetAttrArgType] = ...,
+) -> _T: ...
+
+# This form covers type=non-Type: e.g. forward references (str), Any
+@overload
+def attrib(
+    default: Optional[_T] = ...,
+    validator: Optional[_ValidatorArgType[_T]] = ...,
+    repr: _ReprArgType = ...,
+    cmp: Optional[_EqOrderType] = ...,
+    hash: Optional[bool] = ...,
+    init: bool = ...,
+    metadata: Optional[Mapping[Any, Any]] = ...,
+    type: object = ...,
+    converter: Optional[_ConverterType] = ...,
+    factory: Optional[Callable[[], _T]] = ...,
+    kw_only: bool = ...,
+    eq: Optional[_EqOrderType] = ...,
+    order: Optional[_EqOrderType] = ...,
+    on_setattr: Optional[_OnSetAttrArgType] = ...,
+) -> Any: ...
+@overload
+def field(
+    *,
+    default: None = ...,
+    validator: None = ...,
+    repr: _ReprArgType = ...,
+    hash: Optional[bool] = ...,
+    init: bool = ...,
+    metadata: Optional[Mapping[Any, Any]] = ...,
+    converter: None = ...,
+    factory: None = ...,
+    kw_only: bool = ...,
+    eq: Optional[bool] = ...,
+    order: Optional[bool] = ...,
+    on_setattr: Optional[_OnSetAttrArgType] = ...,
+) -> Any: ...
+
+# This form catches an explicit None or no default and infers the type from the
+# other arguments.
+@overload
+def field(
+    *,
+    default: None = ...,
+    validator: Optional[_ValidatorArgType[_T]] = ...,
+    repr: _ReprArgType = ...,
+    hash: Optional[bool] = ...,
+    init: bool = ...,
+    metadata: Optional[Mapping[Any, Any]] = ...,
+    converter: Optional[_ConverterType] = ...,
+    factory: Optional[Callable[[], _T]] = ...,
+    kw_only: bool = ...,
+    eq: Optional[_EqOrderType] = ...,
+    order: Optional[_EqOrderType] = ...,
+    on_setattr: Optional[_OnSetAttrArgType] = ...,
+) -> _T: ...
+
+# This form catches an explicit default argument.
+@overload
+def field(
+    *,
+    default: _T,
+    validator: Optional[_ValidatorArgType[_T]] = ...,
+    repr: _ReprArgType = ...,
+    hash: Optional[bool] = ...,
+    init: bool = ...,
+    metadata: Optional[Mapping[Any, Any]] = ...,
+    converter: Optional[_ConverterType] = ...,
+    factory: Optional[Callable[[], _T]] = ...,
+    kw_only: bool = ...,
+    eq: Optional[_EqOrderType] = ...,
+    order: Optional[_EqOrderType] = ...,
+    on_setattr: Optional[_OnSetAttrArgType] = ...,
+) -> _T: ...
+
+# This form covers type=non-Type: e.g. forward references (str), Any
+@overload
+def field(
+    *,
+    default: Optional[_T] = ...,
+    validator: Optional[_ValidatorArgType[_T]] = ...,
+    repr: _ReprArgType = ...,
+    hash: Optional[bool] = ...,
+    init: bool = ...,
+    metadata: Optional[Mapping[Any, Any]] = ...,
+    converter: Optional[_ConverterType] = ...,
+    factory: Optional[Callable[[], _T]] = ...,
+    kw_only: bool = ...,
+    eq: Optional[_EqOrderType] = ...,
+    order: Optional[_EqOrderType] = ...,
+    on_setattr: Optional[_OnSetAttrArgType] = ...,
+) -> Any: ...
+@overload
+@__dataclass_transform__(order_default=True, field_descriptors=(attrib, field))
+def attrs(
+    maybe_cls: _C,
+    these: Optional[Dict[str, Any]] = ...,
+    repr_ns: Optional[str] = ...,
+    repr: bool = ...,
+    cmp: Optional[_EqOrderType] = ...,
+    hash: Optional[bool] = ...,
+    init: bool = ...,
+    slots: bool = ...,
+    frozen: bool = ...,
+    weakref_slot: bool = ...,
+    str: bool = ...,
+    auto_attribs: bool = ...,
+    kw_only: bool = ...,
+    cache_hash: bool = ...,
+    auto_exc: bool = ...,
+    eq: Optional[_EqOrderType] = ...,
+    order: Optional[_EqOrderType] = ...,
+    auto_detect: bool = ...,
+    collect_by_mro: bool = ...,
+    getstate_setstate: Optional[bool] = ...,
+    on_setattr: Optional[_OnSetAttrArgType] = ...,
+    field_transformer: Optional[_FieldTransformer] = ...,
+) -> _C: ...
+@overload
+@__dataclass_transform__(order_default=True, field_descriptors=(attrib, field))
+def attrs(
+    maybe_cls: None = ...,
+    these: Optional[Dict[str, Any]] = ...,
+    repr_ns: Optional[str] = ...,
+    repr: bool = ...,
+    cmp: Optional[_EqOrderType] = ...,
+    hash: Optional[bool] = ...,
+    init: bool = ...,
+    slots: bool = ...,
+    frozen: bool = ...,
+    weakref_slot: bool = ...,
+    str: bool = ...,
+    auto_attribs: bool = ...,
+    kw_only: bool = ...,
+    cache_hash: bool = ...,
+    auto_exc: bool = ...,
+    eq: Optional[_EqOrderType] = ...,
+    order: Optional[_EqOrderType] = ...,
+    auto_detect: bool = ...,
+    collect_by_mro: bool = ...,
+    getstate_setstate: Optional[bool] = ...,
+    on_setattr: Optional[_OnSetAttrArgType] = ...,
+    field_transformer: Optional[_FieldTransformer] = ...,
+) -> Callable[[_C], _C]: ...
+@overload
+@__dataclass_transform__(field_descriptors=(attrib, field))
+def define(
+    maybe_cls: _C,
+    *,
+    these: Optional[Dict[str, Any]] = ...,
+    repr: bool = ...,
+    hash: Optional[bool] = ...,
+    init: bool = ...,
+    slots: bool = ...,
+    frozen: bool = ...,
+    weakref_slot: bool = ...,
+    str: bool = ...,
+    auto_attribs: bool = ...,
+    kw_only: bool = ...,
+    cache_hash: bool = ...,
+    auto_exc: bool = ...,
+    eq: Optional[bool] = ...,
+    order: Optional[bool] = ...,
+    auto_detect: bool = ...,
+    getstate_setstate: Optional[bool] = ...,
+    on_setattr: Optional[_OnSetAttrArgType] = ...,
+    field_transformer: Optional[_FieldTransformer] = ...,
+) -> _C: ...
+@overload
+@__dataclass_transform__(field_descriptors=(attrib, field))
+def define(
+    maybe_cls: None = ...,
+    *,
+    these: Optional[Dict[str, Any]] = ...,
+    repr: bool = ...,
+    hash: Optional[bool] = ...,
+    init: bool = ...,
+    slots: bool = ...,
+    frozen: bool = ...,
+    weakref_slot: bool = ...,
+    str: bool = ...,
+    auto_attribs: bool = ...,
+    kw_only: bool = ...,
+    cache_hash: bool = ...,
+    auto_exc: bool = ...,
+    eq: Optional[bool] = ...,
+    order: Optional[bool] = ...,
+    auto_detect: bool = ...,
+    getstate_setstate: Optional[bool] = ...,
+    on_setattr: Optional[_OnSetAttrArgType] = ...,
+    field_transformer: Optional[_FieldTransformer] = ...,
+) -> Callable[[_C], _C]: ...
+
+mutable = define
+frozen = define  # they differ only in their defaults
+
+# TODO: add support for returning NamedTuple from the mypy plugin
+class _Fields(Tuple[Attribute[Any], ...]):
+    def __getattr__(self, name: str) -> Attribute[Any]: ...
+
+def fields(cls: type) -> _Fields: ...
+def fields_dict(cls: type) -> Dict[str, Attribute[Any]]: ...
+def validate(inst: Any) -> None: ...
+def resolve_types(
+    cls: _C,
+    globalns: Optional[Dict[str, Any]] = ...,
+    localns: Optional[Dict[str, Any]] = ...,
+    attribs: Optional[List[Attribute[Any]]] = ...,
+) -> _C: ...
+
+# TODO: add support for returning a proper attrs class from the mypy plugin
+# we use Any instead of _CountingAttr so that e.g. `make_class('Foo',
+# [attr.ib()])` is valid
+def make_class(
+    name: str,
+    attrs: Union[List[str], Tuple[str, ...], Dict[str, Any]],
+    bases: Tuple[type, ...] = ...,
+    repr_ns: Optional[str] = ...,
+    repr: bool = ...,
+    cmp: Optional[_EqOrderType] = ...,
+    hash: Optional[bool] = ...,
+    init: bool = ...,
+    slots: bool = ...,
+    frozen: bool = ...,
+    weakref_slot: bool = ...,
+    str: bool = ...,
+    auto_attribs: bool = ...,
+    kw_only: bool = ...,
+    cache_hash: bool = ...,
+    auto_exc: bool = ...,
+    eq: Optional[_EqOrderType] = ...,
+    order: Optional[_EqOrderType] = ...,
+    collect_by_mro: bool = ...,
+    on_setattr: Optional[_OnSetAttrArgType] = ...,
+    field_transformer: Optional[_FieldTransformer] = ...,
+) -> type: ...
+
+# _funcs --
+
+# TODO: add support for returning TypedDict from the mypy plugin
+# FIXME: asdict/astuple do not honor their factory args. Waiting on one of
+# these:
+# https://github.com/python/mypy/issues/4236
+# https://github.com/python/typing/issues/253
+def asdict(
+    inst: Any,
+    recurse: bool = ...,
+    filter: Optional[_FilterType[Any]] = ...,
+    dict_factory: Type[Mapping[Any, Any]] = ...,
+    retain_collection_types: bool = ...,
+    value_serializer: Optional[Callable[[type, Attribute[Any], Any], Any]] = ...,
+) -> Dict[str, Any]: ...
+
+# TODO: add support for returning NamedTuple from the mypy plugin
+def astuple(
+    inst: Any,
+    recurse: bool = ...,
+    filter: Optional[_FilterType[Any]] = ...,
+    tuple_factory: Type[Sequence[Any]] = ...,
+    retain_collection_types: bool = ...,
+) -> Tuple[Any, ...]: ...
+def has(cls: type) -> bool: ...
+def assoc(inst: _T, **changes: Any) -> _T: ...
+def evolve(inst: _T, **changes: Any) -> _T: ...
+
+# _config --
+
+def set_run_validators(run: bool) -> None: ...
+def get_run_validators() -> bool: ...
+
+# aliases --
+
+s = attributes = attrs
+ib = attr = attrib
+dataclass = attrs  # Technically, partial(attrs, auto_attribs=True) ;)
diff --git a/openpype/hosts/fusion/vendor/attr/_cmp.py b/openpype/hosts/fusion/vendor/attr/_cmp.py
new file mode 100644
index 0000000000..b747b603f1
--- /dev/null
+++ b/openpype/hosts/fusion/vendor/attr/_cmp.py
@@ -0,0 +1,152 @@
+from __future__ import absolute_import, division, print_function
+
+import functools
+
+from ._compat import new_class
+from ._make import _make_ne
+
+
+_operation_names = {"eq": "==", "lt": "<", "le": "<=", "gt": ">", "ge": ">="}
+
+
+def cmp_using(
+    eq=None,
+    lt=None,
+    le=None,
+    gt=None,
+    ge=None,
+    require_same_type=True,
+    class_name="Comparable",
+):
+    """
+    Create a class that can be passed into `attr.ib`'s ``eq``, ``order``, and
+    ``cmp`` arguments to customize field comparison.
+
+    The resulting class will have a full set of ordering methods if
+    at least one of ``{lt, le, gt, ge}`` and ``eq``  are provided.
+
+    :param Optional[callable] eq: `callable` used to evaluate equality
+        of two objects.
+    :param Optional[callable] lt: `callable` used to evaluate whether
+        one object is less than another object.
+    :param Optional[callable] le: `callable` used to evaluate whether
+        one object is less than or equal to another object.
+    :param Optional[callable] gt: `callable` used to evaluate whether
+        one object is greater than another object.
+    :param Optional[callable] ge: `callable` used to evaluate whether
+        one object is greater than or equal to another object.
+
+    :param bool require_same_type: When `True`, equality and ordering methods
+        will return `NotImplemented` if objects are not of the same type.
+
+    :param Optional[str] class_name: Name of class. Defaults to 'Comparable'.
+
+    See `comparison` for more details.
+
+    .. versionadded:: 21.1.0
+    """
+
+    body = {
+        "__slots__": ["value"],
+        "__init__": _make_init(),
+        "_requirements": [],
+        "_is_comparable_to": _is_comparable_to,
+    }
+
+    # Add operations.
+    num_order_functions = 0
+    has_eq_function = False
+
+    if eq is not None:
+        has_eq_function = True
+        body["__eq__"] = _make_operator("eq", eq)
+        body["__ne__"] = _make_ne()
+
+    if lt is not None:
+        num_order_functions += 1
+        body["__lt__"] = _make_operator("lt", lt)
+
+    if le is not None:
+        num_order_functions += 1
+        body["__le__"] = _make_operator("le", le)
+
+    if gt is not None:
+        num_order_functions += 1
+        body["__gt__"] = _make_operator("gt", gt)
+
+    if ge is not None:
+        num_order_functions += 1
+        body["__ge__"] = _make_operator("ge", ge)
+
+    type_ = new_class(class_name, (object,), {}, lambda ns: ns.update(body))
+
+    # Add same type requirement.
+    if require_same_type:
+        type_._requirements.append(_check_same_type)
+
+    # Add total ordering if at least one operation was defined.
+    if 0 < num_order_functions < 4:
+        if not has_eq_function:
+            # functools.total_ordering requires __eq__ to be defined,
+            # so raise early error here to keep a nice stack.
+            raise ValueError(
+                "eq must be define is order to complete ordering from "
+                "lt, le, gt, ge."
+            )
+        type_ = functools.total_ordering(type_)
+
+    return type_
+
+
+def _make_init():
+    """
+    Create __init__ method.
+    """
+
+    def __init__(self, value):
+        """
+        Initialize object with *value*.
+        """
+        self.value = value
+
+    return __init__
+
+
+def _make_operator(name, func):
+    """
+    Create operator method.
+    """
+
+    def method(self, other):
+        if not self._is_comparable_to(other):
+            return NotImplemented
+
+        result = func(self.value, other.value)
+        if result is NotImplemented:
+            return NotImplemented
+
+        return result
+
+    method.__name__ = "__%s__" % (name,)
+    method.__doc__ = "Return a %s b.  Computed by attrs." % (
+        _operation_names[name],
+    )
+
+    return method
+
+
+def _is_comparable_to(self, other):
+    """
+    Check whether `other` is comparable to `self`.
+    """
+    for func in self._requirements:
+        if not func(self, other):
+            return False
+    return True
+
+
+def _check_same_type(self, other):
+    """
+    Return True if *self* and *other* are of the same type, False otherwise.
+    """
+    return other.value.__class__ is self.value.__class__
diff --git a/openpype/hosts/fusion/vendor/attr/_cmp.pyi b/openpype/hosts/fusion/vendor/attr/_cmp.pyi
new file mode 100644
index 0000000000..7093550f0f
--- /dev/null
+++ b/openpype/hosts/fusion/vendor/attr/_cmp.pyi
@@ -0,0 +1,14 @@
+from typing import Type
+
+from . import _CompareWithType
+
+
+def cmp_using(
+    eq: Optional[_CompareWithType],
+    lt: Optional[_CompareWithType],
+    le: Optional[_CompareWithType],
+    gt: Optional[_CompareWithType],
+    ge: Optional[_CompareWithType],
+    require_same_type: bool,
+    class_name: str,
+) -> Type: ...
diff --git a/openpype/hosts/fusion/vendor/attr/_compat.py b/openpype/hosts/fusion/vendor/attr/_compat.py
new file mode 100644
index 0000000000..6939f338da
--- /dev/null
+++ b/openpype/hosts/fusion/vendor/attr/_compat.py
@@ -0,0 +1,242 @@
+from __future__ import absolute_import, division, print_function
+
+import platform
+import sys
+import types
+import warnings
+
+
+PY2 = sys.version_info[0] == 2
+PYPY = platform.python_implementation() == "PyPy"
+
+
+if PYPY or sys.version_info[:2] >= (3, 6):
+    ordered_dict = dict
+else:
+    from collections import OrderedDict
+
+    ordered_dict = OrderedDict
+
+
+if PY2:
+    from collections import Mapping, Sequence
+
+    from UserDict import IterableUserDict
+
+    # We 'bundle' isclass instead of using inspect as importing inspect is
+    # fairly expensive (order of 10-15 ms for a modern machine in 2016)
+    def isclass(klass):
+        return isinstance(klass, (type, types.ClassType))
+
+    def new_class(name, bases, kwds, exec_body):
+        """
+        A minimal stub of types.new_class that we need for make_class.
+        """
+        ns = {}
+        exec_body(ns)
+
+        return type(name, bases, ns)
+
+    # TYPE is used in exceptions, repr(int) is different on Python 2 and 3.
+    TYPE = "type"
+
+    def iteritems(d):
+        return d.iteritems()
+
+    # Python 2 is bereft of a read-only dict proxy, so we make one!
+    class ReadOnlyDict(IterableUserDict):
+        """
+        Best-effort read-only dict wrapper.
+        """
+
+        def __setitem__(self, key, val):
+            # We gently pretend we're a Python 3 mappingproxy.
+            raise TypeError(
+                "'mappingproxy' object does not support item assignment"
+            )
+
+        def update(self, _):
+            # We gently pretend we're a Python 3 mappingproxy.
+            raise AttributeError(
+                "'mappingproxy' object has no attribute 'update'"
+            )
+
+        def __delitem__(self, _):
+            # We gently pretend we're a Python 3 mappingproxy.
+            raise TypeError(
+                "'mappingproxy' object does not support item deletion"
+            )
+
+        def clear(self):
+            # We gently pretend we're a Python 3 mappingproxy.
+            raise AttributeError(
+                "'mappingproxy' object has no attribute 'clear'"
+            )
+
+        def pop(self, key, default=None):
+            # We gently pretend we're a Python 3 mappingproxy.
+            raise AttributeError(
+                "'mappingproxy' object has no attribute 'pop'"
+            )
+
+        def popitem(self):
+            # We gently pretend we're a Python 3 mappingproxy.
+            raise AttributeError(
+                "'mappingproxy' object has no attribute 'popitem'"
+            )
+
+        def setdefault(self, key, default=None):
+            # We gently pretend we're a Python 3 mappingproxy.
+            raise AttributeError(
+                "'mappingproxy' object has no attribute 'setdefault'"
+            )
+
+        def __repr__(self):
+            # Override to be identical to the Python 3 version.
+            return "mappingproxy(" + repr(self.data) + ")"
+
+    def metadata_proxy(d):
+        res = ReadOnlyDict()
+        res.data.update(d)  # We blocked update, so we have to do it like this.
+        return res
+
+    def just_warn(*args, **kw):  # pragma: no cover
+        """
+        We only warn on Python 3 because we are not aware of any concrete
+        consequences of not setting the cell on Python 2.
+        """
+
+
+else:  # Python 3 and later.
+    from collections.abc import Mapping, Sequence  # noqa
+
+    def just_warn(*args, **kw):
+        """
+        We only warn on Python 3 because we are not aware of any concrete
+        consequences of not setting the cell on Python 2.
+        """
+        warnings.warn(
+            "Running interpreter doesn't sufficiently support code object "
+            "introspection.  Some features like bare super() or accessing "
+            "__class__ will not work with slotted classes.",
+            RuntimeWarning,
+            stacklevel=2,
+        )
+
+    def isclass(klass):
+        return isinstance(klass, type)
+
+    TYPE = "class"
+
+    def iteritems(d):
+        return d.items()
+
+    new_class = types.new_class
+
+    def metadata_proxy(d):
+        return types.MappingProxyType(dict(d))
+
+
+def make_set_closure_cell():
+    """Return a function of two arguments (cell, value) which sets
+    the value stored in the closure cell `cell` to `value`.
+    """
+    # pypy makes this easy. (It also supports the logic below, but
+    # why not do the easy/fast thing?)
+    if PYPY:
+
+        def set_closure_cell(cell, value):
+            cell.__setstate__((value,))
+
+        return set_closure_cell
+
+    # Otherwise gotta do it the hard way.
+
+    # Create a function that will set its first cellvar to `value`.
+    def set_first_cellvar_to(value):
+        x = value
+        return
+
+        # This function will be eliminated as dead code, but
+        # not before its reference to `x` forces `x` to be
+        # represented as a closure cell rather than a local.
+        def force_x_to_be_a_cell():  # pragma: no cover
+            return x
+
+    try:
+        # Extract the code object and make sure our assumptions about
+        # the closure behavior are correct.
+        if PY2:
+            co = set_first_cellvar_to.func_code
+        else:
+            co = set_first_cellvar_to.__code__
+        if co.co_cellvars != ("x",) or co.co_freevars != ():
+            raise AssertionError  # pragma: no cover
+
+        # Convert this code object to a code object that sets the
+        # function's first _freevar_ (not cellvar) to the argument.
+        if sys.version_info >= (3, 8):
+            # CPython 3.8+ has an incompatible CodeType signature
+            # (added a posonlyargcount argument) but also added
+            # CodeType.replace() to do this without counting parameters.
+            set_first_freevar_code = co.replace(
+                co_cellvars=co.co_freevars, co_freevars=co.co_cellvars
+            )
+        else:
+            args = [co.co_argcount]
+            if not PY2:
+                args.append(co.co_kwonlyargcount)
+            args.extend(
+                [
+                    co.co_nlocals,
+                    co.co_stacksize,
+                    co.co_flags,
+                    co.co_code,
+                    co.co_consts,
+                    co.co_names,
+                    co.co_varnames,
+                    co.co_filename,
+                    co.co_name,
+                    co.co_firstlineno,
+                    co.co_lnotab,
+                    # These two arguments are reversed:
+                    co.co_cellvars,
+                    co.co_freevars,
+                ]
+            )
+            set_first_freevar_code = types.CodeType(*args)
+
+        def set_closure_cell(cell, value):
+            # Create a function using the set_first_freevar_code,
+            # whose first closure cell is `cell`. Calling it will
+            # change the value of that cell.
+            setter = types.FunctionType(
+                set_first_freevar_code, {}, "setter", (), (cell,)
+            )
+            # And call it to set the cell.
+            setter(value)
+
+        # Make sure it works on this interpreter:
+        def make_func_with_cell():
+            x = None
+
+            def func():
+                return x  # pragma: no cover
+
+            return func
+
+        if PY2:
+            cell = make_func_with_cell().func_closure[0]
+        else:
+            cell = make_func_with_cell().__closure__[0]
+        set_closure_cell(cell, 100)
+        if cell.cell_contents != 100:
+            raise AssertionError  # pragma: no cover
+
+    except Exception:
+        return just_warn
+    else:
+        return set_closure_cell
+
+
+set_closure_cell = make_set_closure_cell()
diff --git a/openpype/hosts/fusion/vendor/attr/_config.py b/openpype/hosts/fusion/vendor/attr/_config.py
new file mode 100644
index 0000000000..8ec920962d
--- /dev/null
+++ b/openpype/hosts/fusion/vendor/attr/_config.py
@@ -0,0 +1,23 @@
+from __future__ import absolute_import, division, print_function
+
+
+__all__ = ["set_run_validators", "get_run_validators"]
+
+_run_validators = True
+
+
+def set_run_validators(run):
+    """
+    Set whether or not validators are run.  By default, they are run.
+    """
+    if not isinstance(run, bool):
+        raise TypeError("'run' must be bool.")
+    global _run_validators
+    _run_validators = run
+
+
+def get_run_validators():
+    """
+    Return whether or not validators are run.
+    """
+    return _run_validators
diff --git a/openpype/hosts/fusion/vendor/attr/_funcs.py b/openpype/hosts/fusion/vendor/attr/_funcs.py
new file mode 100644
index 0000000000..fda508c5c4
--- /dev/null
+++ b/openpype/hosts/fusion/vendor/attr/_funcs.py
@@ -0,0 +1,395 @@
+from __future__ import absolute_import, division, print_function
+
+import copy
+
+from ._compat import iteritems
+from ._make import NOTHING, _obj_setattr, fields
+from .exceptions import AttrsAttributeNotFoundError
+
+
+def asdict(
+    inst,
+    recurse=True,
+    filter=None,
+    dict_factory=dict,
+    retain_collection_types=False,
+    value_serializer=None,
+):
+    """
+    Return the ``attrs`` attribute values of *inst* as a dict.
+
+    Optionally recurse into other ``attrs``-decorated classes.
+
+    :param inst: Instance of an ``attrs``-decorated class.
+    :param bool recurse: Recurse into classes that are also
+        ``attrs``-decorated.
+    :param callable filter: A callable whose return code determines whether an
+        attribute or element is included (``True``) or dropped (``False``).  Is
+        called with the `attr.Attribute` as the first argument and the
+        value as the second argument.
+    :param callable dict_factory: A callable to produce dictionaries from.  For
+        example, to produce ordered dictionaries instead of normal Python
+        dictionaries, pass in ``collections.OrderedDict``.
+    :param bool retain_collection_types: Do not convert to ``list`` when
+        encountering an attribute whose type is ``tuple`` or ``set``.  Only
+        meaningful if ``recurse`` is ``True``.
+    :param Optional[callable] value_serializer: A hook that is called for every
+        attribute or dict key/value.  It receives the current instance, field
+        and value and must return the (updated) value.  The hook is run *after*
+        the optional *filter* has been applied.
+
+    :rtype: return type of *dict_factory*
+
+    :raise attr.exceptions.NotAnAttrsClassError: If *cls* is not an ``attrs``
+        class.
+
+    ..  versionadded:: 16.0.0 *dict_factory*
+    ..  versionadded:: 16.1.0 *retain_collection_types*
+    ..  versionadded:: 20.3.0 *value_serializer*
+    """
+    attrs = fields(inst.__class__)
+    rv = dict_factory()
+    for a in attrs:
+        v = getattr(inst, a.name)
+        if filter is not None and not filter(a, v):
+            continue
+
+        if value_serializer is not None:
+            v = value_serializer(inst, a, v)
+
+        if recurse is True:
+            if has(v.__class__):
+                rv[a.name] = asdict(
+                    v,
+                    True,
+                    filter,
+                    dict_factory,
+                    retain_collection_types,
+                    value_serializer,
+                )
+            elif isinstance(v, (tuple, list, set, frozenset)):
+                cf = v.__class__ if retain_collection_types is True else list
+                rv[a.name] = cf(
+                    [
+                        _asdict_anything(
+                            i,
+                            filter,
+                            dict_factory,
+                            retain_collection_types,
+                            value_serializer,
+                        )
+                        for i in v
+                    ]
+                )
+            elif isinstance(v, dict):
+                df = dict_factory
+                rv[a.name] = df(
+                    (
+                        _asdict_anything(
+                            kk,
+                            filter,
+                            df,
+                            retain_collection_types,
+                            value_serializer,
+                        ),
+                        _asdict_anything(
+                            vv,
+                            filter,
+                            df,
+                            retain_collection_types,
+                            value_serializer,
+                        ),
+                    )
+                    for kk, vv in iteritems(v)
+                )
+            else:
+                rv[a.name] = v
+        else:
+            rv[a.name] = v
+    return rv
+
+
+def _asdict_anything(
+    val,
+    filter,
+    dict_factory,
+    retain_collection_types,
+    value_serializer,
+):
+    """
+    ``asdict`` only works on attrs instances, this works on anything.
+    """
+    if getattr(val.__class__, "__attrs_attrs__", None) is not None:
+        # Attrs class.
+        rv = asdict(
+            val,
+            True,
+            filter,
+            dict_factory,
+            retain_collection_types,
+            value_serializer,
+        )
+    elif isinstance(val, (tuple, list, set, frozenset)):
+        cf = val.__class__ if retain_collection_types is True else list
+        rv = cf(
+            [
+                _asdict_anything(
+                    i,
+                    filter,
+                    dict_factory,
+                    retain_collection_types,
+                    value_serializer,
+                )
+                for i in val
+            ]
+        )
+    elif isinstance(val, dict):
+        df = dict_factory
+        rv = df(
+            (
+                _asdict_anything(
+                    kk, filter, df, retain_collection_types, value_serializer
+                ),
+                _asdict_anything(
+                    vv, filter, df, retain_collection_types, value_serializer
+                ),
+            )
+            for kk, vv in iteritems(val)
+        )
+    else:
+        rv = val
+        if value_serializer is not None:
+            rv = value_serializer(None, None, rv)
+
+    return rv
+
+
+def astuple(
+    inst,
+    recurse=True,
+    filter=None,
+    tuple_factory=tuple,
+    retain_collection_types=False,
+):
+    """
+    Return the ``attrs`` attribute values of *inst* as a tuple.
+
+    Optionally recurse into other ``attrs``-decorated classes.
+
+    :param inst: Instance of an ``attrs``-decorated class.
+    :param bool recurse: Recurse into classes that are also
+        ``attrs``-decorated.
+    :param callable filter: A callable whose return code determines whether an
+        attribute or element is included (``True``) or dropped (``False``).  Is
+        called with the `attr.Attribute` as the first argument and the
+        value as the second argument.
+    :param callable tuple_factory: A callable to produce tuples from.  For
+        example, to produce lists instead of tuples.
+    :param bool retain_collection_types: Do not convert to ``list``
+        or ``dict`` when encountering an attribute which type is
+        ``tuple``, ``dict`` or ``set``.  Only meaningful if ``recurse`` is
+        ``True``.
+
+    :rtype: return type of *tuple_factory*
+
+    :raise attr.exceptions.NotAnAttrsClassError: If *cls* is not an ``attrs``
+        class.
+
+    ..  versionadded:: 16.2.0
+    """
+    attrs = fields(inst.__class__)
+    rv = []
+    retain = retain_collection_types  # Very long. :/
+    for a in attrs:
+        v = getattr(inst, a.name)
+        if filter is not None and not filter(a, v):
+            continue
+        if recurse is True:
+            if has(v.__class__):
+                rv.append(
+                    astuple(
+                        v,
+                        recurse=True,
+                        filter=filter,
+                        tuple_factory=tuple_factory,
+                        retain_collection_types=retain,
+                    )
+                )
+            elif isinstance(v, (tuple, list, set, frozenset)):
+                cf = v.__class__ if retain is True else list
+                rv.append(
+                    cf(
+                        [
+                            astuple(
+                                j,
+                                recurse=True,
+                                filter=filter,
+                                tuple_factory=tuple_factory,
+                                retain_collection_types=retain,
+                            )
+                            if has(j.__class__)
+                            else j
+                            for j in v
+                        ]
+                    )
+                )
+            elif isinstance(v, dict):
+                df = v.__class__ if retain is True else dict
+                rv.append(
+                    df(
+                        (
+                            astuple(
+                                kk,
+                                tuple_factory=tuple_factory,
+                                retain_collection_types=retain,
+                            )
+                            if has(kk.__class__)
+                            else kk,
+                            astuple(
+                                vv,
+                                tuple_factory=tuple_factory,
+                                retain_collection_types=retain,
+                            )
+                            if has(vv.__class__)
+                            else vv,
+                        )
+                        for kk, vv in iteritems(v)
+                    )
+                )
+            else:
+                rv.append(v)
+        else:
+            rv.append(v)
+
+    return rv if tuple_factory is list else tuple_factory(rv)
+
+
+def has(cls):
+    """
+    Check whether *cls* is a class with ``attrs`` attributes.
+
+    :param type cls: Class to introspect.
+    :raise TypeError: If *cls* is not a class.
+
+    :rtype: bool
+    """
+    return getattr(cls, "__attrs_attrs__", None) is not None
+
+
+def assoc(inst, **changes):
+    """
+    Copy *inst* and apply *changes*.
+
+    :param inst: Instance of a class with ``attrs`` attributes.
+    :param changes: Keyword changes in the new copy.
+
+    :return: A copy of inst with *changes* incorporated.
+
+    :raise attr.exceptions.AttrsAttributeNotFoundError: If *attr_name* couldn't
+        be found on *cls*.
+    :raise attr.exceptions.NotAnAttrsClassError: If *cls* is not an ``attrs``
+        class.
+
+    ..  deprecated:: 17.1.0
+        Use `evolve` instead.
+    """
+    import warnings
+
+    warnings.warn(
+        "assoc is deprecated and will be removed after 2018/01.",
+        DeprecationWarning,
+        stacklevel=2,
+    )
+    new = copy.copy(inst)
+    attrs = fields(inst.__class__)
+    for k, v in iteritems(changes):
+        a = getattr(attrs, k, NOTHING)
+        if a is NOTHING:
+            raise AttrsAttributeNotFoundError(
+                "{k} is not an attrs attribute on {cl}.".format(
+                    k=k, cl=new.__class__
+                )
+            )
+        _obj_setattr(new, k, v)
+    return new
+
+
+def evolve(inst, **changes):
+    """
+    Create a new instance, based on *inst* with *changes* applied.
+
+    :param inst: Instance of a class with ``attrs`` attributes.
+    :param changes: Keyword changes in the new copy.
+
+    :return: A copy of inst with *changes* incorporated.
+
+    :raise TypeError: If *attr_name* couldn't be found in the class
+        ``__init__``.
+    :raise attr.exceptions.NotAnAttrsClassError: If *cls* is not an ``attrs``
+        class.
+
+    ..  versionadded:: 17.1.0
+    """
+    cls = inst.__class__
+    attrs = fields(cls)
+    for a in attrs:
+        if not a.init:
+            continue
+        attr_name = a.name  # To deal with private attributes.
+        init_name = attr_name if attr_name[0] != "_" else attr_name[1:]
+        if init_name not in changes:
+            changes[init_name] = getattr(inst, attr_name)
+
+    return cls(**changes)
+
+
+def resolve_types(cls, globalns=None, localns=None, attribs=None):
+    """
+    Resolve any strings and forward annotations in type annotations.
+
+    This is only required if you need concrete types in `Attribute`'s *type*
+    field. In other words, you don't need to resolve your types if you only
+    use them for static type checking.
+
+    With no arguments, names will be looked up in the module in which the class
+    was created. If this is not what you want, e.g. if the name only exists
+    inside a method, you may pass *globalns* or *localns* to specify other
+    dictionaries in which to look up these names. See the docs of
+    `typing.get_type_hints` for more details.
+
+    :param type cls: Class to resolve.
+    :param Optional[dict] globalns: Dictionary containing global variables.
+    :param Optional[dict] localns: Dictionary containing local variables.
+    :param Optional[list] attribs: List of attribs for the given class.
+        This is necessary when calling from inside a ``field_transformer``
+        since *cls* is not an ``attrs`` class yet.
+
+    :raise TypeError: If *cls* is not a class.
+    :raise attr.exceptions.NotAnAttrsClassError: If *cls* is not an ``attrs``
+        class and you didn't pass any attribs.
+    :raise NameError: If types cannot be resolved because of missing variables.
+
+    :returns: *cls* so you can use this function also as a class decorator.
+        Please note that you have to apply it **after** `attr.s`. That means
+        the decorator has to come in the line **before** `attr.s`.
+
+    ..  versionadded:: 20.1.0
+    ..  versionadded:: 21.1.0 *attribs*
+
+    """
+    try:
+        # Since calling get_type_hints is expensive we cache whether we've
+        # done it already.
+        cls.__attrs_types_resolved__
+    except AttributeError:
+        import typing
+
+        hints = typing.get_type_hints(cls, globalns=globalns, localns=localns)
+        for field in fields(cls) if attribs is None else attribs:
+            if field.name in hints:
+                # Since fields have been frozen we must work around it.
+                _obj_setattr(field, "type", hints[field.name])
+        cls.__attrs_types_resolved__ = True
+
+    # Return the class so you can use it as a decorator too.
+    return cls
diff --git a/openpype/hosts/fusion/vendor/attr/_make.py b/openpype/hosts/fusion/vendor/attr/_make.py
new file mode 100644
index 0000000000..a1912b1233
--- /dev/null
+++ b/openpype/hosts/fusion/vendor/attr/_make.py
@@ -0,0 +1,3052 @@
+from __future__ import absolute_import, division, print_function
+
+import copy
+import inspect
+import linecache
+import sys
+import threading
+import uuid
+import warnings
+
+from operator import itemgetter
+
+from . import _config, setters
+from ._compat import (
+    PY2,
+    PYPY,
+    isclass,
+    iteritems,
+    metadata_proxy,
+    new_class,
+    ordered_dict,
+    set_closure_cell,
+)
+from .exceptions import (
+    DefaultAlreadySetError,
+    FrozenInstanceError,
+    NotAnAttrsClassError,
+    PythonTooOldError,
+    UnannotatedAttributeError,
+)
+
+
+if not PY2:
+    import typing
+
+
+# This is used at least twice, so cache it here.
+_obj_setattr = object.__setattr__
+_init_converter_pat = "__attr_converter_%s"
+_init_factory_pat = "__attr_factory_{}"
+_tuple_property_pat = (
+    "    {attr_name} = _attrs_property(_attrs_itemgetter({index}))"
+)
+_classvar_prefixes = (
+    "typing.ClassVar",
+    "t.ClassVar",
+    "ClassVar",
+    "typing_extensions.ClassVar",
+)
+# we don't use a double-underscore prefix because that triggers
+# name mangling when trying to create a slot for the field
+# (when slots=True)
+_hash_cache_field = "_attrs_cached_hash"
+
+_empty_metadata_singleton = metadata_proxy({})
+
+# Unique object for unequivocal getattr() defaults.
+_sentinel = object()
+
+
+class _Nothing(object):
+    """
+    Sentinel class to indicate the lack of a value when ``None`` is ambiguous.
+
+    ``_Nothing`` is a singleton. There is only ever one of it.
+
+    .. versionchanged:: 21.1.0 ``bool(NOTHING)`` is now False.
+    """
+
+    _singleton = None
+
+    def __new__(cls):
+        if _Nothing._singleton is None:
+            _Nothing._singleton = super(_Nothing, cls).__new__(cls)
+        return _Nothing._singleton
+
+    def __repr__(self):
+        return "NOTHING"
+
+    def __bool__(self):
+        return False
+
+    def __len__(self):
+        return 0  # __bool__ for Python 2
+
+
+NOTHING = _Nothing()
+"""
+Sentinel to indicate the lack of a value when ``None`` is ambiguous.
+"""
+
+
+class _CacheHashWrapper(int):
+    """
+    An integer subclass that pickles / copies as None
+
+    This is used for non-slots classes with ``cache_hash=True``, to avoid
+    serializing a potentially (even likely) invalid hash value. Since ``None``
+    is the default value for uncalculated hashes, whenever this is copied,
+    the copy's value for the hash should automatically reset.
+
+    See GH #613 for more details.
+    """
+
+    if PY2:
+        # For some reason `type(None)` isn't callable in Python 2, but we don't
+        # actually need a constructor for None objects, we just need any
+        # available function that returns None.
+        def __reduce__(self, _none_constructor=getattr, _args=(0, "", None)):
+            return _none_constructor, _args
+
+    else:
+
+        def __reduce__(self, _none_constructor=type(None), _args=()):
+            return _none_constructor, _args
+
+
+def attrib(
+    default=NOTHING,
+    validator=None,
+    repr=True,
+    cmp=None,
+    hash=None,
+    init=True,
+    metadata=None,
+    type=None,
+    converter=None,
+    factory=None,
+    kw_only=False,
+    eq=None,
+    order=None,
+    on_setattr=None,
+):
+    """
+    Create a new attribute on a class.
+
+    ..  warning::
+
+        Does *not* do anything unless the class is also decorated with
+        `attr.s`!
+
+    :param default: A value that is used if an ``attrs``-generated ``__init__``
+        is used and no value is passed while instantiating or the attribute is
+        excluded using ``init=False``.
+
+        If the value is an instance of `Factory`, its callable will be
+        used to construct a new value (useful for mutable data types like lists
+        or dicts).
+
+        If a default is not set (or set manually to `attr.NOTHING`), a value
+        *must* be supplied when instantiating; otherwise a `TypeError`
+        will be raised.
+
+        The default can also be set using decorator notation as shown below.
+
+    :type default: Any value
+
+    :param callable factory: Syntactic sugar for
+        ``default=attr.Factory(factory)``.
+
+    :param validator: `callable` that is called by ``attrs``-generated
+        ``__init__`` methods after the instance has been initialized.  They
+        receive the initialized instance, the `Attribute`, and the
+        passed value.
+
+        The return value is *not* inspected so the validator has to throw an
+        exception itself.
+
+        If a `list` is passed, its items are treated as validators and must
+        all pass.
+
+        Validators can be globally disabled and re-enabled using
+        `get_run_validators`.
+
+        The validator can also be set using decorator notation as shown below.
+
+    :type validator: `callable` or a `list` of `callable`\\ s.
+
+    :param repr: Include this attribute in the generated ``__repr__``
+        method. If ``True``, include the attribute; if ``False``, omit it. By
+        default, the built-in ``repr()`` function is used. To override how the
+        attribute value is formatted, pass a ``callable`` that takes a single
+        value and returns a string. Note that the resulting string is used
+        as-is, i.e. it will be used directly *instead* of calling ``repr()``
+        (the default).
+    :type repr: a `bool` or a `callable` to use a custom function.
+
+    :param eq: If ``True`` (default), include this attribute in the
+        generated ``__eq__`` and ``__ne__`` methods that check two instances
+        for equality. To override how the attribute value is compared,
+        pass a ``callable`` that takes a single value and returns the value
+        to be compared.
+    :type eq: a `bool` or a `callable`.
+
+    :param order: If ``True`` (default), include this attributes in the
+        generated ``__lt__``, ``__le__``, ``__gt__`` and ``__ge__`` methods.
+        To override how the attribute value is ordered,
+        pass a ``callable`` that takes a single value and returns the value
+        to be ordered.
+    :type order: a `bool` or a `callable`.
+
+    :param cmp: Setting *cmp* is equivalent to setting *eq* and *order* to the
+        same value. Must not be mixed with *eq* or *order*.
+    :type cmp: a `bool` or a `callable`.
+
+    :param Optional[bool] hash: Include this attribute in the generated
+        ``__hash__`` method.  If ``None`` (default), mirror *eq*'s value.  This
+        is the correct behavior according the Python spec.  Setting this value
+        to anything else than ``None`` is *discouraged*.
+    :param bool init: Include this attribute in the generated ``__init__``
+        method.  It is possible to set this to ``False`` and set a default
+        value.  In that case this attributed is unconditionally initialized
+        with the specified default value or factory.
+    :param callable converter: `callable` that is called by
+        ``attrs``-generated ``__init__`` methods to convert attribute's value
+        to the desired format.  It is given the passed-in value, and the
+        returned value will be used as the new value of the attribute.  The
+        value is converted before being passed to the validator, if any.
+    :param metadata: An arbitrary mapping, to be used by third-party
+        components.  See `extending_metadata`.
+    :param type: The type of the attribute.  In Python 3.6 or greater, the
+        preferred method to specify the type is using a variable annotation
+        (see `PEP 526 <https://www.python.org/dev/peps/pep-0526/>`_).
+        This argument is provided for backward compatibility.
+        Regardless of the approach used, the type will be stored on
+        ``Attribute.type``.
+
+        Please note that ``attrs`` doesn't do anything with this metadata by
+        itself. You can use it as part of your own code or for
+        `static type checking <types>`.
+    :param kw_only: Make this attribute keyword-only (Python 3+)
+        in the generated ``__init__`` (if ``init`` is ``False``, this
+        parameter is ignored).
+    :param on_setattr: Allows to overwrite the *on_setattr* setting from
+        `attr.s`. If left `None`, the *on_setattr* value from `attr.s` is used.
+        Set to `attr.setters.NO_OP` to run **no** `setattr` hooks for this
+        attribute -- regardless of the setting in `attr.s`.
+    :type on_setattr: `callable`, or a list of callables, or `None`, or
+        `attr.setters.NO_OP`
+
+    .. versionadded:: 15.2.0 *convert*
+    .. versionadded:: 16.3.0 *metadata*
+    .. versionchanged:: 17.1.0 *validator* can be a ``list`` now.
+    .. versionchanged:: 17.1.0
+       *hash* is ``None`` and therefore mirrors *eq* by default.
+    .. versionadded:: 17.3.0 *type*
+    .. deprecated:: 17.4.0 *convert*
+    .. versionadded:: 17.4.0 *converter* as a replacement for the deprecated
+       *convert* to achieve consistency with other noun-based arguments.
+    .. versionadded:: 18.1.0
+       ``factory=f`` is syntactic sugar for ``default=attr.Factory(f)``.
+    .. versionadded:: 18.2.0 *kw_only*
+    .. versionchanged:: 19.2.0 *convert* keyword argument removed.
+    .. versionchanged:: 19.2.0 *repr* also accepts a custom callable.
+    .. deprecated:: 19.2.0 *cmp* Removal on or after 2021-06-01.
+    .. versionadded:: 19.2.0 *eq* and *order*
+    .. versionadded:: 20.1.0 *on_setattr*
+    .. versionchanged:: 20.3.0 *kw_only* backported to Python 2
+    .. versionchanged:: 21.1.0
+       *eq*, *order*, and *cmp* also accept a custom callable
+    .. versionchanged:: 21.1.0 *cmp* undeprecated
+    """
+    eq, eq_key, order, order_key = _determine_attrib_eq_order(
+        cmp, eq, order, True
+    )
+
+    if hash is not None and hash is not True and hash is not False:
+        raise TypeError(
+            "Invalid value for hash.  Must be True, False, or None."
+        )
+
+    if factory is not None:
+        if default is not NOTHING:
+            raise ValueError(
+                "The `default` and `factory` arguments are mutually "
+                "exclusive."
+            )
+        if not callable(factory):
+            raise ValueError("The `factory` argument must be a callable.")
+        default = Factory(factory)
+
+    if metadata is None:
+        metadata = {}
+
+    # Apply syntactic sugar by auto-wrapping.
+    if isinstance(on_setattr, (list, tuple)):
+        on_setattr = setters.pipe(*on_setattr)
+
+    if validator and isinstance(validator, (list, tuple)):
+        validator = and_(*validator)
+
+    if converter and isinstance(converter, (list, tuple)):
+        converter = pipe(*converter)
+
+    return _CountingAttr(
+        default=default,
+        validator=validator,
+        repr=repr,
+        cmp=None,
+        hash=hash,
+        init=init,
+        converter=converter,
+        metadata=metadata,
+        type=type,
+        kw_only=kw_only,
+        eq=eq,
+        eq_key=eq_key,
+        order=order,
+        order_key=order_key,
+        on_setattr=on_setattr,
+    )
+
+
+def _compile_and_eval(script, globs, locs=None, filename=""):
+    """
+    "Exec" the script with the given global (globs) and local (locs) variables.
+    """
+    bytecode = compile(script, filename, "exec")
+    eval(bytecode, globs, locs)
+
+
+def _make_method(name, script, filename, globs=None):
+    """
+    Create the method with the script given and return the method object.
+    """
+    locs = {}
+    if globs is None:
+        globs = {}
+
+    _compile_and_eval(script, globs, locs, filename)
+
+    # In order of debuggers like PDB being able to step through the code,
+    # we add a fake linecache entry.
+    linecache.cache[filename] = (
+        len(script),
+        None,
+        script.splitlines(True),
+        filename,
+    )
+
+    return locs[name]
+
+
+def _make_attr_tuple_class(cls_name, attr_names):
+    """
+    Create a tuple subclass to hold `Attribute`s for an `attrs` class.
+
+    The subclass is a bare tuple with properties for names.
+
+    class MyClassAttributes(tuple):
+        __slots__ = ()
+        x = property(itemgetter(0))
+    """
+    attr_class_name = "{}Attributes".format(cls_name)
+    attr_class_template = [
+        "class {}(tuple):".format(attr_class_name),
+        "    __slots__ = ()",
+    ]
+    if attr_names:
+        for i, attr_name in enumerate(attr_names):
+            attr_class_template.append(
+                _tuple_property_pat.format(index=i, attr_name=attr_name)
+            )
+    else:
+        attr_class_template.append("    pass")
+    globs = {"_attrs_itemgetter": itemgetter, "_attrs_property": property}
+    _compile_and_eval("\n".join(attr_class_template), globs)
+    return globs[attr_class_name]
+
+
+# Tuple class for extracted attributes from a class definition.
+# `base_attrs` is a subset of `attrs`.
+_Attributes = _make_attr_tuple_class(
+    "_Attributes",
+    [
+        # all attributes to build dunder methods for
+        "attrs",
+        # attributes that have been inherited
+        "base_attrs",
+        # map inherited attributes to their originating classes
+        "base_attrs_map",
+    ],
+)
+
+
+def _is_class_var(annot):
+    """
+    Check whether *annot* is a typing.ClassVar.
+
+    The string comparison hack is used to avoid evaluating all string
+    annotations which would put attrs-based classes at a performance
+    disadvantage compared to plain old classes.
+    """
+    annot = str(annot)
+
+    # Annotation can be quoted.
+    if annot.startswith(("'", '"')) and annot.endswith(("'", '"')):
+        annot = annot[1:-1]
+
+    return annot.startswith(_classvar_prefixes)
+
+
+def _has_own_attribute(cls, attrib_name):
+    """
+    Check whether *cls* defines *attrib_name* (and doesn't just inherit it).
+
+    Requires Python 3.
+    """
+    attr = getattr(cls, attrib_name, _sentinel)
+    if attr is _sentinel:
+        return False
+
+    for base_cls in cls.__mro__[1:]:
+        a = getattr(base_cls, attrib_name, None)
+        if attr is a:
+            return False
+
+    return True
+
+
+def _get_annotations(cls):
+    """
+    Get annotations for *cls*.
+    """
+    if _has_own_attribute(cls, "__annotations__"):
+        return cls.__annotations__
+
+    return {}
+
+
+def _counter_getter(e):
+    """
+    Key function for sorting to avoid re-creating a lambda for every class.
+    """
+    return e[1].counter
+
+
+def _collect_base_attrs(cls, taken_attr_names):
+    """
+    Collect attr.ibs from base classes of *cls*, except *taken_attr_names*.
+    """
+    base_attrs = []
+    base_attr_map = {}  # A dictionary of base attrs to their classes.
+
+    # Traverse the MRO and collect attributes.
+    for base_cls in reversed(cls.__mro__[1:-1]):
+        for a in getattr(base_cls, "__attrs_attrs__", []):
+            if a.inherited or a.name in taken_attr_names:
+                continue
+
+            a = a.evolve(inherited=True)
+            base_attrs.append(a)
+            base_attr_map[a.name] = base_cls
+
+    # For each name, only keep the freshest definition i.e. the furthest at the
+    # back.  base_attr_map is fine because it gets overwritten with every new
+    # instance.
+    filtered = []
+    seen = set()
+    for a in reversed(base_attrs):
+        if a.name in seen:
+            continue
+        filtered.insert(0, a)
+        seen.add(a.name)
+
+    return filtered, base_attr_map
+
+
+def _collect_base_attrs_broken(cls, taken_attr_names):
+    """
+    Collect attr.ibs from base classes of *cls*, except *taken_attr_names*.
+
+    N.B. *taken_attr_names* will be mutated.
+
+    Adhere to the old incorrect behavior.
+
+    Notably it collects from the front and considers inherited attributes which
+    leads to the buggy behavior reported in #428.
+    """
+    base_attrs = []
+    base_attr_map = {}  # A dictionary of base attrs to their classes.
+
+    # Traverse the MRO and collect attributes.
+    for base_cls in cls.__mro__[1:-1]:
+        for a in getattr(base_cls, "__attrs_attrs__", []):
+            if a.name in taken_attr_names:
+                continue
+
+            a = a.evolve(inherited=True)
+            taken_attr_names.add(a.name)
+            base_attrs.append(a)
+            base_attr_map[a.name] = base_cls
+
+    return base_attrs, base_attr_map
+
+
+def _transform_attrs(
+    cls, these, auto_attribs, kw_only, collect_by_mro, field_transformer
+):
+    """
+    Transform all `_CountingAttr`s on a class into `Attribute`s.
+
+    If *these* is passed, use that and don't look for them on the class.
+
+    *collect_by_mro* is True, collect them in the correct MRO order, otherwise
+    use the old -- incorrect -- order.  See #428.
+
+    Return an `_Attributes`.
+    """
+    cd = cls.__dict__
+    anns = _get_annotations(cls)
+
+    if these is not None:
+        ca_list = [(name, ca) for name, ca in iteritems(these)]
+
+        if not isinstance(these, ordered_dict):
+            ca_list.sort(key=_counter_getter)
+    elif auto_attribs is True:
+        ca_names = {
+            name
+            for name, attr in cd.items()
+            if isinstance(attr, _CountingAttr)
+        }
+        ca_list = []
+        annot_names = set()
+        for attr_name, type in anns.items():
+            if _is_class_var(type):
+                continue
+            annot_names.add(attr_name)
+            a = cd.get(attr_name, NOTHING)
+
+            if not isinstance(a, _CountingAttr):
+                if a is NOTHING:
+                    a = attrib()
+                else:
+                    a = attrib(default=a)
+            ca_list.append((attr_name, a))
+
+        unannotated = ca_names - annot_names
+        if len(unannotated) > 0:
+            raise UnannotatedAttributeError(
+                "The following `attr.ib`s lack a type annotation: "
+                + ", ".join(
+                    sorted(unannotated, key=lambda n: cd.get(n).counter)
+                )
+                + "."
+            )
+    else:
+        ca_list = sorted(
+            (
+                (name, attr)
+                for name, attr in cd.items()
+                if isinstance(attr, _CountingAttr)
+            ),
+            key=lambda e: e[1].counter,
+        )
+
+    own_attrs = [
+        Attribute.from_counting_attr(
+            name=attr_name, ca=ca, type=anns.get(attr_name)
+        )
+        for attr_name, ca in ca_list
+    ]
+
+    if collect_by_mro:
+        base_attrs, base_attr_map = _collect_base_attrs(
+            cls, {a.name for a in own_attrs}
+        )
+    else:
+        base_attrs, base_attr_map = _collect_base_attrs_broken(
+            cls, {a.name for a in own_attrs}
+        )
+
+    attr_names = [a.name for a in base_attrs + own_attrs]
+
+    AttrsClass = _make_attr_tuple_class(cls.__name__, attr_names)
+
+    if kw_only:
+        own_attrs = [a.evolve(kw_only=True) for a in own_attrs]
+        base_attrs = [a.evolve(kw_only=True) for a in base_attrs]
+
+    attrs = AttrsClass(base_attrs + own_attrs)
+
+    # Mandatory vs non-mandatory attr order only matters when they are part of
+    # the __init__ signature and when they aren't kw_only (which are moved to
+    # the end and can be mandatory or non-mandatory in any order, as they will
+    # be specified as keyword args anyway). Check the order of those attrs:
+    had_default = False
+    for a in (a for a in attrs if a.init is not False and a.kw_only is False):
+        if had_default is True and a.default is NOTHING:
+            raise ValueError(
+                "No mandatory attributes allowed after an attribute with a "
+                "default value or factory.  Attribute in question: %r" % (a,)
+            )
+
+        if had_default is False and a.default is not NOTHING:
+            had_default = True
+
+    if field_transformer is not None:
+        attrs = field_transformer(cls, attrs)
+    return _Attributes((attrs, base_attrs, base_attr_map))
+
+
+if PYPY:
+
+    def _frozen_setattrs(self, name, value):
+        """
+        Attached to frozen classes as __setattr__.
+        """
+        if isinstance(self, BaseException) and name in (
+            "__cause__",
+            "__context__",
+        ):
+            BaseException.__setattr__(self, name, value)
+            return
+
+        raise FrozenInstanceError()
+
+
+else:
+
+    def _frozen_setattrs(self, name, value):
+        """
+        Attached to frozen classes as __setattr__.
+        """
+        raise FrozenInstanceError()
+
+
+def _frozen_delattrs(self, name):
+    """
+    Attached to frozen classes as __delattr__.
+    """
+    raise FrozenInstanceError()
+
+
+class _ClassBuilder(object):
+    """
+    Iteratively build *one* class.
+    """
+
+    __slots__ = (
+        "_attr_names",
+        "_attrs",
+        "_base_attr_map",
+        "_base_names",
+        "_cache_hash",
+        "_cls",
+        "_cls_dict",
+        "_delete_attribs",
+        "_frozen",
+        "_has_pre_init",
+        "_has_post_init",
+        "_is_exc",
+        "_on_setattr",
+        "_slots",
+        "_weakref_slot",
+        "_has_own_setattr",
+        "_has_custom_setattr",
+    )
+
+    def __init__(
+        self,
+        cls,
+        these,
+        slots,
+        frozen,
+        weakref_slot,
+        getstate_setstate,
+        auto_attribs,
+        kw_only,
+        cache_hash,
+        is_exc,
+        collect_by_mro,
+        on_setattr,
+        has_custom_setattr,
+        field_transformer,
+    ):
+        attrs, base_attrs, base_map = _transform_attrs(
+            cls,
+            these,
+            auto_attribs,
+            kw_only,
+            collect_by_mro,
+            field_transformer,
+        )
+
+        self._cls = cls
+        self._cls_dict = dict(cls.__dict__) if slots else {}
+        self._attrs = attrs
+        self._base_names = set(a.name for a in base_attrs)
+        self._base_attr_map = base_map
+        self._attr_names = tuple(a.name for a in attrs)
+        self._slots = slots
+        self._frozen = frozen
+        self._weakref_slot = weakref_slot
+        self._cache_hash = cache_hash
+        self._has_pre_init = bool(getattr(cls, "__attrs_pre_init__", False))
+        self._has_post_init = bool(getattr(cls, "__attrs_post_init__", False))
+        self._delete_attribs = not bool(these)
+        self._is_exc = is_exc
+        self._on_setattr = on_setattr
+
+        self._has_custom_setattr = has_custom_setattr
+        self._has_own_setattr = False
+
+        self._cls_dict["__attrs_attrs__"] = self._attrs
+
+        if frozen:
+            self._cls_dict["__setattr__"] = _frozen_setattrs
+            self._cls_dict["__delattr__"] = _frozen_delattrs
+
+            self._has_own_setattr = True
+
+        if getstate_setstate:
+            (
+                self._cls_dict["__getstate__"],
+                self._cls_dict["__setstate__"],
+            ) = self._make_getstate_setstate()
+
+    def __repr__(self):
+        return "<_ClassBuilder(cls={cls})>".format(cls=self._cls.__name__)
+
+    def build_class(self):
+        """
+        Finalize class based on the accumulated configuration.
+
+        Builder cannot be used after calling this method.
+        """
+        if self._slots is True:
+            return self._create_slots_class()
+        else:
+            return self._patch_original_class()
+
+    def _patch_original_class(self):
+        """
+        Apply accumulated methods and return the class.
+        """
+        cls = self._cls
+        base_names = self._base_names
+
+        # Clean class of attribute definitions (`attr.ib()`s).
+        if self._delete_attribs:
+            for name in self._attr_names:
+                if (
+                    name not in base_names
+                    and getattr(cls, name, _sentinel) is not _sentinel
+                ):
+                    try:
+                        delattr(cls, name)
+                    except AttributeError:
+                        # This can happen if a base class defines a class
+                        # variable and we want to set an attribute with the
+                        # same name by using only a type annotation.
+                        pass
+
+        # Attach our dunder methods.
+        for name, value in self._cls_dict.items():
+            setattr(cls, name, value)
+
+        # If we've inherited an attrs __setattr__ and don't write our own,
+        # reset it to object's.
+        if not self._has_own_setattr and getattr(
+            cls, "__attrs_own_setattr__", False
+        ):
+            cls.__attrs_own_setattr__ = False
+
+            if not self._has_custom_setattr:
+                cls.__setattr__ = object.__setattr__
+
+        return cls
+
+    def _create_slots_class(self):
+        """
+        Build and return a new class with a `__slots__` attribute.
+        """
+        cd = {
+            k: v
+            for k, v in iteritems(self._cls_dict)
+            if k not in tuple(self._attr_names) + ("__dict__", "__weakref__")
+        }
+
+        # If our class doesn't have its own implementation of __setattr__
+        # (either from the user or by us), check the bases, if one of them has
+        # an attrs-made __setattr__, that needs to be reset. We don't walk the
+        # MRO because we only care about our immediate base classes.
+        # XXX: This can be confused by subclassing a slotted attrs class with
+        # XXX: a non-attrs class and subclass the resulting class with an attrs
+        # XXX: class.  See `test_slotted_confused` for details.  For now that's
+        # XXX: OK with us.
+        if not self._has_own_setattr:
+            cd["__attrs_own_setattr__"] = False
+
+            if not self._has_custom_setattr:
+                for base_cls in self._cls.__bases__:
+                    if base_cls.__dict__.get("__attrs_own_setattr__", False):
+                        cd["__setattr__"] = object.__setattr__
+                        break
+
+        # Traverse the MRO to collect existing slots
+        # and check for an existing __weakref__.
+        existing_slots = dict()
+        weakref_inherited = False
+        for base_cls in self._cls.__mro__[1:-1]:
+            if base_cls.__dict__.get("__weakref__", None) is not None:
+                weakref_inherited = True
+            existing_slots.update(
+                {
+                    name: getattr(base_cls, name)
+                    for name in getattr(base_cls, "__slots__", [])
+                }
+            )
+
+        base_names = set(self._base_names)
+
+        names = self._attr_names
+        if (
+            self._weakref_slot
+            and "__weakref__" not in getattr(self._cls, "__slots__", ())
+            and "__weakref__" not in names
+            and not weakref_inherited
+        ):
+            names += ("__weakref__",)
+
+        # We only add the names of attributes that aren't inherited.
+        # Setting __slots__ to inherited attributes wastes memory.
+        slot_names = [name for name in names if name not in base_names]
+        # There are slots for attributes from current class
+        # that are defined in parent classes.
+        # As their descriptors may be overriden by a child class,
+        # we collect them here and update the class dict
+        reused_slots = {
+            slot: slot_descriptor
+            for slot, slot_descriptor in iteritems(existing_slots)
+            if slot in slot_names
+        }
+        slot_names = [name for name in slot_names if name not in reused_slots]
+        cd.update(reused_slots)
+        if self._cache_hash:
+            slot_names.append(_hash_cache_field)
+        cd["__slots__"] = tuple(slot_names)
+
+        qualname = getattr(self._cls, "__qualname__", None)
+        if qualname is not None:
+            cd["__qualname__"] = qualname
+
+        # Create new class based on old class and our methods.
+        cls = type(self._cls)(self._cls.__name__, self._cls.__bases__, cd)
+
+        # The following is a fix for
+        # https://github.com/python-attrs/attrs/issues/102.  On Python 3,
+        # if a method mentions `__class__` or uses the no-arg super(), the
+        # compiler will bake a reference to the class in the method itself
+        # as `method.__closure__`.  Since we replace the class with a
+        # clone, we rewrite these references so it keeps working.
+        for item in cls.__dict__.values():
+            if isinstance(item, (classmethod, staticmethod)):
+                # Class- and staticmethods hide their functions inside.
+                # These might need to be rewritten as well.
+                closure_cells = getattr(item.__func__, "__closure__", None)
+            elif isinstance(item, property):
+                # Workaround for property `super()` shortcut (PY3-only).
+                # There is no universal way for other descriptors.
+                closure_cells = getattr(item.fget, "__closure__", None)
+            else:
+                closure_cells = getattr(item, "__closure__", None)
+
+            if not closure_cells:  # Catch None or the empty list.
+                continue
+            for cell in closure_cells:
+                try:
+                    match = cell.cell_contents is self._cls
+                except ValueError:  # ValueError: Cell is empty
+                    pass
+                else:
+                    if match:
+                        set_closure_cell(cell, cls)
+
+        return cls
+
+    def add_repr(self, ns):
+        self._cls_dict["__repr__"] = self._add_method_dunders(
+            _make_repr(self._attrs, ns=ns)
+        )
+        return self
+
+    def add_str(self):
+        repr = self._cls_dict.get("__repr__")
+        if repr is None:
+            raise ValueError(
+                "__str__ can only be generated if a __repr__ exists."
+            )
+
+        def __str__(self):
+            return self.__repr__()
+
+        self._cls_dict["__str__"] = self._add_method_dunders(__str__)
+        return self
+
+    def _make_getstate_setstate(self):
+        """
+        Create custom __setstate__ and __getstate__ methods.
+        """
+        # __weakref__ is not writable.
+        state_attr_names = tuple(
+            an for an in self._attr_names if an != "__weakref__"
+        )
+
+        def slots_getstate(self):
+            """
+            Automatically created by attrs.
+            """
+            return tuple(getattr(self, name) for name in state_attr_names)
+
+        hash_caching_enabled = self._cache_hash
+
+        def slots_setstate(self, state):
+            """
+            Automatically created by attrs.
+            """
+            __bound_setattr = _obj_setattr.__get__(self, Attribute)
+            for name, value in zip(state_attr_names, state):
+                __bound_setattr(name, value)
+
+            # The hash code cache is not included when the object is
+            # serialized, but it still needs to be initialized to None to
+            # indicate that the first call to __hash__ should be a cache
+            # miss.
+            if hash_caching_enabled:
+                __bound_setattr(_hash_cache_field, None)
+
+        return slots_getstate, slots_setstate
+
+    def make_unhashable(self):
+        self._cls_dict["__hash__"] = None
+        return self
+
+    def add_hash(self):
+        self._cls_dict["__hash__"] = self._add_method_dunders(
+            _make_hash(
+                self._cls,
+                self._attrs,
+                frozen=self._frozen,
+                cache_hash=self._cache_hash,
+            )
+        )
+
+        return self
+
+    def add_init(self):
+        self._cls_dict["__init__"] = self._add_method_dunders(
+            _make_init(
+                self._cls,
+                self._attrs,
+                self._has_pre_init,
+                self._has_post_init,
+                self._frozen,
+                self._slots,
+                self._cache_hash,
+                self._base_attr_map,
+                self._is_exc,
+                self._on_setattr is not None
+                and self._on_setattr is not setters.NO_OP,
+                attrs_init=False,
+            )
+        )
+
+        return self
+
+    def add_attrs_init(self):
+        self._cls_dict["__attrs_init__"] = self._add_method_dunders(
+            _make_init(
+                self._cls,
+                self._attrs,
+                self._has_pre_init,
+                self._has_post_init,
+                self._frozen,
+                self._slots,
+                self._cache_hash,
+                self._base_attr_map,
+                self._is_exc,
+                self._on_setattr is not None
+                and self._on_setattr is not setters.NO_OP,
+                attrs_init=True,
+            )
+        )
+
+        return self
+
+    def add_eq(self):
+        cd = self._cls_dict
+
+        cd["__eq__"] = self._add_method_dunders(
+            _make_eq(self._cls, self._attrs)
+        )
+        cd["__ne__"] = self._add_method_dunders(_make_ne())
+
+        return self
+
+    def add_order(self):
+        cd = self._cls_dict
+
+        cd["__lt__"], cd["__le__"], cd["__gt__"], cd["__ge__"] = (
+            self._add_method_dunders(meth)
+            for meth in _make_order(self._cls, self._attrs)
+        )
+
+        return self
+
+    def add_setattr(self):
+        if self._frozen:
+            return self
+
+        sa_attrs = {}
+        for a in self._attrs:
+            on_setattr = a.on_setattr or self._on_setattr
+            if on_setattr and on_setattr is not setters.NO_OP:
+                sa_attrs[a.name] = a, on_setattr
+
+        if not sa_attrs:
+            return self
+
+        if self._has_custom_setattr:
+            # We need to write a __setattr__ but there already is one!
+            raise ValueError(
+                "Can't combine custom __setattr__ with on_setattr hooks."
+            )
+
+        # docstring comes from _add_method_dunders
+        def __setattr__(self, name, val):
+            try:
+                a, hook = sa_attrs[name]
+            except KeyError:
+                nval = val
+            else:
+                nval = hook(self, a, val)
+
+            _obj_setattr(self, name, nval)
+
+        self._cls_dict["__attrs_own_setattr__"] = True
+        self._cls_dict["__setattr__"] = self._add_method_dunders(__setattr__)
+        self._has_own_setattr = True
+
+        return self
+
+    def _add_method_dunders(self, method):
+        """
+        Add __module__ and __qualname__ to a *method* if possible.
+        """
+        try:
+            method.__module__ = self._cls.__module__
+        except AttributeError:
+            pass
+
+        try:
+            method.__qualname__ = ".".join(
+                (self._cls.__qualname__, method.__name__)
+            )
+        except AttributeError:
+            pass
+
+        try:
+            method.__doc__ = "Method generated by attrs for class %s." % (
+                self._cls.__qualname__,
+            )
+        except AttributeError:
+            pass
+
+        return method
+
+
+_CMP_DEPRECATION = (
+    "The usage of `cmp` is deprecated and will be removed on or after "
+    "2021-06-01.  Please use `eq` and `order` instead."
+)
+
+
+def _determine_attrs_eq_order(cmp, eq, order, default_eq):
+    """
+    Validate the combination of *cmp*, *eq*, and *order*. Derive the effective
+    values of eq and order.  If *eq* is None, set it to *default_eq*.
+    """
+    if cmp is not None and any((eq is not None, order is not None)):
+        raise ValueError("Don't mix `cmp` with `eq' and `order`.")
+
+    # cmp takes precedence due to bw-compatibility.
+    if cmp is not None:
+        return cmp, cmp
+
+    # If left None, equality is set to the specified default and ordering
+    # mirrors equality.
+    if eq is None:
+        eq = default_eq
+
+    if order is None:
+        order = eq
+
+    if eq is False and order is True:
+        raise ValueError("`order` can only be True if `eq` is True too.")
+
+    return eq, order
+
+
+def _determine_attrib_eq_order(cmp, eq, order, default_eq):
+    """
+    Validate the combination of *cmp*, *eq*, and *order*. Derive the effective
+    values of eq and order.  If *eq* is None, set it to *default_eq*.
+    """
+    if cmp is not None and any((eq is not None, order is not None)):
+        raise ValueError("Don't mix `cmp` with `eq' and `order`.")
+
+    def decide_callable_or_boolean(value):
+        """
+        Decide whether a key function is used.
+        """
+        if callable(value):
+            value, key = True, value
+        else:
+            key = None
+        return value, key
+
+    # cmp takes precedence due to bw-compatibility.
+    if cmp is not None:
+        cmp, cmp_key = decide_callable_or_boolean(cmp)
+        return cmp, cmp_key, cmp, cmp_key
+
+    # If left None, equality is set to the specified default and ordering
+    # mirrors equality.
+    if eq is None:
+        eq, eq_key = default_eq, None
+    else:
+        eq, eq_key = decide_callable_or_boolean(eq)
+
+    if order is None:
+        order, order_key = eq, eq_key
+    else:
+        order, order_key = decide_callable_or_boolean(order)
+
+    if eq is False and order is True:
+        raise ValueError("`order` can only be True if `eq` is True too.")
+
+    return eq, eq_key, order, order_key
+
+
+def _determine_whether_to_implement(
+    cls, flag, auto_detect, dunders, default=True
+):
+    """
+    Check whether we should implement a set of methods for *cls*.
+
+    *flag* is the argument passed into @attr.s like 'init', *auto_detect* the
+    same as passed into @attr.s and *dunders* is a tuple of attribute names
+    whose presence signal that the user has implemented it themselves.
+
+    Return *default* if no reason for either for or against is found.
+
+    auto_detect must be False on Python 2.
+    """
+    if flag is True or flag is False:
+        return flag
+
+    if flag is None and auto_detect is False:
+        return default
+
+    # Logically, flag is None and auto_detect is True here.
+    for dunder in dunders:
+        if _has_own_attribute(cls, dunder):
+            return False
+
+    return default
+
+
+def attrs(
+    maybe_cls=None,
+    these=None,
+    repr_ns=None,
+    repr=None,
+    cmp=None,
+    hash=None,
+    init=None,
+    slots=False,
+    frozen=False,
+    weakref_slot=True,
+    str=False,
+    auto_attribs=False,
+    kw_only=False,
+    cache_hash=False,
+    auto_exc=False,
+    eq=None,
+    order=None,
+    auto_detect=False,
+    collect_by_mro=False,
+    getstate_setstate=None,
+    on_setattr=None,
+    field_transformer=None,
+):
+    r"""
+    A class decorator that adds `dunder
+    <https://wiki.python.org/moin/DunderAlias>`_\ -methods according to the
+    specified attributes using `attr.ib` or the *these* argument.
+
+    :param these: A dictionary of name to `attr.ib` mappings.  This is
+        useful to avoid the definition of your attributes within the class body
+        because you can't (e.g. if you want to add ``__repr__`` methods to
+        Django models) or don't want to.
+
+        If *these* is not ``None``, ``attrs`` will *not* search the class body
+        for attributes and will *not* remove any attributes from it.
+
+        If *these* is an ordered dict (`dict` on Python 3.6+,
+        `collections.OrderedDict` otherwise), the order is deduced from
+        the order of the attributes inside *these*.  Otherwise the order
+        of the definition of the attributes is used.
+
+    :type these: `dict` of `str` to `attr.ib`
+
+    :param str repr_ns: When using nested classes, there's no way in Python 2
+        to automatically detect that.  Therefore it's possible to set the
+        namespace explicitly for a more meaningful ``repr`` output.
+    :param bool auto_detect: Instead of setting the *init*, *repr*, *eq*,
+        *order*, and *hash* arguments explicitly, assume they are set to
+        ``True`` **unless any** of the involved methods for one of the
+        arguments is implemented in the *current* class (i.e. it is *not*
+        inherited from some base class).
+
+        So for example by implementing ``__eq__`` on a class yourself,
+        ``attrs`` will deduce ``eq=False`` and will create *neither*
+        ``__eq__`` *nor* ``__ne__`` (but Python classes come with a sensible
+        ``__ne__`` by default, so it *should* be enough to only implement
+        ``__eq__`` in most cases).
+
+        .. warning::
+
+           If you prevent ``attrs`` from creating the ordering methods for you
+           (``order=False``, e.g. by implementing ``__le__``), it becomes
+           *your* responsibility to make sure its ordering is sound. The best
+           way is to use the `functools.total_ordering` decorator.
+
+
+        Passing ``True`` or ``False`` to *init*, *repr*, *eq*, *order*,
+        *cmp*, or *hash* overrides whatever *auto_detect* would determine.
+
+        *auto_detect* requires Python 3. Setting it ``True`` on Python 2 raises
+        a `PythonTooOldError`.
+
+    :param bool repr: Create a ``__repr__`` method with a human readable
+        representation of ``attrs`` attributes..
+    :param bool str: Create a ``__str__`` method that is identical to
+        ``__repr__``.  This is usually not necessary except for
+        `Exception`\ s.
+    :param Optional[bool] eq: If ``True`` or ``None`` (default), add ``__eq__``
+        and ``__ne__`` methods that check two instances for equality.
+
+        They compare the instances as if they were tuples of their ``attrs``
+        attributes if and only if the types of both classes are *identical*!
+    :param Optional[bool] order: If ``True``, add ``__lt__``, ``__le__``,
+        ``__gt__``, and ``__ge__`` methods that behave like *eq* above and
+        allow instances to be ordered. If ``None`` (default) mirror value of
+        *eq*.
+    :param Optional[bool] cmp: Setting *cmp* is equivalent to setting *eq*
+        and *order* to the same value. Must not be mixed with *eq* or *order*.
+    :param Optional[bool] hash: If ``None`` (default), the ``__hash__`` method
+        is generated according how *eq* and *frozen* are set.
+
+        1. If *both* are True, ``attrs`` will generate a ``__hash__`` for you.
+        2. If *eq* is True and *frozen* is False, ``__hash__`` will be set to
+           None, marking it unhashable (which it is).
+        3. If *eq* is False, ``__hash__`` will be left untouched meaning the
+           ``__hash__`` method of the base class will be used (if base class is
+           ``object``, this means it will fall back to id-based hashing.).
+
+        Although not recommended, you can decide for yourself and force
+        ``attrs`` to create one (e.g. if the class is immutable even though you
+        didn't freeze it programmatically) by passing ``True`` or not.  Both of
+        these cases are rather special and should be used carefully.
+
+        See our documentation on `hashing`, Python's documentation on
+        `object.__hash__`, and the `GitHub issue that led to the default \
+        behavior <https://github.com/python-attrs/attrs/issues/136>`_ for more
+        details.
+    :param bool init: Create a ``__init__`` method that initializes the
+        ``attrs`` attributes. Leading underscores are stripped for the argument
+        name. If a ``__attrs_pre_init__`` method exists on the class, it will
+        be called before the class is initialized. If a ``__attrs_post_init__``
+        method exists on the class, it will be called after the class is fully
+        initialized.
+
+        If ``init`` is ``False``, an ``__attrs_init__`` method will be
+        injected instead. This allows you to define a custom ``__init__``
+        method that can do pre-init work such as ``super().__init__()``,
+        and then call ``__attrs_init__()`` and ``__attrs_post_init__()``.
+    :param bool slots: Create a `slotted class <slotted classes>` that's more
+        memory-efficient. Slotted classes are generally superior to the default
+        dict classes, but have some gotchas you should know about, so we
+        encourage you to read the `glossary entry <slotted classes>`.
+    :param bool frozen: Make instances immutable after initialization.  If
+        someone attempts to modify a frozen instance,
+        `attr.exceptions.FrozenInstanceError` is raised.
+
+        .. note::
+
+            1. This is achieved by installing a custom ``__setattr__`` method
+               on your class, so you can't implement your own.
+
+            2. True immutability is impossible in Python.
+
+            3. This *does* have a minor a runtime performance `impact
+               <how-frozen>` when initializing new instances.  In other words:
+               ``__init__`` is slightly slower with ``frozen=True``.
+
+            4. If a class is frozen, you cannot modify ``self`` in
+               ``__attrs_post_init__`` or a self-written ``__init__``. You can
+               circumvent that limitation by using
+               ``object.__setattr__(self, "attribute_name", value)``.
+
+            5. Subclasses of a frozen class are frozen too.
+
+    :param bool weakref_slot: Make instances weak-referenceable.  This has no
+        effect unless ``slots`` is also enabled.
+    :param bool auto_attribs: If ``True``, collect `PEP 526`_-annotated
+        attributes (Python 3.6 and later only) from the class body.
+
+        In this case, you **must** annotate every field.  If ``attrs``
+        encounters a field that is set to an `attr.ib` but lacks a type
+        annotation, an `attr.exceptions.UnannotatedAttributeError` is
+        raised.  Use ``field_name: typing.Any = attr.ib(...)`` if you don't
+        want to set a type.
+
+        If you assign a value to those attributes (e.g. ``x: int = 42``), that
+        value becomes the default value like if it were passed using
+        ``attr.ib(default=42)``.  Passing an instance of `Factory` also
+        works as expected in most cases (see warning below).
+
+        Attributes annotated as `typing.ClassVar`, and attributes that are
+        neither annotated nor set to an `attr.ib` are **ignored**.
+
+        .. warning::
+           For features that use the attribute name to create decorators (e.g.
+           `validators <validators>`), you still *must* assign `attr.ib` to
+           them. Otherwise Python will either not find the name or try to use
+           the default value to call e.g. ``validator`` on it.
+
+           These errors can be quite confusing and probably the most common bug
+           report on our bug tracker.
+
+        .. _`PEP 526`: https://www.python.org/dev/peps/pep-0526/
+    :param bool kw_only: Make all attributes keyword-only (Python 3+)
+        in the generated ``__init__`` (if ``init`` is ``False``, this
+        parameter is ignored).
+    :param bool cache_hash: Ensure that the object's hash code is computed
+        only once and stored on the object.  If this is set to ``True``,
+        hashing must be either explicitly or implicitly enabled for this
+        class.  If the hash code is cached, avoid any reassignments of
+        fields involved in hash code computation or mutations of the objects
+        those fields point to after object creation.  If such changes occur,
+        the behavior of the object's hash code is undefined.
+    :param bool auto_exc: If the class subclasses `BaseException`
+        (which implicitly includes any subclass of any exception), the
+        following happens to behave like a well-behaved Python exceptions
+        class:
+
+        - the values for *eq*, *order*, and *hash* are ignored and the
+          instances compare and hash by the instance's ids (N.B. ``attrs`` will
+          *not* remove existing implementations of ``__hash__`` or the equality
+          methods. It just won't add own ones.),
+        - all attributes that are either passed into ``__init__`` or have a
+          default value are additionally available as a tuple in the ``args``
+          attribute,
+        - the value of *str* is ignored leaving ``__str__`` to base classes.
+    :param bool collect_by_mro: Setting this to `True` fixes the way ``attrs``
+       collects attributes from base classes.  The default behavior is
+       incorrect in certain cases of multiple inheritance.  It should be on by
+       default but is kept off for backward-compatability.
+
+       See issue `#428 <https://github.com/python-attrs/attrs/issues/428>`_ for
+       more details.
+
+    :param Optional[bool] getstate_setstate:
+       .. note::
+          This is usually only interesting for slotted classes and you should
+          probably just set *auto_detect* to `True`.
+
+       If `True`, ``__getstate__`` and
+       ``__setstate__`` are generated and attached to the class. This is
+       necessary for slotted classes to be pickleable. If left `None`, it's
+       `True` by default for slotted classes and ``False`` for dict classes.
+
+       If *auto_detect* is `True`, and *getstate_setstate* is left `None`,
+       and **either** ``__getstate__`` or ``__setstate__`` is detected directly
+       on the class (i.e. not inherited), it is set to `False` (this is usually
+       what you want).
+
+    :param on_setattr: A callable that is run whenever the user attempts to set
+        an attribute (either by assignment like ``i.x = 42`` or by using
+        `setattr` like ``setattr(i, "x", 42)``). It receives the same arguments
+        as validators: the instance, the attribute that is being modified, and
+        the new value.
+
+        If no exception is raised, the attribute is set to the return value of
+        the callable.
+
+        If a list of callables is passed, they're automatically wrapped in an
+        `attr.setters.pipe`.
+
+    :param Optional[callable] field_transformer:
+        A function that is called with the original class object and all
+        fields right before ``attrs`` finalizes the class.  You can use
+        this, e.g., to automatically add converters or validators to
+        fields based on their types.  See `transform-fields` for more details.
+
+    .. versionadded:: 16.0.0 *slots*
+    .. versionadded:: 16.1.0 *frozen*
+    .. versionadded:: 16.3.0 *str*
+    .. versionadded:: 16.3.0 Support for ``__attrs_post_init__``.
+    .. versionchanged:: 17.1.0
+       *hash* supports ``None`` as value which is also the default now.
+    .. versionadded:: 17.3.0 *auto_attribs*
+    .. versionchanged:: 18.1.0
+       If *these* is passed, no attributes are deleted from the class body.
+    .. versionchanged:: 18.1.0 If *these* is ordered, the order is retained.
+    .. versionadded:: 18.2.0 *weakref_slot*
+    .. deprecated:: 18.2.0
+       ``__lt__``, ``__le__``, ``__gt__``, and ``__ge__`` now raise a
+       `DeprecationWarning` if the classes compared are subclasses of
+       each other. ``__eq`` and ``__ne__`` never tried to compared subclasses
+       to each other.
+    .. versionchanged:: 19.2.0
+       ``__lt__``, ``__le__``, ``__gt__``, and ``__ge__`` now do not consider
+       subclasses comparable anymore.
+    .. versionadded:: 18.2.0 *kw_only*
+    .. versionadded:: 18.2.0 *cache_hash*
+    .. versionadded:: 19.1.0 *auto_exc*
+    .. deprecated:: 19.2.0 *cmp* Removal on or after 2021-06-01.
+    .. versionadded:: 19.2.0 *eq* and *order*
+    .. versionadded:: 20.1.0 *auto_detect*
+    .. versionadded:: 20.1.0 *collect_by_mro*
+    .. versionadded:: 20.1.0 *getstate_setstate*
+    .. versionadded:: 20.1.0 *on_setattr*
+    .. versionadded:: 20.3.0 *field_transformer*
+    .. versionchanged:: 21.1.0
+       ``init=False`` injects ``__attrs_init__``
+    .. versionchanged:: 21.1.0 Support for ``__attrs_pre_init__``
+    .. versionchanged:: 21.1.0 *cmp* undeprecated
+    """
+    if auto_detect and PY2:
+        raise PythonTooOldError(
+            "auto_detect only works on Python 3 and later."
+        )
+
+    eq_, order_ = _determine_attrs_eq_order(cmp, eq, order, None)
+    hash_ = hash  # work around the lack of nonlocal
+
+    if isinstance(on_setattr, (list, tuple)):
+        on_setattr = setters.pipe(*on_setattr)
+
+    def wrap(cls):
+
+        if getattr(cls, "__class__", None) is None:
+            raise TypeError("attrs only works with new-style classes.")
+
+        is_frozen = frozen or _has_frozen_base_class(cls)
+        is_exc = auto_exc is True and issubclass(cls, BaseException)
+        has_own_setattr = auto_detect and _has_own_attribute(
+            cls, "__setattr__"
+        )
+
+        if has_own_setattr and is_frozen:
+            raise ValueError("Can't freeze a class with a custom __setattr__.")
+
+        builder = _ClassBuilder(
+            cls,
+            these,
+            slots,
+            is_frozen,
+            weakref_slot,
+            _determine_whether_to_implement(
+                cls,
+                getstate_setstate,
+                auto_detect,
+                ("__getstate__", "__setstate__"),
+                default=slots,
+            ),
+            auto_attribs,
+            kw_only,
+            cache_hash,
+            is_exc,
+            collect_by_mro,
+            on_setattr,
+            has_own_setattr,
+            field_transformer,
+        )
+        if _determine_whether_to_implement(
+            cls, repr, auto_detect, ("__repr__",)
+        ):
+            builder.add_repr(repr_ns)
+        if str is True:
+            builder.add_str()
+
+        eq = _determine_whether_to_implement(
+            cls, eq_, auto_detect, ("__eq__", "__ne__")
+        )
+        if not is_exc and eq is True:
+            builder.add_eq()
+        if not is_exc and _determine_whether_to_implement(
+            cls, order_, auto_detect, ("__lt__", "__le__", "__gt__", "__ge__")
+        ):
+            builder.add_order()
+
+        builder.add_setattr()
+
+        if (
+            hash_ is None
+            and auto_detect is True
+            and _has_own_attribute(cls, "__hash__")
+        ):
+            hash = False
+        else:
+            hash = hash_
+        if hash is not True and hash is not False and hash is not None:
+            # Can't use `hash in` because 1 == True for example.
+            raise TypeError(
+                "Invalid value for hash.  Must be True, False, or None."
+            )
+        elif hash is False or (hash is None and eq is False) or is_exc:
+            # Don't do anything. Should fall back to __object__'s __hash__
+            # which is by id.
+            if cache_hash:
+                raise TypeError(
+                    "Invalid value for cache_hash.  To use hash caching,"
+                    " hashing must be either explicitly or implicitly "
+                    "enabled."
+                )
+        elif hash is True or (
+            hash is None and eq is True and is_frozen is True
+        ):
+            # Build a __hash__ if told so, or if it's safe.
+            builder.add_hash()
+        else:
+            # Raise TypeError on attempts to hash.
+            if cache_hash:
+                raise TypeError(
+                    "Invalid value for cache_hash.  To use hash caching,"
+                    " hashing must be either explicitly or implicitly "
+                    "enabled."
+                )
+            builder.make_unhashable()
+
+        if _determine_whether_to_implement(
+            cls, init, auto_detect, ("__init__",)
+        ):
+            builder.add_init()
+        else:
+            builder.add_attrs_init()
+            if cache_hash:
+                raise TypeError(
+                    "Invalid value for cache_hash.  To use hash caching,"
+                    " init must be True."
+                )
+
+        return builder.build_class()
+
+    # maybe_cls's type depends on the usage of the decorator.  It's a class
+    # if it's used as `@attrs` but ``None`` if used as `@attrs()`.
+    if maybe_cls is None:
+        return wrap
+    else:
+        return wrap(maybe_cls)
+
+
+_attrs = attrs
+"""
+Internal alias so we can use it in functions that take an argument called
+*attrs*.
+"""
+
+
+if PY2:
+
+    def _has_frozen_base_class(cls):
+        """
+        Check whether *cls* has a frozen ancestor by looking at its
+        __setattr__.
+        """
+        return (
+            getattr(cls.__setattr__, "__module__", None)
+            == _frozen_setattrs.__module__
+            and cls.__setattr__.__name__ == _frozen_setattrs.__name__
+        )
+
+
+else:
+
+    def _has_frozen_base_class(cls):
+        """
+        Check whether *cls* has a frozen ancestor by looking at its
+        __setattr__.
+        """
+        return cls.__setattr__ == _frozen_setattrs
+
+
+def _generate_unique_filename(cls, func_name):
+    """
+    Create a "filename" suitable for a function being generated.
+    """
+    unique_id = uuid.uuid4()
+    extra = ""
+    count = 1
+
+    while True:
+        unique_filename = "<attrs generated {0} {1}.{2}{3}>".format(
+            func_name,
+            cls.__module__,
+            getattr(cls, "__qualname__", cls.__name__),
+            extra,
+        )
+        # To handle concurrency we essentially "reserve" our spot in
+        # the linecache with a dummy line.  The caller can then
+        # set this value correctly.
+        cache_line = (1, None, (str(unique_id),), unique_filename)
+        if (
+            linecache.cache.setdefault(unique_filename, cache_line)
+            == cache_line
+        ):
+            return unique_filename
+
+        # Looks like this spot is taken. Try again.
+        count += 1
+        extra = "-{0}".format(count)
+
+
+def _make_hash(cls, attrs, frozen, cache_hash):
+    attrs = tuple(
+        a for a in attrs if a.hash is True or (a.hash is None and a.eq is True)
+    )
+
+    tab = "        "
+
+    unique_filename = _generate_unique_filename(cls, "hash")
+    type_hash = hash(unique_filename)
+
+    hash_def = "def __hash__(self"
+    hash_func = "hash(("
+    closing_braces = "))"
+    if not cache_hash:
+        hash_def += "):"
+    else:
+        if not PY2:
+            hash_def += ", *"
+
+        hash_def += (
+            ", _cache_wrapper="
+            + "__import__('attr._make')._make._CacheHashWrapper):"
+        )
+        hash_func = "_cache_wrapper(" + hash_func
+        closing_braces += ")"
+
+    method_lines = [hash_def]
+
+    def append_hash_computation_lines(prefix, indent):
+        """
+        Generate the code for actually computing the hash code.
+        Below this will either be returned directly or used to compute
+        a value which is then cached, depending on the value of cache_hash
+        """
+
+        method_lines.extend(
+            [
+                indent + prefix + hash_func,
+                indent + "        %d," % (type_hash,),
+            ]
+        )
+
+        for a in attrs:
+            method_lines.append(indent + "        self.%s," % a.name)
+
+        method_lines.append(indent + "    " + closing_braces)
+
+    if cache_hash:
+        method_lines.append(tab + "if self.%s is None:" % _hash_cache_field)
+        if frozen:
+            append_hash_computation_lines(
+                "object.__setattr__(self, '%s', " % _hash_cache_field, tab * 2
+            )
+            method_lines.append(tab * 2 + ")")  # close __setattr__
+        else:
+            append_hash_computation_lines(
+                "self.%s = " % _hash_cache_field, tab * 2
+            )
+        method_lines.append(tab + "return self.%s" % _hash_cache_field)
+    else:
+        append_hash_computation_lines("return ", tab)
+
+    script = "\n".join(method_lines)
+    return _make_method("__hash__", script, unique_filename)
+
+
+def _add_hash(cls, attrs):
+    """
+    Add a hash method to *cls*.
+    """
+    cls.__hash__ = _make_hash(cls, attrs, frozen=False, cache_hash=False)
+    return cls
+
+
+def _make_ne():
+    """
+    Create __ne__ method.
+    """
+
+    def __ne__(self, other):
+        """
+        Check equality and either forward a NotImplemented or
+        return the result negated.
+        """
+        result = self.__eq__(other)
+        if result is NotImplemented:
+            return NotImplemented
+
+        return not result
+
+    return __ne__
+
+
+def _make_eq(cls, attrs):
+    """
+    Create __eq__ method for *cls* with *attrs*.
+    """
+    attrs = [a for a in attrs if a.eq]
+
+    unique_filename = _generate_unique_filename(cls, "eq")
+    lines = [
+        "def __eq__(self, other):",
+        "    if other.__class__ is not self.__class__:",
+        "        return NotImplemented",
+    ]
+
+    # We can't just do a big self.x = other.x and... clause due to
+    # irregularities like nan == nan is false but (nan,) == (nan,) is true.
+    globs = {}
+    if attrs:
+        lines.append("    return  (")
+        others = ["    ) == ("]
+        for a in attrs:
+            if a.eq_key:
+                cmp_name = "_%s_key" % (a.name,)
+                # Add the key function to the global namespace
+                # of the evaluated function.
+                globs[cmp_name] = a.eq_key
+                lines.append(
+                    "        %s(self.%s),"
+                    % (
+                        cmp_name,
+                        a.name,
+                    )
+                )
+                others.append(
+                    "        %s(other.%s),"
+                    % (
+                        cmp_name,
+                        a.name,
+                    )
+                )
+            else:
+                lines.append("        self.%s," % (a.name,))
+                others.append("        other.%s," % (a.name,))
+
+        lines += others + ["    )"]
+    else:
+        lines.append("    return True")
+
+    script = "\n".join(lines)
+
+    return _make_method("__eq__", script, unique_filename, globs)
+
+
+def _make_order(cls, attrs):
+    """
+    Create ordering methods for *cls* with *attrs*.
+    """
+    attrs = [a for a in attrs if a.order]
+
+    def attrs_to_tuple(obj):
+        """
+        Save us some typing.
+        """
+        return tuple(
+            key(value) if key else value
+            for value, key in (
+                (getattr(obj, a.name), a.order_key) for a in attrs
+            )
+        )
+
+    def __lt__(self, other):
+        """
+        Automatically created by attrs.
+        """
+        if other.__class__ is self.__class__:
+            return attrs_to_tuple(self) < attrs_to_tuple(other)
+
+        return NotImplemented
+
+    def __le__(self, other):
+        """
+        Automatically created by attrs.
+        """
+        if other.__class__ is self.__class__:
+            return attrs_to_tuple(self) <= attrs_to_tuple(other)
+
+        return NotImplemented
+
+    def __gt__(self, other):
+        """
+        Automatically created by attrs.
+        """
+        if other.__class__ is self.__class__:
+            return attrs_to_tuple(self) > attrs_to_tuple(other)
+
+        return NotImplemented
+
+    def __ge__(self, other):
+        """
+        Automatically created by attrs.
+        """
+        if other.__class__ is self.__class__:
+            return attrs_to_tuple(self) >= attrs_to_tuple(other)
+
+        return NotImplemented
+
+    return __lt__, __le__, __gt__, __ge__
+
+
+def _add_eq(cls, attrs=None):
+    """
+    Add equality methods to *cls* with *attrs*.
+    """
+    if attrs is None:
+        attrs = cls.__attrs_attrs__
+
+    cls.__eq__ = _make_eq(cls, attrs)
+    cls.__ne__ = _make_ne()
+
+    return cls
+
+
+_already_repring = threading.local()
+
+
+def _make_repr(attrs, ns):
+    """
+    Make a repr method that includes relevant *attrs*, adding *ns* to the full
+    name.
+    """
+
+    # Figure out which attributes to include, and which function to use to
+    # format them. The a.repr value can be either bool or a custom callable.
+    attr_names_with_reprs = tuple(
+        (a.name, repr if a.repr is True else a.repr)
+        for a in attrs
+        if a.repr is not False
+    )
+
+    def __repr__(self):
+        """
+        Automatically created by attrs.
+        """
+        try:
+            working_set = _already_repring.working_set
+        except AttributeError:
+            working_set = set()
+            _already_repring.working_set = working_set
+
+        if id(self) in working_set:
+            return "..."
+        real_cls = self.__class__
+        if ns is None:
+            qualname = getattr(real_cls, "__qualname__", None)
+            if qualname is not None:
+                class_name = qualname.rsplit(">.", 1)[-1]
+            else:
+                class_name = real_cls.__name__
+        else:
+            class_name = ns + "." + real_cls.__name__
+
+        # Since 'self' remains on the stack (i.e.: strongly referenced) for the
+        # duration of this call, it's safe to depend on id(...) stability, and
+        # not need to track the instance and therefore worry about properties
+        # like weakref- or hash-ability.
+        working_set.add(id(self))
+        try:
+            result = [class_name, "("]
+            first = True
+            for name, attr_repr in attr_names_with_reprs:
+                if first:
+                    first = False
+                else:
+                    result.append(", ")
+                result.extend(
+                    (name, "=", attr_repr(getattr(self, name, NOTHING)))
+                )
+            return "".join(result) + ")"
+        finally:
+            working_set.remove(id(self))
+
+    return __repr__
+
+
+def _add_repr(cls, ns=None, attrs=None):
+    """
+    Add a repr method to *cls*.
+    """
+    if attrs is None:
+        attrs = cls.__attrs_attrs__
+
+    cls.__repr__ = _make_repr(attrs, ns)
+    return cls
+
+
+def fields(cls):
+    """
+    Return the tuple of ``attrs`` attributes for a class.
+
+    The tuple also allows accessing the fields by their names (see below for
+    examples).
+
+    :param type cls: Class to introspect.
+
+    :raise TypeError: If *cls* is not a class.
+    :raise attr.exceptions.NotAnAttrsClassError: If *cls* is not an ``attrs``
+        class.
+
+    :rtype: tuple (with name accessors) of `attr.Attribute`
+
+    ..  versionchanged:: 16.2.0 Returned tuple allows accessing the fields
+        by name.
+    """
+    if not isclass(cls):
+        raise TypeError("Passed object must be a class.")
+    attrs = getattr(cls, "__attrs_attrs__", None)
+    if attrs is None:
+        raise NotAnAttrsClassError(
+            "{cls!r} is not an attrs-decorated class.".format(cls=cls)
+        )
+    return attrs
+
+
+def fields_dict(cls):
+    """
+    Return an ordered dictionary of ``attrs`` attributes for a class, whose
+    keys are the attribute names.
+
+    :param type cls: Class to introspect.
+
+    :raise TypeError: If *cls* is not a class.
+    :raise attr.exceptions.NotAnAttrsClassError: If *cls* is not an ``attrs``
+        class.
+
+    :rtype: an ordered dict where keys are attribute names and values are
+        `attr.Attribute`\\ s. This will be a `dict` if it's
+        naturally ordered like on Python 3.6+ or an
+        :class:`~collections.OrderedDict` otherwise.
+
+    .. versionadded:: 18.1.0
+    """
+    if not isclass(cls):
+        raise TypeError("Passed object must be a class.")
+    attrs = getattr(cls, "__attrs_attrs__", None)
+    if attrs is None:
+        raise NotAnAttrsClassError(
+            "{cls!r} is not an attrs-decorated class.".format(cls=cls)
+        )
+    return ordered_dict(((a.name, a) for a in attrs))
+
+
+def validate(inst):
+    """
+    Validate all attributes on *inst* that have a validator.
+
+    Leaves all exceptions through.
+
+    :param inst: Instance of a class with ``attrs`` attributes.
+    """
+    if _config._run_validators is False:
+        return
+
+    for a in fields(inst.__class__):
+        v = a.validator
+        if v is not None:
+            v(inst, a, getattr(inst, a.name))
+
+
+def _is_slot_cls(cls):
+    return "__slots__" in cls.__dict__
+
+
+def _is_slot_attr(a_name, base_attr_map):
+    """
+    Check if the attribute name comes from a slot class.
+    """
+    return a_name in base_attr_map and _is_slot_cls(base_attr_map[a_name])
+
+
+def _make_init(
+    cls,
+    attrs,
+    pre_init,
+    post_init,
+    frozen,
+    slots,
+    cache_hash,
+    base_attr_map,
+    is_exc,
+    has_global_on_setattr,
+    attrs_init,
+):
+    if frozen and has_global_on_setattr:
+        raise ValueError("Frozen classes can't use on_setattr.")
+
+    needs_cached_setattr = cache_hash or frozen
+    filtered_attrs = []
+    attr_dict = {}
+    for a in attrs:
+        if not a.init and a.default is NOTHING:
+            continue
+
+        filtered_attrs.append(a)
+        attr_dict[a.name] = a
+
+        if a.on_setattr is not None:
+            if frozen is True:
+                raise ValueError("Frozen classes can't use on_setattr.")
+
+            needs_cached_setattr = True
+        elif (
+            has_global_on_setattr and a.on_setattr is not setters.NO_OP
+        ) or _is_slot_attr(a.name, base_attr_map):
+            needs_cached_setattr = True
+
+    unique_filename = _generate_unique_filename(cls, "init")
+
+    script, globs, annotations = _attrs_to_init_script(
+        filtered_attrs,
+        frozen,
+        slots,
+        pre_init,
+        post_init,
+        cache_hash,
+        base_attr_map,
+        is_exc,
+        needs_cached_setattr,
+        has_global_on_setattr,
+        attrs_init,
+    )
+    if cls.__module__ in sys.modules:
+        # This makes typing.get_type_hints(CLS.__init__) resolve string types.
+        globs.update(sys.modules[cls.__module__].__dict__)
+
+    globs.update({"NOTHING": NOTHING, "attr_dict": attr_dict})
+
+    if needs_cached_setattr:
+        # Save the lookup overhead in __init__ if we need to circumvent
+        # setattr hooks.
+        globs["_cached_setattr"] = _obj_setattr
+
+    init = _make_method(
+        "__attrs_init__" if attrs_init else "__init__",
+        script,
+        unique_filename,
+        globs,
+    )
+    init.__annotations__ = annotations
+
+    return init
+
+
+def _setattr(attr_name, value_var, has_on_setattr):
+    """
+    Use the cached object.setattr to set *attr_name* to *value_var*.
+    """
+    return "_setattr('%s', %s)" % (attr_name, value_var)
+
+
+def _setattr_with_converter(attr_name, value_var, has_on_setattr):
+    """
+    Use the cached object.setattr to set *attr_name* to *value_var*, but run
+    its converter first.
+    """
+    return "_setattr('%s', %s(%s))" % (
+        attr_name,
+        _init_converter_pat % (attr_name,),
+        value_var,
+    )
+
+
+def _assign(attr_name, value, has_on_setattr):
+    """
+    Unless *attr_name* has an on_setattr hook, use normal assignment. Otherwise
+    relegate to _setattr.
+    """
+    if has_on_setattr:
+        return _setattr(attr_name, value, True)
+
+    return "self.%s = %s" % (attr_name, value)
+
+
+def _assign_with_converter(attr_name, value_var, has_on_setattr):
+    """
+    Unless *attr_name* has an on_setattr hook, use normal assignment after
+    conversion. Otherwise relegate to _setattr_with_converter.
+    """
+    if has_on_setattr:
+        return _setattr_with_converter(attr_name, value_var, True)
+
+    return "self.%s = %s(%s)" % (
+        attr_name,
+        _init_converter_pat % (attr_name,),
+        value_var,
+    )
+
+
+if PY2:
+
+    def _unpack_kw_only_py2(attr_name, default=None):
+        """
+        Unpack *attr_name* from _kw_only dict.
+        """
+        if default is not None:
+            arg_default = ", %s" % default
+        else:
+            arg_default = ""
+        return "%s = _kw_only.pop('%s'%s)" % (
+            attr_name,
+            attr_name,
+            arg_default,
+        )
+
+    def _unpack_kw_only_lines_py2(kw_only_args):
+        """
+        Unpack all *kw_only_args* from _kw_only dict and handle errors.
+
+        Given a list of strings "{attr_name}" and "{attr_name}={default}"
+        generates list of lines of code that pop attrs from _kw_only dict and
+        raise TypeError similar to builtin if required attr is missing or
+        extra key is passed.
+
+        >>> print("\n".join(_unpack_kw_only_lines_py2(["a", "b=42"])))
+        try:
+            a = _kw_only.pop('a')
+            b = _kw_only.pop('b', 42)
+        except KeyError as _key_error:
+            raise TypeError(
+                ...
+        if _kw_only:
+            raise TypeError(
+                ...
+        """
+        lines = ["try:"]
+        lines.extend(
+            "    " + _unpack_kw_only_py2(*arg.split("="))
+            for arg in kw_only_args
+        )
+        lines += """\
+except KeyError as _key_error:
+    raise TypeError(
+        '__init__() missing required keyword-only argument: %s' % _key_error
+    )
+if _kw_only:
+    raise TypeError(
+        '__init__() got an unexpected keyword argument %r'
+        % next(iter(_kw_only))
+    )
+""".split(
+            "\n"
+        )
+        return lines
+
+
+def _attrs_to_init_script(
+    attrs,
+    frozen,
+    slots,
+    pre_init,
+    post_init,
+    cache_hash,
+    base_attr_map,
+    is_exc,
+    needs_cached_setattr,
+    has_global_on_setattr,
+    attrs_init,
+):
+    """
+    Return a script of an initializer for *attrs* and a dict of globals.
+
+    The globals are expected by the generated script.
+
+    If *frozen* is True, we cannot set the attributes directly so we use
+    a cached ``object.__setattr__``.
+    """
+    lines = []
+    if pre_init:
+        lines.append("self.__attrs_pre_init__()")
+
+    if needs_cached_setattr:
+        lines.append(
+            # Circumvent the __setattr__ descriptor to save one lookup per
+            # assignment.
+            # Note _setattr will be used again below if cache_hash is True
+            "_setattr = _cached_setattr.__get__(self, self.__class__)"
+        )
+
+    if frozen is True:
+        if slots is True:
+            fmt_setter = _setattr
+            fmt_setter_with_converter = _setattr_with_converter
+        else:
+            # Dict frozen classes assign directly to __dict__.
+            # But only if the attribute doesn't come from an ancestor slot
+            # class.
+            # Note _inst_dict will be used again below if cache_hash is True
+            lines.append("_inst_dict = self.__dict__")
+
+            def fmt_setter(attr_name, value_var, has_on_setattr):
+                if _is_slot_attr(attr_name, base_attr_map):
+                    return _setattr(attr_name, value_var, has_on_setattr)
+
+                return "_inst_dict['%s'] = %s" % (attr_name, value_var)
+
+            def fmt_setter_with_converter(
+                attr_name, value_var, has_on_setattr
+            ):
+                if has_on_setattr or _is_slot_attr(attr_name, base_attr_map):
+                    return _setattr_with_converter(
+                        attr_name, value_var, has_on_setattr
+                    )
+
+                return "_inst_dict['%s'] = %s(%s)" % (
+                    attr_name,
+                    _init_converter_pat % (attr_name,),
+                    value_var,
+                )
+
+    else:
+        # Not frozen.
+        fmt_setter = _assign
+        fmt_setter_with_converter = _assign_with_converter
+
+    args = []
+    kw_only_args = []
+    attrs_to_validate = []
+
+    # This is a dictionary of names to validator and converter callables.
+    # Injecting this into __init__ globals lets us avoid lookups.
+    names_for_globals = {}
+    annotations = {"return": None}
+
+    for a in attrs:
+        if a.validator:
+            attrs_to_validate.append(a)
+
+        attr_name = a.name
+        has_on_setattr = a.on_setattr is not None or (
+            a.on_setattr is not setters.NO_OP and has_global_on_setattr
+        )
+        arg_name = a.name.lstrip("_")
+
+        has_factory = isinstance(a.default, Factory)
+        if has_factory and a.default.takes_self:
+            maybe_self = "self"
+        else:
+            maybe_self = ""
+
+        if a.init is False:
+            if has_factory:
+                init_factory_name = _init_factory_pat.format(a.name)
+                if a.converter is not None:
+                    lines.append(
+                        fmt_setter_with_converter(
+                            attr_name,
+                            init_factory_name + "(%s)" % (maybe_self,),
+                            has_on_setattr,
+                        )
+                    )
+                    conv_name = _init_converter_pat % (a.name,)
+                    names_for_globals[conv_name] = a.converter
+                else:
+                    lines.append(
+                        fmt_setter(
+                            attr_name,
+                            init_factory_name + "(%s)" % (maybe_self,),
+                            has_on_setattr,
+                        )
+                    )
+                names_for_globals[init_factory_name] = a.default.factory
+            else:
+                if a.converter is not None:
+                    lines.append(
+                        fmt_setter_with_converter(
+                            attr_name,
+                            "attr_dict['%s'].default" % (attr_name,),
+                            has_on_setattr,
+                        )
+                    )
+                    conv_name = _init_converter_pat % (a.name,)
+                    names_for_globals[conv_name] = a.converter
+                else:
+                    lines.append(
+                        fmt_setter(
+                            attr_name,
+                            "attr_dict['%s'].default" % (attr_name,),
+                            has_on_setattr,
+                        )
+                    )
+        elif a.default is not NOTHING and not has_factory:
+            arg = "%s=attr_dict['%s'].default" % (arg_name, attr_name)
+            if a.kw_only:
+                kw_only_args.append(arg)
+            else:
+                args.append(arg)
+
+            if a.converter is not None:
+                lines.append(
+                    fmt_setter_with_converter(
+                        attr_name, arg_name, has_on_setattr
+                    )
+                )
+                names_for_globals[
+                    _init_converter_pat % (a.name,)
+                ] = a.converter
+            else:
+                lines.append(fmt_setter(attr_name, arg_name, has_on_setattr))
+
+        elif has_factory:
+            arg = "%s=NOTHING" % (arg_name,)
+            if a.kw_only:
+                kw_only_args.append(arg)
+            else:
+                args.append(arg)
+            lines.append("if %s is not NOTHING:" % (arg_name,))
+
+            init_factory_name = _init_factory_pat.format(a.name)
+            if a.converter is not None:
+                lines.append(
+                    "    "
+                    + fmt_setter_with_converter(
+                        attr_name, arg_name, has_on_setattr
+                    )
+                )
+                lines.append("else:")
+                lines.append(
+                    "    "
+                    + fmt_setter_with_converter(
+                        attr_name,
+                        init_factory_name + "(" + maybe_self + ")",
+                        has_on_setattr,
+                    )
+                )
+                names_for_globals[
+                    _init_converter_pat % (a.name,)
+                ] = a.converter
+            else:
+                lines.append(
+                    "    " + fmt_setter(attr_name, arg_name, has_on_setattr)
+                )
+                lines.append("else:")
+                lines.append(
+                    "    "
+                    + fmt_setter(
+                        attr_name,
+                        init_factory_name + "(" + maybe_self + ")",
+                        has_on_setattr,
+                    )
+                )
+            names_for_globals[init_factory_name] = a.default.factory
+        else:
+            if a.kw_only:
+                kw_only_args.append(arg_name)
+            else:
+                args.append(arg_name)
+
+            if a.converter is not None:
+                lines.append(
+                    fmt_setter_with_converter(
+                        attr_name, arg_name, has_on_setattr
+                    )
+                )
+                names_for_globals[
+                    _init_converter_pat % (a.name,)
+                ] = a.converter
+            else:
+                lines.append(fmt_setter(attr_name, arg_name, has_on_setattr))
+
+        if a.init is True:
+            if a.type is not None and a.converter is None:
+                annotations[arg_name] = a.type
+            elif a.converter is not None and not PY2:
+                # Try to get the type from the converter.
+                sig = None
+                try:
+                    sig = inspect.signature(a.converter)
+                except (ValueError, TypeError):  # inspect failed
+                    pass
+                if sig:
+                    sig_params = list(sig.parameters.values())
+                    if (
+                        sig_params
+                        and sig_params[0].annotation
+                        is not inspect.Parameter.empty
+                    ):
+                        annotations[arg_name] = sig_params[0].annotation
+
+    if attrs_to_validate:  # we can skip this if there are no validators.
+        names_for_globals["_config"] = _config
+        lines.append("if _config._run_validators is True:")
+        for a in attrs_to_validate:
+            val_name = "__attr_validator_" + a.name
+            attr_name = "__attr_" + a.name
+            lines.append(
+                "    %s(self, %s, self.%s)" % (val_name, attr_name, a.name)
+            )
+            names_for_globals[val_name] = a.validator
+            names_for_globals[attr_name] = a
+
+    if post_init:
+        lines.append("self.__attrs_post_init__()")
+
+    # because this is set only after __attrs_post_init is called, a crash
+    # will result if post-init tries to access the hash code.  This seemed
+    # preferable to setting this beforehand, in which case alteration to
+    # field values during post-init combined with post-init accessing the
+    # hash code would result in silent bugs.
+    if cache_hash:
+        if frozen:
+            if slots:
+                # if frozen and slots, then _setattr defined above
+                init_hash_cache = "_setattr('%s', %s)"
+            else:
+                # if frozen and not slots, then _inst_dict defined above
+                init_hash_cache = "_inst_dict['%s'] = %s"
+        else:
+            init_hash_cache = "self.%s = %s"
+        lines.append(init_hash_cache % (_hash_cache_field, "None"))
+
+    # For exceptions we rely on BaseException.__init__ for proper
+    # initialization.
+    if is_exc:
+        vals = ",".join("self." + a.name for a in attrs if a.init)
+
+        lines.append("BaseException.__init__(self, %s)" % (vals,))
+
+    args = ", ".join(args)
+    if kw_only_args:
+        if PY2:
+            lines = _unpack_kw_only_lines_py2(kw_only_args) + lines
+
+            args += "%s**_kw_only" % (", " if args else "",)  # leading comma
+        else:
+            args += "%s*, %s" % (
+                ", " if args else "",  # leading comma
+                ", ".join(kw_only_args),  # kw_only args
+            )
+    return (
+        """\
+def {init_name}(self, {args}):
+    {lines}
+""".format(
+            init_name=("__attrs_init__" if attrs_init else "__init__"),
+            args=args,
+            lines="\n    ".join(lines) if lines else "pass",
+        ),
+        names_for_globals,
+        annotations,
+    )
+
+
+class Attribute(object):
+    """
+    *Read-only* representation of an attribute.
+
+    Instances of this class are frequently used for introspection purposes
+    like:
+
+    - `fields` returns a tuple of them.
+    - Validators get them passed as the first argument.
+    - The *field transformer* hook receives a list of them.
+
+    :attribute name: The name of the attribute.
+    :attribute inherited: Whether or not that attribute has been inherited from
+        a base class.
+
+    Plus *all* arguments of `attr.ib` (except for ``factory``
+    which is only syntactic sugar for ``default=Factory(...)``.
+
+    .. versionadded:: 20.1.0 *inherited*
+    .. versionadded:: 20.1.0 *on_setattr*
+    .. versionchanged:: 20.2.0 *inherited* is not taken into account for
+        equality checks and hashing anymore.
+    .. versionadded:: 21.1.0 *eq_key* and *order_key*
+
+    For the full version history of the fields, see `attr.ib`.
+    """
+
+    __slots__ = (
+        "name",
+        "default",
+        "validator",
+        "repr",
+        "eq",
+        "eq_key",
+        "order",
+        "order_key",
+        "hash",
+        "init",
+        "metadata",
+        "type",
+        "converter",
+        "kw_only",
+        "inherited",
+        "on_setattr",
+    )
+
+    def __init__(
+        self,
+        name,
+        default,
+        validator,
+        repr,
+        cmp,  # XXX: unused, remove along with other cmp code.
+        hash,
+        init,
+        inherited,
+        metadata=None,
+        type=None,
+        converter=None,
+        kw_only=False,
+        eq=None,
+        eq_key=None,
+        order=None,
+        order_key=None,
+        on_setattr=None,
+    ):
+        eq, eq_key, order, order_key = _determine_attrib_eq_order(
+            cmp, eq_key or eq, order_key or order, True
+        )
+
+        # Cache this descriptor here to speed things up later.
+        bound_setattr = _obj_setattr.__get__(self, Attribute)
+
+        # Despite the big red warning, people *do* instantiate `Attribute`
+        # themselves.
+        bound_setattr("name", name)
+        bound_setattr("default", default)
+        bound_setattr("validator", validator)
+        bound_setattr("repr", repr)
+        bound_setattr("eq", eq)
+        bound_setattr("eq_key", eq_key)
+        bound_setattr("order", order)
+        bound_setattr("order_key", order_key)
+        bound_setattr("hash", hash)
+        bound_setattr("init", init)
+        bound_setattr("converter", converter)
+        bound_setattr(
+            "metadata",
+            (
+                metadata_proxy(metadata)
+                if metadata
+                else _empty_metadata_singleton
+            ),
+        )
+        bound_setattr("type", type)
+        bound_setattr("kw_only", kw_only)
+        bound_setattr("inherited", inherited)
+        bound_setattr("on_setattr", on_setattr)
+
+    def __setattr__(self, name, value):
+        raise FrozenInstanceError()
+
+    @classmethod
+    def from_counting_attr(cls, name, ca, type=None):
+        # type holds the annotated value. deal with conflicts:
+        if type is None:
+            type = ca.type
+        elif ca.type is not None:
+            raise ValueError(
+                "Type annotation and type argument cannot both be present"
+            )
+        inst_dict = {
+            k: getattr(ca, k)
+            for k in Attribute.__slots__
+            if k
+            not in (
+                "name",
+                "validator",
+                "default",
+                "type",
+                "inherited",
+            )  # exclude methods and deprecated alias
+        }
+        return cls(
+            name=name,
+            validator=ca._validator,
+            default=ca._default,
+            type=type,
+            cmp=None,
+            inherited=False,
+            **inst_dict
+        )
+
+    @property
+    def cmp(self):
+        """
+        Simulate the presence of a cmp attribute and warn.
+        """
+        warnings.warn(_CMP_DEPRECATION, DeprecationWarning, stacklevel=2)
+
+        return self.eq and self.order
+
+    # Don't use attr.evolve since fields(Attribute) doesn't work
+    def evolve(self, **changes):
+        """
+        Copy *self* and apply *changes*.
+
+        This works similarly to `attr.evolve` but that function does not work
+        with ``Attribute``.
+
+        It is mainly meant to be used for `transform-fields`.
+
+        .. versionadded:: 20.3.0
+        """
+        new = copy.copy(self)
+
+        new._setattrs(changes.items())
+
+        return new
+
+    # Don't use _add_pickle since fields(Attribute) doesn't work
+    def __getstate__(self):
+        """
+        Play nice with pickle.
+        """
+        return tuple(
+            getattr(self, name) if name != "metadata" else dict(self.metadata)
+            for name in self.__slots__
+        )
+
+    def __setstate__(self, state):
+        """
+        Play nice with pickle.
+        """
+        self._setattrs(zip(self.__slots__, state))
+
+    def _setattrs(self, name_values_pairs):
+        bound_setattr = _obj_setattr.__get__(self, Attribute)
+        for name, value in name_values_pairs:
+            if name != "metadata":
+                bound_setattr(name, value)
+            else:
+                bound_setattr(
+                    name,
+                    metadata_proxy(value)
+                    if value
+                    else _empty_metadata_singleton,
+                )
+
+
+_a = [
+    Attribute(
+        name=name,
+        default=NOTHING,
+        validator=None,
+        repr=True,
+        cmp=None,
+        eq=True,
+        order=False,
+        hash=(name != "metadata"),
+        init=True,
+        inherited=False,
+    )
+    for name in Attribute.__slots__
+]
+
+Attribute = _add_hash(
+    _add_eq(
+        _add_repr(Attribute, attrs=_a),
+        attrs=[a for a in _a if a.name != "inherited"],
+    ),
+    attrs=[a for a in _a if a.hash and a.name != "inherited"],
+)
+
+
+class _CountingAttr(object):
+    """
+    Intermediate representation of attributes that uses a counter to preserve
+    the order in which the attributes have been defined.
+
+    *Internal* data structure of the attrs library.  Running into is most
+    likely the result of a bug like a forgotten `@attr.s` decorator.
+    """
+
+    __slots__ = (
+        "counter",
+        "_default",
+        "repr",
+        "eq",
+        "eq_key",
+        "order",
+        "order_key",
+        "hash",
+        "init",
+        "metadata",
+        "_validator",
+        "converter",
+        "type",
+        "kw_only",
+        "on_setattr",
+    )
+    __attrs_attrs__ = tuple(
+        Attribute(
+            name=name,
+            default=NOTHING,
+            validator=None,
+            repr=True,
+            cmp=None,
+            hash=True,
+            init=True,
+            kw_only=False,
+            eq=True,
+            eq_key=None,
+            order=False,
+            order_key=None,
+            inherited=False,
+            on_setattr=None,
+        )
+        for name in (
+            "counter",
+            "_default",
+            "repr",
+            "eq",
+            "order",
+            "hash",
+            "init",
+            "on_setattr",
+        )
+    ) + (
+        Attribute(
+            name="metadata",
+            default=None,
+            validator=None,
+            repr=True,
+            cmp=None,
+            hash=False,
+            init=True,
+            kw_only=False,
+            eq=True,
+            eq_key=None,
+            order=False,
+            order_key=None,
+            inherited=False,
+            on_setattr=None,
+        ),
+    )
+    cls_counter = 0
+
+    def __init__(
+        self,
+        default,
+        validator,
+        repr,
+        cmp,
+        hash,
+        init,
+        converter,
+        metadata,
+        type,
+        kw_only,
+        eq,
+        eq_key,
+        order,
+        order_key,
+        on_setattr,
+    ):
+        _CountingAttr.cls_counter += 1
+        self.counter = _CountingAttr.cls_counter
+        self._default = default
+        self._validator = validator
+        self.converter = converter
+        self.repr = repr
+        self.eq = eq
+        self.eq_key = eq_key
+        self.order = order
+        self.order_key = order_key
+        self.hash = hash
+        self.init = init
+        self.metadata = metadata
+        self.type = type
+        self.kw_only = kw_only
+        self.on_setattr = on_setattr
+
+    def validator(self, meth):
+        """
+        Decorator that adds *meth* to the list of validators.
+
+        Returns *meth* unchanged.
+
+        .. versionadded:: 17.1.0
+        """
+        if self._validator is None:
+            self._validator = meth
+        else:
+            self._validator = and_(self._validator, meth)
+        return meth
+
+    def default(self, meth):
+        """
+        Decorator that allows to set the default for an attribute.
+
+        Returns *meth* unchanged.
+
+        :raises DefaultAlreadySetError: If default has been set before.
+
+        .. versionadded:: 17.1.0
+        """
+        if self._default is not NOTHING:
+            raise DefaultAlreadySetError()
+
+        self._default = Factory(meth, takes_self=True)
+
+        return meth
+
+
+_CountingAttr = _add_eq(_add_repr(_CountingAttr))
+
+
+class Factory(object):
+    """
+    Stores a factory callable.
+
+    If passed as the default value to `attr.ib`, the factory is used to
+    generate a new value.
+
+    :param callable factory: A callable that takes either none or exactly one
+        mandatory positional argument depending on *takes_self*.
+    :param bool takes_self: Pass the partially initialized instance that is
+        being initialized as a positional argument.
+
+    .. versionadded:: 17.1.0  *takes_self*
+    """
+
+    __slots__ = ("factory", "takes_self")
+
+    def __init__(self, factory, takes_self=False):
+        """
+        `Factory` is part of the default machinery so if we want a default
+        value here, we have to implement it ourselves.
+        """
+        self.factory = factory
+        self.takes_self = takes_self
+
+    def __getstate__(self):
+        """
+        Play nice with pickle.
+        """
+        return tuple(getattr(self, name) for name in self.__slots__)
+
+    def __setstate__(self, state):
+        """
+        Play nice with pickle.
+        """
+        for name, value in zip(self.__slots__, state):
+            setattr(self, name, value)
+
+
+_f = [
+    Attribute(
+        name=name,
+        default=NOTHING,
+        validator=None,
+        repr=True,
+        cmp=None,
+        eq=True,
+        order=False,
+        hash=True,
+        init=True,
+        inherited=False,
+    )
+    for name in Factory.__slots__
+]
+
+Factory = _add_hash(_add_eq(_add_repr(Factory, attrs=_f), attrs=_f), attrs=_f)
+
+
+def make_class(name, attrs, bases=(object,), **attributes_arguments):
+    """
+    A quick way to create a new class called *name* with *attrs*.
+
+    :param str name: The name for the new class.
+
+    :param attrs: A list of names or a dictionary of mappings of names to
+        attributes.
+
+        If *attrs* is a list or an ordered dict (`dict` on Python 3.6+,
+        `collections.OrderedDict` otherwise), the order is deduced from
+        the order of the names or attributes inside *attrs*.  Otherwise the
+        order of the definition of the attributes is used.
+    :type attrs: `list` or `dict`
+
+    :param tuple bases: Classes that the new class will subclass.
+
+    :param attributes_arguments: Passed unmodified to `attr.s`.
+
+    :return: A new class with *attrs*.
+    :rtype: type
+
+    .. versionadded:: 17.1.0 *bases*
+    .. versionchanged:: 18.1.0 If *attrs* is ordered, the order is retained.
+    """
+    if isinstance(attrs, dict):
+        cls_dict = attrs
+    elif isinstance(attrs, (list, tuple)):
+        cls_dict = dict((a, attrib()) for a in attrs)
+    else:
+        raise TypeError("attrs argument must be a dict or a list.")
+
+    pre_init = cls_dict.pop("__attrs_pre_init__", None)
+    post_init = cls_dict.pop("__attrs_post_init__", None)
+    user_init = cls_dict.pop("__init__", None)
+
+    body = {}
+    if pre_init is not None:
+        body["__attrs_pre_init__"] = pre_init
+    if post_init is not None:
+        body["__attrs_post_init__"] = post_init
+    if user_init is not None:
+        body["__init__"] = user_init
+
+    type_ = new_class(name, bases, {}, lambda ns: ns.update(body))
+
+    # For pickling to work, the __module__ variable needs to be set to the
+    # frame where the class is created.  Bypass this step in environments where
+    # sys._getframe is not defined (Jython for example) or sys._getframe is not
+    # defined for arguments greater than 0 (IronPython).
+    try:
+        type_.__module__ = sys._getframe(1).f_globals.get(
+            "__name__", "__main__"
+        )
+    except (AttributeError, ValueError):
+        pass
+
+    # We do it here for proper warnings with meaningful stacklevel.
+    cmp = attributes_arguments.pop("cmp", None)
+    (
+        attributes_arguments["eq"],
+        attributes_arguments["order"],
+    ) = _determine_attrs_eq_order(
+        cmp,
+        attributes_arguments.get("eq"),
+        attributes_arguments.get("order"),
+        True,
+    )
+
+    return _attrs(these=cls_dict, **attributes_arguments)(type_)
+
+
+# These are required by within this module so we define them here and merely
+# import into .validators / .converters.
+
+
+@attrs(slots=True, hash=True)
+class _AndValidator(object):
+    """
+    Compose many validators to a single one.
+    """
+
+    _validators = attrib()
+
+    def __call__(self, inst, attr, value):
+        for v in self._validators:
+            v(inst, attr, value)
+
+
+def and_(*validators):
+    """
+    A validator that composes multiple validators into one.
+
+    When called on a value, it runs all wrapped validators.
+
+    :param callables validators: Arbitrary number of validators.
+
+    .. versionadded:: 17.1.0
+    """
+    vals = []
+    for validator in validators:
+        vals.extend(
+            validator._validators
+            if isinstance(validator, _AndValidator)
+            else [validator]
+        )
+
+    return _AndValidator(tuple(vals))
+
+
+def pipe(*converters):
+    """
+    A converter that composes multiple converters into one.
+
+    When called on a value, it runs all wrapped converters, returning the
+    *last* value.
+
+    Type annotations will be inferred from the wrapped converters', if
+    they have any.
+
+    :param callables converters: Arbitrary number of converters.
+
+    .. versionadded:: 20.1.0
+    """
+
+    def pipe_converter(val):
+        for converter in converters:
+            val = converter(val)
+
+        return val
+
+    if not PY2:
+        if not converters:
+            # If the converter list is empty, pipe_converter is the identity.
+            A = typing.TypeVar("A")
+            pipe_converter.__annotations__ = {"val": A, "return": A}
+        else:
+            # Get parameter type.
+            sig = None
+            try:
+                sig = inspect.signature(converters[0])
+            except (ValueError, TypeError):  # inspect failed
+                pass
+            if sig:
+                params = list(sig.parameters.values())
+                if (
+                    params
+                    and params[0].annotation is not inspect.Parameter.empty
+                ):
+                    pipe_converter.__annotations__["val"] = params[
+                        0
+                    ].annotation
+            # Get return type.
+            sig = None
+            try:
+                sig = inspect.signature(converters[-1])
+            except (ValueError, TypeError):  # inspect failed
+                pass
+            if sig and sig.return_annotation is not inspect.Signature().empty:
+                pipe_converter.__annotations__[
+                    "return"
+                ] = sig.return_annotation
+
+    return pipe_converter
diff --git a/openpype/hosts/fusion/vendor/attr/_next_gen.py b/openpype/hosts/fusion/vendor/attr/_next_gen.py
new file mode 100644
index 0000000000..fab0af966a
--- /dev/null
+++ b/openpype/hosts/fusion/vendor/attr/_next_gen.py
@@ -0,0 +1,158 @@
+"""
+These are Python 3.6+-only and keyword-only APIs that call `attr.s` and
+`attr.ib` with different default values.
+"""
+
+from functools import partial
+
+from attr.exceptions import UnannotatedAttributeError
+
+from . import setters
+from ._make import NOTHING, _frozen_setattrs, attrib, attrs
+
+
+def define(
+    maybe_cls=None,
+    *,
+    these=None,
+    repr=None,
+    hash=None,
+    init=None,
+    slots=True,
+    frozen=False,
+    weakref_slot=True,
+    str=False,
+    auto_attribs=None,
+    kw_only=False,
+    cache_hash=False,
+    auto_exc=True,
+    eq=None,
+    order=False,
+    auto_detect=True,
+    getstate_setstate=None,
+    on_setattr=None,
+    field_transformer=None,
+):
+    r"""
+    The only behavioral differences are the handling of the *auto_attribs*
+    option:
+
+    :param Optional[bool] auto_attribs: If set to `True` or `False`, it behaves
+       exactly like `attr.s`. If left `None`, `attr.s` will try to guess:
+
+       1. If any attributes are annotated and no unannotated `attr.ib`\ s
+          are found, it assumes *auto_attribs=True*.
+       2. Otherwise it assumes *auto_attribs=False* and tries to collect
+          `attr.ib`\ s.
+
+    and that mutable classes (``frozen=False``) validate on ``__setattr__``.
+
+    .. versionadded:: 20.1.0
+    """
+
+    def do_it(cls, auto_attribs):
+        return attrs(
+            maybe_cls=cls,
+            these=these,
+            repr=repr,
+            hash=hash,
+            init=init,
+            slots=slots,
+            frozen=frozen,
+            weakref_slot=weakref_slot,
+            str=str,
+            auto_attribs=auto_attribs,
+            kw_only=kw_only,
+            cache_hash=cache_hash,
+            auto_exc=auto_exc,
+            eq=eq,
+            order=order,
+            auto_detect=auto_detect,
+            collect_by_mro=True,
+            getstate_setstate=getstate_setstate,
+            on_setattr=on_setattr,
+            field_transformer=field_transformer,
+        )
+
+    def wrap(cls):
+        """
+        Making this a wrapper ensures this code runs during class creation.
+
+        We also ensure that frozen-ness of classes is inherited.
+        """
+        nonlocal frozen, on_setattr
+
+        had_on_setattr = on_setattr not in (None, setters.NO_OP)
+
+        # By default, mutable classes validate on setattr.
+        if frozen is False and on_setattr is None:
+            on_setattr = setters.validate
+
+        # However, if we subclass a frozen class, we inherit the immutability
+        # and disable on_setattr.
+        for base_cls in cls.__bases__:
+            if base_cls.__setattr__ is _frozen_setattrs:
+                if had_on_setattr:
+                    raise ValueError(
+                        "Frozen classes can't use on_setattr "
+                        "(frozen-ness was inherited)."
+                    )
+
+                on_setattr = setters.NO_OP
+                break
+
+        if auto_attribs is not None:
+            return do_it(cls, auto_attribs)
+
+        try:
+            return do_it(cls, True)
+        except UnannotatedAttributeError:
+            return do_it(cls, False)
+
+    # maybe_cls's type depends on the usage of the decorator.  It's a class
+    # if it's used as `@attrs` but ``None`` if used as `@attrs()`.
+    if maybe_cls is None:
+        return wrap
+    else:
+        return wrap(maybe_cls)
+
+
+mutable = define
+frozen = partial(define, frozen=True, on_setattr=None)
+
+
+def field(
+    *,
+    default=NOTHING,
+    validator=None,
+    repr=True,
+    hash=None,
+    init=True,
+    metadata=None,
+    converter=None,
+    factory=None,
+    kw_only=False,
+    eq=None,
+    order=None,
+    on_setattr=None,
+):
+    """
+    Identical to `attr.ib`, except keyword-only and with some arguments
+    removed.
+
+    .. versionadded:: 20.1.0
+    """
+    return attrib(
+        default=default,
+        validator=validator,
+        repr=repr,
+        hash=hash,
+        init=init,
+        metadata=metadata,
+        converter=converter,
+        factory=factory,
+        kw_only=kw_only,
+        eq=eq,
+        order=order,
+        on_setattr=on_setattr,
+    )
diff --git a/openpype/hosts/fusion/vendor/attr/_version_info.py b/openpype/hosts/fusion/vendor/attr/_version_info.py
new file mode 100644
index 0000000000..014e78a1b4
--- /dev/null
+++ b/openpype/hosts/fusion/vendor/attr/_version_info.py
@@ -0,0 +1,85 @@
+from __future__ import absolute_import, division, print_function
+
+from functools import total_ordering
+
+from ._funcs import astuple
+from ._make import attrib, attrs
+
+
+@total_ordering
+@attrs(eq=False, order=False, slots=True, frozen=True)
+class VersionInfo(object):
+    """
+    A version object that can be compared to tuple of length 1--4:
+
+    >>> attr.VersionInfo(19, 1, 0, "final")  <= (19, 2)
+    True
+    >>> attr.VersionInfo(19, 1, 0, "final") < (19, 1, 1)
+    True
+    >>> vi = attr.VersionInfo(19, 2, 0, "final")
+    >>> vi < (19, 1, 1)
+    False
+    >>> vi < (19,)
+    False
+    >>> vi == (19, 2,)
+    True
+    >>> vi == (19, 2, 1)
+    False
+
+    .. versionadded:: 19.2
+    """
+
+    year = attrib(type=int)
+    minor = attrib(type=int)
+    micro = attrib(type=int)
+    releaselevel = attrib(type=str)
+
+    @classmethod
+    def _from_version_string(cls, s):
+        """
+        Parse *s* and return a _VersionInfo.
+        """
+        v = s.split(".")
+        if len(v) == 3:
+            v.append("final")
+
+        return cls(
+            year=int(v[0]), minor=int(v[1]), micro=int(v[2]), releaselevel=v[3]
+        )
+
+    def _ensure_tuple(self, other):
+        """
+        Ensure *other* is a tuple of a valid length.
+
+        Returns a possibly transformed *other* and ourselves as a tuple of
+        the same length as *other*.
+        """
+
+        if self.__class__ is other.__class__:
+            other = astuple(other)
+
+        if not isinstance(other, tuple):
+            raise NotImplementedError
+
+        if not (1 <= len(other) <= 4):
+            raise NotImplementedError
+
+        return astuple(self)[: len(other)], other
+
+    def __eq__(self, other):
+        try:
+            us, them = self._ensure_tuple(other)
+        except NotImplementedError:
+            return NotImplemented
+
+        return us == them
+
+    def __lt__(self, other):
+        try:
+            us, them = self._ensure_tuple(other)
+        except NotImplementedError:
+            return NotImplemented
+
+        # Since alphabetically "dev0" < "final" < "post1" < "post2", we don't
+        # have to do anything special with releaselevel for now.
+        return us < them
diff --git a/openpype/hosts/fusion/vendor/attr/_version_info.pyi b/openpype/hosts/fusion/vendor/attr/_version_info.pyi
new file mode 100644
index 0000000000..45ced08633
--- /dev/null
+++ b/openpype/hosts/fusion/vendor/attr/_version_info.pyi
@@ -0,0 +1,9 @@
+class VersionInfo:
+    @property
+    def year(self) -> int: ...
+    @property
+    def minor(self) -> int: ...
+    @property
+    def micro(self) -> int: ...
+    @property
+    def releaselevel(self) -> str: ...
diff --git a/openpype/hosts/fusion/vendor/attr/converters.py b/openpype/hosts/fusion/vendor/attr/converters.py
new file mode 100644
index 0000000000..2777db6d0a
--- /dev/null
+++ b/openpype/hosts/fusion/vendor/attr/converters.py
@@ -0,0 +1,111 @@
+"""
+Commonly useful converters.
+"""
+
+from __future__ import absolute_import, division, print_function
+
+from ._compat import PY2
+from ._make import NOTHING, Factory, pipe
+
+
+if not PY2:
+    import inspect
+    import typing
+
+
+__all__ = [
+    "pipe",
+    "optional",
+    "default_if_none",
+]
+
+
+def optional(converter):
+    """
+    A converter that allows an attribute to be optional. An optional attribute
+    is one which can be set to ``None``.
+
+    Type annotations will be inferred from the wrapped converter's, if it
+    has any.
+
+    :param callable converter: the converter that is used for non-``None``
+        values.
+
+    .. versionadded:: 17.1.0
+    """
+
+    def optional_converter(val):
+        if val is None:
+            return None
+        return converter(val)
+
+    if not PY2:
+        sig = None
+        try:
+            sig = inspect.signature(converter)
+        except (ValueError, TypeError):  # inspect failed
+            pass
+        if sig:
+            params = list(sig.parameters.values())
+            if params and params[0].annotation is not inspect.Parameter.empty:
+                optional_converter.__annotations__["val"] = typing.Optional[
+                    params[0].annotation
+                ]
+            if sig.return_annotation is not inspect.Signature.empty:
+                optional_converter.__annotations__["return"] = typing.Optional[
+                    sig.return_annotation
+                ]
+
+    return optional_converter
+
+
+def default_if_none(default=NOTHING, factory=None):
+    """
+    A converter that allows to replace ``None`` values by *default* or the
+    result of *factory*.
+
+    :param default: Value to be used if ``None`` is passed. Passing an instance
+       of `attr.Factory` is supported, however the ``takes_self`` option
+       is *not*.
+    :param callable factory: A callable that takes no parameters whose result
+       is used if ``None`` is passed.
+
+    :raises TypeError: If **neither** *default* or *factory* is passed.
+    :raises TypeError: If **both** *default* and *factory* are passed.
+    :raises ValueError: If an instance of `attr.Factory` is passed with
+       ``takes_self=True``.
+
+    .. versionadded:: 18.2.0
+    """
+    if default is NOTHING and factory is None:
+        raise TypeError("Must pass either `default` or `factory`.")
+
+    if default is not NOTHING and factory is not None:
+        raise TypeError(
+            "Must pass either `default` or `factory` but not both."
+        )
+
+    if factory is not None:
+        default = Factory(factory)
+
+    if isinstance(default, Factory):
+        if default.takes_self:
+            raise ValueError(
+                "`takes_self` is not supported by default_if_none."
+            )
+
+        def default_if_none_converter(val):
+            if val is not None:
+                return val
+
+            return default.factory()
+
+    else:
+
+        def default_if_none_converter(val):
+            if val is not None:
+                return val
+
+            return default
+
+    return default_if_none_converter
diff --git a/openpype/hosts/fusion/vendor/attr/converters.pyi b/openpype/hosts/fusion/vendor/attr/converters.pyi
new file mode 100644
index 0000000000..84a57590b0
--- /dev/null
+++ b/openpype/hosts/fusion/vendor/attr/converters.pyi
@@ -0,0 +1,13 @@
+from typing import Callable, Optional, TypeVar, overload
+
+from . import _ConverterType
+
+
+_T = TypeVar("_T")
+
+def pipe(*validators: _ConverterType) -> _ConverterType: ...
+def optional(converter: _ConverterType) -> _ConverterType: ...
+@overload
+def default_if_none(default: _T) -> _ConverterType: ...
+@overload
+def default_if_none(*, factory: Callable[[], _T]) -> _ConverterType: ...
diff --git a/openpype/hosts/fusion/vendor/attr/exceptions.py b/openpype/hosts/fusion/vendor/attr/exceptions.py
new file mode 100644
index 0000000000..f6f9861bea
--- /dev/null
+++ b/openpype/hosts/fusion/vendor/attr/exceptions.py
@@ -0,0 +1,92 @@
+from __future__ import absolute_import, division, print_function
+
+
+class FrozenError(AttributeError):
+    """
+    A frozen/immutable instance or attribute have been attempted to be
+    modified.
+
+    It mirrors the behavior of ``namedtuples`` by using the same error message
+    and subclassing `AttributeError`.
+
+    .. versionadded:: 20.1.0
+    """
+
+    msg = "can't set attribute"
+    args = [msg]
+
+
+class FrozenInstanceError(FrozenError):
+    """
+    A frozen instance has been attempted to be modified.
+
+    .. versionadded:: 16.1.0
+    """
+
+
+class FrozenAttributeError(FrozenError):
+    """
+    A frozen attribute has been attempted to be modified.
+
+    .. versionadded:: 20.1.0
+    """
+
+
+class AttrsAttributeNotFoundError(ValueError):
+    """
+    An ``attrs`` function couldn't find an attribute that the user asked for.
+
+    .. versionadded:: 16.2.0
+    """
+
+
+class NotAnAttrsClassError(ValueError):
+    """
+    A non-``attrs`` class has been passed into an ``attrs`` function.
+
+    .. versionadded:: 16.2.0
+    """
+
+
+class DefaultAlreadySetError(RuntimeError):
+    """
+    A default has been set using ``attr.ib()`` and is attempted to be reset
+    using the decorator.
+
+    .. versionadded:: 17.1.0
+    """
+
+
+class UnannotatedAttributeError(RuntimeError):
+    """
+    A class with ``auto_attribs=True`` has an ``attr.ib()`` without a type
+    annotation.
+
+    .. versionadded:: 17.3.0
+    """
+
+
+class PythonTooOldError(RuntimeError):
+    """
+    It was attempted to use an ``attrs`` feature that requires a newer Python
+    version.
+
+    .. versionadded:: 18.2.0
+    """
+
+
+class NotCallableError(TypeError):
+    """
+    A ``attr.ib()`` requiring a callable has been set with a value
+    that is not callable.
+
+    .. versionadded:: 19.2.0
+    """
+
+    def __init__(self, msg, value):
+        super(TypeError, self).__init__(msg, value)
+        self.msg = msg
+        self.value = value
+
+    def __str__(self):
+        return str(self.msg)
diff --git a/openpype/hosts/fusion/vendor/attr/exceptions.pyi b/openpype/hosts/fusion/vendor/attr/exceptions.pyi
new file mode 100644
index 0000000000..a800fb26bb
--- /dev/null
+++ b/openpype/hosts/fusion/vendor/attr/exceptions.pyi
@@ -0,0 +1,18 @@
+from typing import Any
+
+
+class FrozenError(AttributeError):
+    msg: str = ...
+
+class FrozenInstanceError(FrozenError): ...
+class FrozenAttributeError(FrozenError): ...
+class AttrsAttributeNotFoundError(ValueError): ...
+class NotAnAttrsClassError(ValueError): ...
+class DefaultAlreadySetError(RuntimeError): ...
+class UnannotatedAttributeError(RuntimeError): ...
+class PythonTooOldError(RuntimeError): ...
+
+class NotCallableError(TypeError):
+    msg: str = ...
+    value: Any = ...
+    def __init__(self, msg: str, value: Any) -> None: ...
diff --git a/openpype/hosts/fusion/vendor/attr/filters.py b/openpype/hosts/fusion/vendor/attr/filters.py
new file mode 100644
index 0000000000..dc47e8fa38
--- /dev/null
+++ b/openpype/hosts/fusion/vendor/attr/filters.py
@@ -0,0 +1,52 @@
+"""
+Commonly useful filters for `attr.asdict`.
+"""
+
+from __future__ import absolute_import, division, print_function
+
+from ._compat import isclass
+from ._make import Attribute
+
+
+def _split_what(what):
+    """
+    Returns a tuple of `frozenset`s of classes and attributes.
+    """
+    return (
+        frozenset(cls for cls in what if isclass(cls)),
+        frozenset(cls for cls in what if isinstance(cls, Attribute)),
+    )
+
+
+def include(*what):
+    """
+    Whitelist *what*.
+
+    :param what: What to whitelist.
+    :type what: `list` of `type` or `attr.Attribute`\\ s
+
+    :rtype: `callable`
+    """
+    cls, attrs = _split_what(what)
+
+    def include_(attribute, value):
+        return value.__class__ in cls or attribute in attrs
+
+    return include_
+
+
+def exclude(*what):
+    """
+    Blacklist *what*.
+
+    :param what: What to blacklist.
+    :type what: `list` of classes or `attr.Attribute`\\ s.
+
+    :rtype: `callable`
+    """
+    cls, attrs = _split_what(what)
+
+    def exclude_(attribute, value):
+        return value.__class__ not in cls and attribute not in attrs
+
+    return exclude_
diff --git a/openpype/hosts/fusion/vendor/attr/filters.pyi b/openpype/hosts/fusion/vendor/attr/filters.pyi
new file mode 100644
index 0000000000..f7b63f1bb4
--- /dev/null
+++ b/openpype/hosts/fusion/vendor/attr/filters.pyi
@@ -0,0 +1,7 @@
+from typing import Any, Union
+
+from . import Attribute, _FilterType
+
+
+def include(*what: Union[type, Attribute[Any]]) -> _FilterType[Any]: ...
+def exclude(*what: Union[type, Attribute[Any]]) -> _FilterType[Any]: ...
diff --git a/openpype/hosts/fusion/vendor/attr/py.typed b/openpype/hosts/fusion/vendor/attr/py.typed
new file mode 100644
index 0000000000..e69de29bb2
diff --git a/openpype/hosts/fusion/vendor/attr/setters.py b/openpype/hosts/fusion/vendor/attr/setters.py
new file mode 100644
index 0000000000..240014b3c1
--- /dev/null
+++ b/openpype/hosts/fusion/vendor/attr/setters.py
@@ -0,0 +1,77 @@
+"""
+Commonly used hooks for on_setattr.
+"""
+
+from __future__ import absolute_import, division, print_function
+
+from . import _config
+from .exceptions import FrozenAttributeError
+
+
+def pipe(*setters):
+    """
+    Run all *setters* and return the return value of the last one.
+
+    .. versionadded:: 20.1.0
+    """
+
+    def wrapped_pipe(instance, attrib, new_value):
+        rv = new_value
+
+        for setter in setters:
+            rv = setter(instance, attrib, rv)
+
+        return rv
+
+    return wrapped_pipe
+
+
+def frozen(_, __, ___):
+    """
+    Prevent an attribute to be modified.
+
+    .. versionadded:: 20.1.0
+    """
+    raise FrozenAttributeError()
+
+
+def validate(instance, attrib, new_value):
+    """
+    Run *attrib*'s validator on *new_value* if it has one.
+
+    .. versionadded:: 20.1.0
+    """
+    if _config._run_validators is False:
+        return new_value
+
+    v = attrib.validator
+    if not v:
+        return new_value
+
+    v(instance, attrib, new_value)
+
+    return new_value
+
+
+def convert(instance, attrib, new_value):
+    """
+    Run *attrib*'s converter -- if it has one --  on *new_value* and return the
+    result.
+
+    .. versionadded:: 20.1.0
+    """
+    c = attrib.converter
+    if c:
+        return c(new_value)
+
+    return new_value
+
+
+NO_OP = object()
+"""
+Sentinel for disabling class-wide *on_setattr* hooks for certain attributes.
+
+Does not work in `pipe` or within lists.
+
+.. versionadded:: 20.1.0
+"""
diff --git a/openpype/hosts/fusion/vendor/attr/setters.pyi b/openpype/hosts/fusion/vendor/attr/setters.pyi
new file mode 100644
index 0000000000..a921e07deb
--- /dev/null
+++ b/openpype/hosts/fusion/vendor/attr/setters.pyi
@@ -0,0 +1,20 @@
+from typing import Any, NewType, NoReturn, TypeVar, cast
+
+from . import Attribute, _OnSetAttrType
+
+
+_T = TypeVar("_T")
+
+def frozen(
+    instance: Any, attribute: Attribute[Any], new_value: Any
+) -> NoReturn: ...
+def pipe(*setters: _OnSetAttrType) -> _OnSetAttrType: ...
+def validate(instance: Any, attribute: Attribute[_T], new_value: _T) -> _T: ...
+
+# convert is allowed to return Any, because they can be chained using pipe.
+def convert(
+    instance: Any, attribute: Attribute[Any], new_value: Any
+) -> Any: ...
+
+_NoOpType = NewType("_NoOpType", object)
+NO_OP: _NoOpType
diff --git a/openpype/hosts/fusion/vendor/attr/validators.py b/openpype/hosts/fusion/vendor/attr/validators.py
new file mode 100644
index 0000000000..b9a73054e9
--- /dev/null
+++ b/openpype/hosts/fusion/vendor/attr/validators.py
@@ -0,0 +1,379 @@
+"""
+Commonly useful validators.
+"""
+
+from __future__ import absolute_import, division, print_function
+
+import re
+
+from ._make import _AndValidator, and_, attrib, attrs
+from .exceptions import NotCallableError
+
+
+__all__ = [
+    "and_",
+    "deep_iterable",
+    "deep_mapping",
+    "in_",
+    "instance_of",
+    "is_callable",
+    "matches_re",
+    "optional",
+    "provides",
+]
+
+
+@attrs(repr=False, slots=True, hash=True)
+class _InstanceOfValidator(object):
+    type = attrib()
+
+    def __call__(self, inst, attr, value):
+        """
+        We use a callable class to be able to change the ``__repr__``.
+        """
+        if not isinstance(value, self.type):
+            raise TypeError(
+                "'{name}' must be {type!r} (got {value!r} that is a "
+                "{actual!r}).".format(
+                    name=attr.name,
+                    type=self.type,
+                    actual=value.__class__,
+                    value=value,
+                ),
+                attr,
+                self.type,
+                value,
+            )
+
+    def __repr__(self):
+        return "<instance_of validator for type {type!r}>".format(
+            type=self.type
+        )
+
+
+def instance_of(type):
+    """
+    A validator that raises a `TypeError` if the initializer is called
+    with a wrong type for this particular attribute (checks are performed using
+    `isinstance` therefore it's also valid to pass a tuple of types).
+
+    :param type: The type to check for.
+    :type type: type or tuple of types
+
+    :raises TypeError: With a human readable error message, the attribute
+        (of type `attr.Attribute`), the expected type, and the value it
+        got.
+    """
+    return _InstanceOfValidator(type)
+
+
+@attrs(repr=False, frozen=True, slots=True)
+class _MatchesReValidator(object):
+    regex = attrib()
+    flags = attrib()
+    match_func = attrib()
+
+    def __call__(self, inst, attr, value):
+        """
+        We use a callable class to be able to change the ``__repr__``.
+        """
+        if not self.match_func(value):
+            raise ValueError(
+                "'{name}' must match regex {regex!r}"
+                " ({value!r} doesn't)".format(
+                    name=attr.name, regex=self.regex.pattern, value=value
+                ),
+                attr,
+                self.regex,
+                value,
+            )
+
+    def __repr__(self):
+        return "<matches_re validator for pattern {regex!r}>".format(
+            regex=self.regex
+        )
+
+
+def matches_re(regex, flags=0, func=None):
+    r"""
+    A validator that raises `ValueError` if the initializer is called
+    with a string that doesn't match *regex*.
+
+    :param str regex: a regex string to match against
+    :param int flags: flags that will be passed to the underlying re function
+        (default 0)
+    :param callable func: which underlying `re` function to call (options
+        are `re.fullmatch`, `re.search`, `re.match`, default
+        is ``None`` which means either `re.fullmatch` or an emulation of
+        it on Python 2). For performance reasons, they won't be used directly
+        but on a pre-`re.compile`\ ed pattern.
+
+    .. versionadded:: 19.2.0
+    """
+    fullmatch = getattr(re, "fullmatch", None)
+    valid_funcs = (fullmatch, None, re.search, re.match)
+    if func not in valid_funcs:
+        raise ValueError(
+            "'func' must be one of %s."
+            % (
+                ", ".join(
+                    sorted(
+                        e and e.__name__ or "None" for e in set(valid_funcs)
+                    )
+                ),
+            )
+        )
+
+    pattern = re.compile(regex, flags)
+    if func is re.match:
+        match_func = pattern.match
+    elif func is re.search:
+        match_func = pattern.search
+    else:
+        if fullmatch:
+            match_func = pattern.fullmatch
+        else:
+            pattern = re.compile(r"(?:{})\Z".format(regex), flags)
+            match_func = pattern.match
+
+    return _MatchesReValidator(pattern, flags, match_func)
+
+
+@attrs(repr=False, slots=True, hash=True)
+class _ProvidesValidator(object):
+    interface = attrib()
+
+    def __call__(self, inst, attr, value):
+        """
+        We use a callable class to be able to change the ``__repr__``.
+        """
+        if not self.interface.providedBy(value):
+            raise TypeError(
+                "'{name}' must provide {interface!r} which {value!r} "
+                "doesn't.".format(
+                    name=attr.name, interface=self.interface, value=value
+                ),
+                attr,
+                self.interface,
+                value,
+            )
+
+    def __repr__(self):
+        return "<provides validator for interface {interface!r}>".format(
+            interface=self.interface
+        )
+
+
+def provides(interface):
+    """
+    A validator that raises a `TypeError` if the initializer is called
+    with an object that does not provide the requested *interface* (checks are
+    performed using ``interface.providedBy(value)`` (see `zope.interface
+    <https://zopeinterface.readthedocs.io/en/latest/>`_).
+
+    :param interface: The interface to check for.
+    :type interface: ``zope.interface.Interface``
+
+    :raises TypeError: With a human readable error message, the attribute
+        (of type `attr.Attribute`), the expected interface, and the
+        value it got.
+    """
+    return _ProvidesValidator(interface)
+
+
+@attrs(repr=False, slots=True, hash=True)
+class _OptionalValidator(object):
+    validator = attrib()
+
+    def __call__(self, inst, attr, value):
+        if value is None:
+            return
+
+        self.validator(inst, attr, value)
+
+    def __repr__(self):
+        return "<optional validator for {what} or None>".format(
+            what=repr(self.validator)
+        )
+
+
+def optional(validator):
+    """
+    A validator that makes an attribute optional.  An optional attribute is one
+    which can be set to ``None`` in addition to satisfying the requirements of
+    the sub-validator.
+
+    :param validator: A validator (or a list of validators) that is used for
+        non-``None`` values.
+    :type validator: callable or `list` of callables.
+
+    .. versionadded:: 15.1.0
+    .. versionchanged:: 17.1.0 *validator* can be a list of validators.
+    """
+    if isinstance(validator, list):
+        return _OptionalValidator(_AndValidator(validator))
+    return _OptionalValidator(validator)
+
+
+@attrs(repr=False, slots=True, hash=True)
+class _InValidator(object):
+    options = attrib()
+
+    def __call__(self, inst, attr, value):
+        try:
+            in_options = value in self.options
+        except TypeError:  # e.g. `1 in "abc"`
+            in_options = False
+
+        if not in_options:
+            raise ValueError(
+                "'{name}' must be in {options!r} (got {value!r})".format(
+                    name=attr.name, options=self.options, value=value
+                )
+            )
+
+    def __repr__(self):
+        return "<in_ validator with options {options!r}>".format(
+            options=self.options
+        )
+
+
+def in_(options):
+    """
+    A validator that raises a `ValueError` if the initializer is called
+    with a value that does not belong in the options provided.  The check is
+    performed using ``value in options``.
+
+    :param options: Allowed options.
+    :type options: list, tuple, `enum.Enum`, ...
+
+    :raises ValueError: With a human readable error message, the attribute (of
+       type `attr.Attribute`), the expected options, and the value it
+       got.
+
+    .. versionadded:: 17.1.0
+    """
+    return _InValidator(options)
+
+
+@attrs(repr=False, slots=False, hash=True)
+class _IsCallableValidator(object):
+    def __call__(self, inst, attr, value):
+        """
+        We use a callable class to be able to change the ``__repr__``.
+        """
+        if not callable(value):
+            message = (
+                "'{name}' must be callable "
+                "(got {value!r} that is a {actual!r})."
+            )
+            raise NotCallableError(
+                msg=message.format(
+                    name=attr.name, value=value, actual=value.__class__
+                ),
+                value=value,
+            )
+
+    def __repr__(self):
+        return "<is_callable validator>"
+
+
+def is_callable():
+    """
+    A validator that raises a `attr.exceptions.NotCallableError` if the
+    initializer is called with a value for this particular attribute
+    that is not callable.
+
+    .. versionadded:: 19.1.0
+
+    :raises `attr.exceptions.NotCallableError`: With a human readable error
+        message containing the attribute (`attr.Attribute`) name,
+        and the value it got.
+    """
+    return _IsCallableValidator()
+
+
+@attrs(repr=False, slots=True, hash=True)
+class _DeepIterable(object):
+    member_validator = attrib(validator=is_callable())
+    iterable_validator = attrib(
+        default=None, validator=optional(is_callable())
+    )
+
+    def __call__(self, inst, attr, value):
+        """
+        We use a callable class to be able to change the ``__repr__``.
+        """
+        if self.iterable_validator is not None:
+            self.iterable_validator(inst, attr, value)
+
+        for member in value:
+            self.member_validator(inst, attr, member)
+
+    def __repr__(self):
+        iterable_identifier = (
+            ""
+            if self.iterable_validator is None
+            else " {iterable!r}".format(iterable=self.iterable_validator)
+        )
+        return (
+            "<deep_iterable validator for{iterable_identifier}"
+            " iterables of {member!r}>"
+        ).format(
+            iterable_identifier=iterable_identifier,
+            member=self.member_validator,
+        )
+
+
+def deep_iterable(member_validator, iterable_validator=None):
+    """
+    A validator that performs deep validation of an iterable.
+
+    :param member_validator: Validator to apply to iterable members
+    :param iterable_validator: Validator to apply to iterable itself
+        (optional)
+
+    .. versionadded:: 19.1.0
+
+    :raises TypeError: if any sub-validators fail
+    """
+    return _DeepIterable(member_validator, iterable_validator)
+
+
+@attrs(repr=False, slots=True, hash=True)
+class _DeepMapping(object):
+    key_validator = attrib(validator=is_callable())
+    value_validator = attrib(validator=is_callable())
+    mapping_validator = attrib(default=None, validator=optional(is_callable()))
+
+    def __call__(self, inst, attr, value):
+        """
+        We use a callable class to be able to change the ``__repr__``.
+        """
+        if self.mapping_validator is not None:
+            self.mapping_validator(inst, attr, value)
+
+        for key in value:
+            self.key_validator(inst, attr, key)
+            self.value_validator(inst, attr, value[key])
+
+    def __repr__(self):
+        return (
+            "<deep_mapping validator for objects mapping {key!r} to {value!r}>"
+        ).format(key=self.key_validator, value=self.value_validator)
+
+
+def deep_mapping(key_validator, value_validator, mapping_validator=None):
+    """
+    A validator that performs deep validation of a dictionary.
+
+    :param key_validator: Validator to apply to dictionary keys
+    :param value_validator: Validator to apply to dictionary values
+    :param mapping_validator: Validator to apply to top-level mapping
+        attribute (optional)
+
+    .. versionadded:: 19.1.0
+
+    :raises TypeError: if any sub-validators fail
+    """
+    return _DeepMapping(key_validator, value_validator, mapping_validator)
diff --git a/openpype/hosts/fusion/vendor/attr/validators.pyi b/openpype/hosts/fusion/vendor/attr/validators.pyi
new file mode 100644
index 0000000000..fe92aac421
--- /dev/null
+++ b/openpype/hosts/fusion/vendor/attr/validators.pyi
@@ -0,0 +1,68 @@
+from typing import (
+    Any,
+    AnyStr,
+    Callable,
+    Container,
+    Iterable,
+    List,
+    Mapping,
+    Match,
+    Optional,
+    Tuple,
+    Type,
+    TypeVar,
+    Union,
+    overload,
+)
+
+from . import _ValidatorType
+
+
+_T = TypeVar("_T")
+_T1 = TypeVar("_T1")
+_T2 = TypeVar("_T2")
+_T3 = TypeVar("_T3")
+_I = TypeVar("_I", bound=Iterable)
+_K = TypeVar("_K")
+_V = TypeVar("_V")
+_M = TypeVar("_M", bound=Mapping)
+
+# To be more precise on instance_of use some overloads.
+# If there are more than 3 items in the tuple then we fall back to Any
+@overload
+def instance_of(type: Type[_T]) -> _ValidatorType[_T]: ...
+@overload
+def instance_of(type: Tuple[Type[_T]]) -> _ValidatorType[_T]: ...
+@overload
+def instance_of(
+    type: Tuple[Type[_T1], Type[_T2]]
+) -> _ValidatorType[Union[_T1, _T2]]: ...
+@overload
+def instance_of(
+    type: Tuple[Type[_T1], Type[_T2], Type[_T3]]
+) -> _ValidatorType[Union[_T1, _T2, _T3]]: ...
+@overload
+def instance_of(type: Tuple[type, ...]) -> _ValidatorType[Any]: ...
+def provides(interface: Any) -> _ValidatorType[Any]: ...
+def optional(
+    validator: Union[_ValidatorType[_T], List[_ValidatorType[_T]]]
+) -> _ValidatorType[Optional[_T]]: ...
+def in_(options: Container[_T]) -> _ValidatorType[_T]: ...
+def and_(*validators: _ValidatorType[_T]) -> _ValidatorType[_T]: ...
+def matches_re(
+    regex: AnyStr,
+    flags: int = ...,
+    func: Optional[
+        Callable[[AnyStr, AnyStr, int], Optional[Match[AnyStr]]]
+    ] = ...,
+) -> _ValidatorType[AnyStr]: ...
+def deep_iterable(
+    member_validator: _ValidatorType[_T],
+    iterable_validator: Optional[_ValidatorType[_I]] = ...,
+) -> _ValidatorType[_I]: ...
+def deep_mapping(
+    key_validator: _ValidatorType[_K],
+    value_validator: _ValidatorType[_V],
+    mapping_validator: Optional[_ValidatorType[_M]] = ...,
+) -> _ValidatorType[_M]: ...
+def is_callable() -> _ValidatorType[_T]: ...
diff --git a/openpype/hosts/fusion/vendor/urllib3/__init__.py b/openpype/hosts/fusion/vendor/urllib3/__init__.py
new file mode 100644
index 0000000000..fe86b59d78
--- /dev/null
+++ b/openpype/hosts/fusion/vendor/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/hosts/fusion/vendor/urllib3/_collections.py b/openpype/hosts/fusion/vendor/urllib3/_collections.py
new file mode 100644
index 0000000000..da9857e986
--- /dev/null
+++ b/openpype/hosts/fusion/vendor/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/hosts/fusion/vendor/urllib3/_version.py b/openpype/hosts/fusion/vendor/urllib3/_version.py
new file mode 100644
index 0000000000..e8ebee957f
--- /dev/null
+++ b/openpype/hosts/fusion/vendor/urllib3/_version.py
@@ -0,0 +1,2 @@
+# This file is protected via CODEOWNERS
+__version__ = "1.26.6"
diff --git a/openpype/hosts/fusion/vendor/urllib3/connection.py b/openpype/hosts/fusion/vendor/urllib3/connection.py
new file mode 100644
index 0000000000..4c996659c8
--- /dev/null
+++ b/openpype/hosts/fusion/vendor/urllib3/connection.py
@@ -0,0 +1,539 @@
+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 .packages.ssl_match_hostname import CertificateError, match_hostname
+from .util import SKIP_HEADER, SKIPPABLE_HEADERS, connection
+from .util.ssl_ import (
+    assert_fingerprint,
+    create_urllib3_context,
+    resolve_cert_reqs,
+    resolve_ssl_version,
+    ssl_wrap_socket,
+)
+
+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
+
+    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
+        conn = self._new_conn()
+        hostname = self.host
+        tls_in_tls = False
+
+        if self._is_using_tunnel():
+            if self.tls_in_tls_required:
+                conn = self._connect_tls_proxy(hostname, conn)
+                tls_in_tls = True
+
+            self.sock = conn
+
+            # 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,
+        )
+        # By default urllib3's SSLContext disables `check_hostname` and uses
+        # a custom check. For proxies we're good with relying on the default
+        # verification.
+        ssl_context.check_hostname = True
+
+        # If no cert was provided, use only the default options for server
+        # certificate validation
+        return 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,
+        )
+
+
+def _match_hostname(cert, asserted_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/hosts/fusion/vendor/urllib3/connectionpool.py b/openpype/hosts/fusion/vendor/urllib3/connectionpool.py
new file mode 100644
index 0000000000..459bbe095b
--- /dev/null
+++ b/openpype/hosts/fusion/vendor/urllib3/connectionpool.py
@@ -0,0 +1,1067 @@
+from __future__ import absolute_import
+
+import errno
+import logging
+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 .packages.ssl_match_hostname import CertificateError
+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.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", self.host)
+
+        # 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
+            if 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,
+            )
+
+
+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/hosts/fusion/vendor/urllib3/contrib/__init__.py b/openpype/hosts/fusion/vendor/urllib3/contrib/__init__.py
new file mode 100644
index 0000000000..e69de29bb2
diff --git a/openpype/hosts/fusion/vendor/urllib3/contrib/_appengine_environ.py b/openpype/hosts/fusion/vendor/urllib3/contrib/_appengine_environ.py
new file mode 100644
index 0000000000..8765b907d7
--- /dev/null
+++ b/openpype/hosts/fusion/vendor/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/hosts/fusion/vendor/urllib3/contrib/_securetransport/__init__.py b/openpype/hosts/fusion/vendor/urllib3/contrib/_securetransport/__init__.py
new file mode 100644
index 0000000000..e69de29bb2
diff --git a/openpype/hosts/fusion/vendor/urllib3/contrib/_securetransport/bindings.py b/openpype/hosts/fusion/vendor/urllib3/contrib/_securetransport/bindings.py
new file mode 100644
index 0000000000..11524d400b
--- /dev/null
+++ b/openpype/hosts/fusion/vendor/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 urllib3.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/hosts/fusion/vendor/urllib3/contrib/_securetransport/low_level.py b/openpype/hosts/fusion/vendor/urllib3/contrib/_securetransport/low_level.py
new file mode 100644
index 0000000000..ed8120190c
--- /dev/null
+++ b/openpype/hosts/fusion/vendor/urllib3/contrib/_securetransport/low_level.py
@@ -0,0 +1,396 @@
+"""
+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)
+
+    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/hosts/fusion/vendor/urllib3/contrib/appengine.py b/openpype/hosts/fusion/vendor/urllib3/contrib/appengine.py
new file mode 100644
index 0000000000..f91bdd6e77
--- /dev/null
+++ b/openpype/hosts/fusion/vendor/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/hosts/fusion/vendor/urllib3/contrib/ntlmpool.py b/openpype/hosts/fusion/vendor/urllib3/contrib/ntlmpool.py
new file mode 100644
index 0000000000..41a8fd174c
--- /dev/null
+++ b/openpype/hosts/fusion/vendor/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/hosts/fusion/vendor/urllib3/contrib/pyopenssl.py b/openpype/hosts/fusion/vendor/urllib3/contrib/pyopenssl.py
new file mode 100644
index 0000000000..def83afdb2
--- /dev/null
+++ b/openpype/hosts/fusion/vendor/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/hosts/fusion/vendor/urllib3/contrib/securetransport.py b/openpype/hosts/fusion/vendor/urllib3/contrib/securetransport.py
new file mode 100644
index 0000000000..554c015fed
--- /dev/null
+++ b/openpype/hosts/fusion/vendor/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/hosts/fusion/vendor/urllib3/contrib/socks.py b/openpype/hosts/fusion/vendor/urllib3/contrib/socks.py
new file mode 100644
index 0000000000..c326e80dd1
--- /dev/null
+++ b/openpype/hosts/fusion/vendor/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/hosts/fusion/vendor/urllib3/exceptions.py b/openpype/hosts/fusion/vendor/urllib3/exceptions.py
new file mode 100644
index 0000000000..cba6f3f560
--- /dev/null
+++ b/openpype/hosts/fusion/vendor/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/hosts/fusion/vendor/urllib3/fields.py b/openpype/hosts/fusion/vendor/urllib3/fields.py
new file mode 100644
index 0000000000..9d630f491d
--- /dev/null
+++ b/openpype/hosts/fusion/vendor/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/hosts/fusion/vendor/urllib3/filepost.py b/openpype/hosts/fusion/vendor/urllib3/filepost.py
new file mode 100644
index 0000000000..36c9252c64
--- /dev/null
+++ b/openpype/hosts/fusion/vendor/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/hosts/fusion/vendor/urllib3/packages/__init__.py b/openpype/hosts/fusion/vendor/urllib3/packages/__init__.py
new file mode 100644
index 0000000000..fce4caa65d
--- /dev/null
+++ b/openpype/hosts/fusion/vendor/urllib3/packages/__init__.py
@@ -0,0 +1,5 @@
+from __future__ import absolute_import
+
+from . import ssl_match_hostname
+
+__all__ = ("ssl_match_hostname",)
diff --git a/openpype/hosts/fusion/vendor/urllib3/packages/backports/__init__.py b/openpype/hosts/fusion/vendor/urllib3/packages/backports/__init__.py
new file mode 100644
index 0000000000..e69de29bb2
diff --git a/openpype/hosts/fusion/vendor/urllib3/packages/backports/makefile.py b/openpype/hosts/fusion/vendor/urllib3/packages/backports/makefile.py
new file mode 100644
index 0000000000..b8fb2154b6
--- /dev/null
+++ b/openpype/hosts/fusion/vendor/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/hosts/fusion/vendor/urllib3/packages/six.py b/openpype/hosts/fusion/vendor/urllib3/packages/six.py
new file mode 100644
index 0000000000..ba50acb062
--- /dev/null
+++ b/openpype/hosts/fusion/vendor/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/hosts/fusion/vendor/urllib3/packages/ssl_match_hostname/__init__.py b/openpype/hosts/fusion/vendor/urllib3/packages/ssl_match_hostname/__init__.py
new file mode 100644
index 0000000000..ef3fde5206
--- /dev/null
+++ b/openpype/hosts/fusion/vendor/urllib3/packages/ssl_match_hostname/__init__.py
@@ -0,0 +1,24 @@
+import sys
+
+try:
+    # Our match_hostname function is the same as 3.10's, so we only want to
+    # import the match_hostname function if it's at least that good.
+    # We also fallback on Python 3.10+ because our code doesn't emit
+    # deprecation warnings and is the same as Python 3.10 otherwise.
+    if sys.version_info < (3, 5) or sys.version_info >= (3, 10):
+        raise ImportError("Fallback to vendored code")
+
+    from ssl import CertificateError, match_hostname
+except ImportError:
+    try:
+        # Backport of the function from a pypi module
+        from backports.ssl_match_hostname import (  # type: ignore
+            CertificateError,
+            match_hostname,
+        )
+    except ImportError:
+        # Our vendored copy
+        from ._implementation import CertificateError, match_hostname  # type: ignore
+
+# Not needed, but documenting what we provide.
+__all__ = ("CertificateError", "match_hostname")
diff --git a/openpype/hosts/fusion/vendor/urllib3/packages/ssl_match_hostname/_implementation.py b/openpype/hosts/fusion/vendor/urllib3/packages/ssl_match_hostname/_implementation.py
new file mode 100644
index 0000000000..689208d3c6
--- /dev/null
+++ b/openpype/hosts/fusion/vendor/urllib3/packages/ssl_match_hostname/_implementation.py
@@ -0,0 +1,160 @@
+"""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
+# backports.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,):
+        obj = unicode(obj, encoding="ascii", errors="strict")
+    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 ValueError:
+        # Not an IP address (common case)
+        host_ip = None
+    except 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:
+            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/hosts/fusion/vendor/urllib3/poolmanager.py b/openpype/hosts/fusion/vendor/urllib3/poolmanager.py
new file mode 100644
index 0000000000..3a31a285bf
--- /dev/null
+++ b/openpype/hosts/fusion/vendor/urllib3/poolmanager.py
@@ -0,0 +1,536 @@
+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",
+)
+
+# 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/hosts/fusion/vendor/urllib3/request.py b/openpype/hosts/fusion/vendor/urllib3/request.py
new file mode 100644
index 0000000000..398386a5b9
--- /dev/null
+++ b/openpype/hosts/fusion/vendor/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/hosts/fusion/vendor/urllib3/response.py b/openpype/hosts/fusion/vendor/urllib3/response.py
new file mode 100644
index 0000000000..38693f4fc6
--- /dev/null
+++ b/openpype/hosts/fusion/vendor/urllib3/response.py
@@ -0,0 +1,821 @@
+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:
+    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/hosts/fusion/vendor/urllib3/util/__init__.py b/openpype/hosts/fusion/vendor/urllib3/util/__init__.py
new file mode 100644
index 0000000000..4547fc522b
--- /dev/null
+++ b/openpype/hosts/fusion/vendor/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/hosts/fusion/vendor/urllib3/util/connection.py b/openpype/hosts/fusion/vendor/urllib3/util/connection.py
new file mode 100644
index 0000000000..bdc240c50c
--- /dev/null
+++ b/openpype/hosts/fusion/vendor/urllib3/util/connection.py
@@ -0,0 +1,150 @@
+from __future__ import absolute_import
+
+import socket
+
+from urllib3.exceptions import LocationParseError
+
+from ..contrib import _appengine_environ
+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/hosts/fusion/vendor/urllib3/util/proxy.py b/openpype/hosts/fusion/vendor/urllib3/util/proxy.py
new file mode 100644
index 0000000000..34f884d5b3
--- /dev/null
+++ b/openpype/hosts/fusion/vendor/urllib3/util/proxy.py
@@ -0,0 +1,56 @@
+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/hosts/fusion/vendor/urllib3/util/queue.py b/openpype/hosts/fusion/vendor/urllib3/util/queue.py
new file mode 100644
index 0000000000..41784104ee
--- /dev/null
+++ b/openpype/hosts/fusion/vendor/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/hosts/fusion/vendor/urllib3/util/request.py b/openpype/hosts/fusion/vendor/urllib3/util/request.py
new file mode 100644
index 0000000000..25103383ec
--- /dev/null
+++ b/openpype/hosts/fusion/vendor/urllib3/util/request.py
@@ -0,0 +1,143 @@
+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:
+    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/hosts/fusion/vendor/urllib3/util/response.py b/openpype/hosts/fusion/vendor/urllib3/util/response.py
new file mode 100644
index 0000000000..5ea609cced
--- /dev/null
+++ b/openpype/hosts/fusion/vendor/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/hosts/fusion/vendor/urllib3/util/retry.py b/openpype/hosts/fusion/vendor/urllib3/util/retry.py
new file mode 100644
index 0000000000..c7dc42f1d6
--- /dev/null
+++ b/openpype/hosts/fusion/vendor/urllib3/util/retry.py
@@ -0,0 +1,602 @@
+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
+
+
+@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.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.
+    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.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/hosts/fusion/vendor/urllib3/util/ssl_.py b/openpype/hosts/fusion/vendor/urllib3/util/ssl_.py
new file mode 100644
index 0000000000..8f867812a5
--- /dev/null
+++ b/openpype/hosts/fusion/vendor/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/hosts/fusion/vendor/urllib3/util/ssltransport.py b/openpype/hosts/fusion/vendor/urllib3/util/ssltransport.py
new file mode 100644
index 0000000000..c2186bced9
--- /dev/null
+++ b/openpype/hosts/fusion/vendor/urllib3/util/ssltransport.py
@@ -0,0 +1,221 @@
+import io
+import socket
+import ssl
+
+from urllib3.exceptions import ProxySchemeUnsupported
+from urllib3.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/hosts/fusion/vendor/urllib3/util/timeout.py b/openpype/hosts/fusion/vendor/urllib3/util/timeout.py
new file mode 100644
index 0000000000..ff69593b05
--- /dev/null
+++ b/openpype/hosts/fusion/vendor/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/hosts/fusion/vendor/urllib3/util/url.py b/openpype/hosts/fusion/vendor/urllib3/util/url.py
new file mode 100644
index 0000000000..81a03da9e3
--- /dev/null
+++ b/openpype/hosts/fusion/vendor/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/hosts/fusion/vendor/urllib3/util/wait.py b/openpype/hosts/fusion/vendor/urllib3/util/wait.py
new file mode 100644
index 0000000000..c280646c7b
--- /dev/null
+++ b/openpype/hosts/fusion/vendor/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 96638726a90896673457dccc91f5bec5fd069ae9 Mon Sep 17 00:00:00 2001
From: Simone Barbieri <simone.barbieri@hey.com>
Date: Fri, 15 Sep 2023 13:09:32 +0100
Subject: [PATCH 245/366] Produce reviews for the beauty render when publishing

---
 .../hosts/blender/plugins/create/create_render.py     | 11 ++++++-----
 .../hosts/blender/plugins/publish/collect_render.py   |  3 +++
 .../deadline/plugins/publish/submit_publish_job.py    |  1 +
 .../settings/defaults/project_settings/deadline.json  |  3 +++
 .../deadline/server/settings/publish_plugins.py       |  6 ++++++
 5 files changed, 19 insertions(+), 5 deletions(-)

diff --git a/openpype/hosts/blender/plugins/create/create_render.py b/openpype/hosts/blender/plugins/create/create_render.py
index 1c7f883836..abb04061af 100644
--- a/openpype/hosts/blender/plugins/create/create_render.py
+++ b/openpype/hosts/blender/plugins/create/create_render.py
@@ -62,7 +62,7 @@ class CreateRenderlayer(plugin.Creator):
                         ["multilayer_exr"])
 
     @staticmethod
-    def get_render_product(output_path, name):
+    def get_render_product(output_path, name, aov_sep):
         """
         Generate the path to the render product. Blender interprets the `#`
         as the frame number, when it renders.
@@ -74,7 +74,8 @@ class CreateRenderlayer(plugin.Creator):
             instance (pyblish.api.Instance): The instance to publish.
             ext (str): The image format to render.
         """
-        render_product = f"{os.path.join(output_path, name)}.####"
+        filepath = os.path.join(output_path, name)
+        render_product = f"{filepath}{aov_sep}beauty.####"
         render_product = render_product.replace("\\", "/")
 
         return render_product
@@ -233,17 +234,16 @@ class CreateRenderlayer(plugin.Creator):
         ext = self.get_image_format(settings)
         multilayer = self.get_multilayer(settings)
 
+        self.set_render_format(ext, multilayer)
         aov_list, custom_passes = self.set_render_passes(settings)
 
         output_path = os.path.join(file_path, render_folder, file_name)
 
-        render_product = self.get_render_product(output_path, name)
+        render_product = self.get_render_product(output_path, name, aov_sep)
         aov_file_product = self.set_node_tree(
             output_path, name, aov_sep, ext, multilayer)
 
-        # We set the render path, the format and the camera
         bpy.context.scene.render.filepath = render_product
-        self.set_render_format(ext, multilayer)
 
         render_settings = {
             "render_folder": render_folder,
@@ -254,6 +254,7 @@ class CreateRenderlayer(plugin.Creator):
             "custom_passes": custom_passes,
             "render_product": render_product,
             "aov_file_product": aov_file_product,
+            "review": True,
         }
 
         self.imprint_render_settings(asset_group, render_settings)
diff --git a/openpype/hosts/blender/plugins/publish/collect_render.py b/openpype/hosts/blender/plugins/publish/collect_render.py
index 557a4c9066..e0fc933241 100644
--- a/openpype/hosts/blender/plugins/publish/collect_render.py
+++ b/openpype/hosts/blender/plugins/publish/collect_render.py
@@ -82,6 +82,7 @@ class CollectBlenderRender(pyblish.api.InstancePlugin):
         render_product = render_data.get("render_product")
         aov_file_product = render_data.get("aov_file_product")
         ext = render_data.get("image_format")
+        multilayer = render_data.get("multilayer_exr")
 
         frame_start = context.data["frameStart"]
         frame_end = context.data["frameEnd"]
@@ -105,6 +106,8 @@ class CollectBlenderRender(pyblish.api.InstancePlugin):
             "frameEndHandle": frame_handle_end,
             "fps": context.data["fps"],
             "byFrameStep": bpy.context.scene.frame_step,
+            "review": render_data.get("review", False),
+            "multipartExr": ext == "exr" and multilayer,
             "farm": True,
             "expectedFiles": [expected_files],
             # OCIO not currently implemented in Blender, but the following
diff --git a/openpype/modules/deadline/plugins/publish/submit_publish_job.py b/openpype/modules/deadline/plugins/publish/submit_publish_job.py
index 609bfc3d3b..903b6e42e7 100644
--- a/openpype/modules/deadline/plugins/publish/submit_publish_job.py
+++ b/openpype/modules/deadline/plugins/publish/submit_publish_job.py
@@ -107,6 +107,7 @@ class ProcessSubmittedJobOnFarm(pyblish.api.InstancePlugin,
                 "redshift_rop"]
 
     aov_filter = {"maya": [r".*([Bb]eauty).*"],
+                  "blender": [r".*([Bb]eauty).*"],
                   "aftereffects": [r".*"],  # for everything from AE
                   "harmony": [r".*"],  # for everything from AE
                   "celaction": [r".*"],
diff --git a/openpype/settings/defaults/project_settings/deadline.json b/openpype/settings/defaults/project_settings/deadline.json
index 33ea533863..9e88f3b6f2 100644
--- a/openpype/settings/defaults/project_settings/deadline.json
+++ b/openpype/settings/defaults/project_settings/deadline.json
@@ -121,6 +121,9 @@
                 "maya": [
                     ".*([Bb]eauty).*"
                 ],
+                "blender": [
+                    ".*([Bb]eauty).*"
+                ],
                 "aftereffects": [
                     ".*"
                 ],
diff --git a/server_addon/deadline/server/settings/publish_plugins.py b/server_addon/deadline/server/settings/publish_plugins.py
index a29caa7ba1..32a5d0e353 100644
--- a/server_addon/deadline/server/settings/publish_plugins.py
+++ b/server_addon/deadline/server/settings/publish_plugins.py
@@ -421,6 +421,12 @@ DEFAULT_DEADLINE_PLUGINS_SETTINGS = {
                     ".*([Bb]eauty).*"
                 ]
             },
+            {
+                "name": "blender",
+                "value": [
+                    ".*([Bb]eauty).*"
+                ]
+            },
             {
                 "name": "aftereffects",
                 "value": [

From 3c2c33bcea84ada5c9292e12fc53c51e74a73e5a Mon Sep 17 00:00:00 2001
From: Simone Barbieri <simone.barbieri@hey.com>
Date: Fri, 15 Sep 2023 17:06:29 +0100
Subject: [PATCH 246/366] Reorganized code and added validator to check the
 output folder

---
 openpype/hosts/blender/api/__init__.py        |   3 +
 openpype/hosts/blender/api/render_lib.py      | 240 +++++++++++++++++
 .../blender/plugins/create/create_render.py   | 248 +-----------------
 .../publish/validate_deadline_publish.py      |  47 ++++
 4 files changed, 293 insertions(+), 245 deletions(-)
 create mode 100644 openpype/hosts/blender/api/render_lib.py
 create mode 100644 openpype/hosts/blender/plugins/publish/validate_deadline_publish.py

diff --git a/openpype/hosts/blender/api/__init__.py b/openpype/hosts/blender/api/__init__.py
index 75a11affde..e15f1193a5 100644
--- a/openpype/hosts/blender/api/__init__.py
+++ b/openpype/hosts/blender/api/__init__.py
@@ -38,6 +38,8 @@ from .lib import (
 
 from .capture import capture
 
+from .render_lib import prepare_rendering
+
 
 __all__ = [
     "install",
@@ -66,4 +68,5 @@ __all__ = [
     "get_selection",
     "capture",
     # "unique_name",
+    "prepare_rendering",
 ]
diff --git a/openpype/hosts/blender/api/render_lib.py b/openpype/hosts/blender/api/render_lib.py
new file mode 100644
index 0000000000..994de43503
--- /dev/null
+++ b/openpype/hosts/blender/api/render_lib.py
@@ -0,0 +1,240 @@
+import os
+
+import bpy
+
+from openpype.settings import get_project_settings
+from openpype.pipeline import get_current_project_name
+
+
+def get_default_render_folder(settings):
+    """Get default render folder from blender settings."""
+
+    return (settings["blender"]
+                    ["RenderSettings"]
+                    ["default_render_image_folder"])
+
+def get_aov_separator(settings):
+    """Get aov separator from blender settings."""
+
+    aov_sep = (settings["blender"]
+                        ["RenderSettings"]
+                        ["aov_separator"])
+
+    if aov_sep == "dash":
+        return "-"
+    elif aov_sep == "underscore":
+        return "_"
+    elif aov_sep == "dot":
+        return "."
+    else:
+        raise ValueError(f"Invalid aov separator: {aov_sep}")
+
+def get_image_format(settings):
+    """Get image format from blender settings."""
+
+    return (settings["blender"]
+                    ["RenderSettings"]
+                    ["image_format"])
+
+def get_multilayer(settings):
+    """Get multilayer from blender settings."""
+
+    return (settings["blender"]
+                    ["RenderSettings"]
+                    ["multilayer_exr"])
+
+def get_render_product(output_path, name, aov_sep):
+    """
+    Generate the path to the render product. Blender interprets the `#`
+    as the frame number, when it renders.
+
+    Args:
+        file_path (str): The path to the blender scene.
+        render_folder (str): The render folder set in settings.
+        file_name (str): The name of the blender scene.
+        instance (pyblish.api.Instance): The instance to publish.
+        ext (str): The image format to render.
+    """
+    filepath = os.path.join(output_path, name)
+    render_product = f"{filepath}{aov_sep}beauty.####"
+    render_product = render_product.replace("\\", "/")
+
+    return render_product
+
+def set_render_format(ext, multilayer):
+    # Set Blender to save the file with the right extension
+    bpy.context.scene.render.use_file_extension = True
+
+    image_settings = bpy.context.scene.render.image_settings
+
+    if ext == "exr":
+        image_settings.file_format = (
+            "OPEN_EXR_MULTILAYER" if multilayer else "OPEN_EXR")
+    elif ext == "bmp":
+        image_settings.file_format = "BMP"
+    elif ext == "rgb":
+        image_settings.file_format = "IRIS"
+    elif ext == "png":
+        image_settings.file_format = "PNG"
+    elif ext == "jpeg":
+        image_settings.file_format = "JPEG"
+    elif ext == "jp2":
+        image_settings.file_format = "JPEG2000"
+    elif ext == "tga":
+        image_settings.file_format = "TARGA"
+    elif ext == "tif":
+        image_settings.file_format = "TIFF"
+
+def set_render_passes(settings):
+    aov_list = (settings["blender"]
+                        ["RenderSettings"]
+                        ["aov_list"])
+
+    custom_passes = (settings["blender"]
+                                ["RenderSettings"]
+                                ["custom_passes"])
+
+    vl = bpy.context.view_layer
+
+    vl.use_pass_combined = "combined" in aov_list
+    vl.use_pass_z = "z" in aov_list
+    vl.use_pass_mist = "mist" in aov_list
+    vl.use_pass_normal = "normal" in aov_list
+    vl.use_pass_diffuse_direct = "diffuse_light" in aov_list
+    vl.use_pass_diffuse_color = "diffuse_color" in aov_list
+    vl.use_pass_glossy_direct = "specular_light" in aov_list
+    vl.use_pass_glossy_color = "specular_color" in aov_list
+    vl.eevee.use_pass_volume_direct = "volume_light" in aov_list
+    vl.use_pass_emit = "emission" in aov_list
+    vl.use_pass_environment = "environment" in aov_list
+    vl.use_pass_shadow = "shadow" in aov_list
+    vl.use_pass_ambient_occlusion = "ao" in aov_list
+
+    aovs_names = [aov.name for aov in vl.aovs]
+    for cp in custom_passes:
+        cp_name = cp[0]
+        if cp_name not in aovs_names:
+            aov = vl.aovs.add()
+            aov.name = cp_name
+        else:
+            aov = vl.aovs[cp_name]
+        aov.type = cp[1].get("type", "VALUE")
+
+    return aov_list, custom_passes
+
+def set_node_tree(output_path, name, aov_sep, ext, multilayer):
+    # Set the scene to use the compositor node tree to render
+    bpy.context.scene.use_nodes = True
+
+    tree = bpy.context.scene.node_tree
+
+    # Get the Render Layers node
+    rl_node = None
+    for node in tree.nodes:
+        if node.bl_idname == "CompositorNodeRLayers":
+            rl_node = node
+            break
+
+    # If there's not a Render Layers node, we create it
+    if not rl_node:
+        rl_node = tree.nodes.new("CompositorNodeRLayers")
+
+    # Get the enabled output sockets, that are the active passes for the
+    # render.
+    # We also exclude some layers.
+    exclude_sockets = ["Image", "Alpha"]
+    passes = [
+        socket
+        for socket in rl_node.outputs
+        if socket.enabled and socket.name not in exclude_sockets
+    ]
+
+    # Remove all output nodes
+    for node in tree.nodes:
+        if node.bl_idname == "CompositorNodeOutputFile":
+            tree.nodes.remove(node)
+
+    # Create a new output node
+    output = tree.nodes.new("CompositorNodeOutputFile")
+
+    image_settings = bpy.context.scene.render.image_settings
+    output.format.file_format = image_settings.file_format
+
+    # In case of a multilayer exr, we don't need to use the output node,
+    # because the blender render already outputs a multilayer exr.
+    if ext == "exr" and multilayer:
+        output.layer_slots.clear()
+        return []
+
+    output.file_slots.clear()
+    output.base_path = output_path
+
+    aov_file_products = []
+
+    # For each active render pass, we add a new socket to the output node
+    # and link it
+    for render_pass in passes:
+        filepath = f"{name}{aov_sep}{render_pass.name}.####"
+
+        output.file_slots.new(filepath)
+
+        aov_file_products.append(
+            (render_pass.name, os.path.join(output_path, filepath)))
+
+        node_input = output.inputs[-1]
+
+        tree.links.new(render_pass, node_input)
+
+    return aov_file_products
+
+def imprint_render_settings(node, data):
+    RENDER_DATA = "render_data"
+    if not node.get(RENDER_DATA):
+        node[RENDER_DATA] = {}
+    for key, value in data.items():
+        if value is None:
+            continue
+        node[RENDER_DATA][key] = value
+
+def prepare_rendering(asset_group):
+    name = asset_group.name
+
+    filepath = bpy.data.filepath
+    assert filepath, "Workfile not saved. Please save the file first."
+
+    file_path = os.path.dirname(filepath)
+    file_name = os.path.basename(filepath)
+    file_name, _ = os.path.splitext(file_name)
+
+    project = get_current_project_name()
+    settings = get_project_settings(project)
+
+    render_folder = get_default_render_folder(settings)
+    aov_sep = get_aov_separator(settings)
+    ext = get_image_format(settings)
+    multilayer = get_multilayer(settings)
+
+    set_render_format(ext, multilayer)
+    aov_list, custom_passes = set_render_passes(settings)
+
+    output_path = os.path.join(file_path, render_folder, file_name)
+
+    render_product = get_render_product(output_path, name, aov_sep)
+    aov_file_product = set_node_tree(
+        output_path, name, aov_sep, ext, multilayer)
+
+    bpy.context.scene.render.filepath = render_product
+
+    render_settings = {
+        "render_folder": render_folder,
+        "aov_separator": aov_sep,
+        "image_format": ext,
+        "multilayer_exr": multilayer,
+        "aov_list": aov_list,
+        "custom_passes": custom_passes,
+        "render_product": render_product,
+        "aov_file_product": aov_file_product,
+        "review": True,
+    }
+
+    imprint_render_settings(asset_group, render_settings)
diff --git a/openpype/hosts/blender/plugins/create/create_render.py b/openpype/hosts/blender/plugins/create/create_render.py
index abb04061af..7a91726a5f 100644
--- a/openpype/hosts/blender/plugins/create/create_render.py
+++ b/openpype/hosts/blender/plugins/create/create_render.py
@@ -3,12 +3,9 @@ import os
 
 import bpy
 
-from openpype.settings import get_project_settings
-from openpype.pipeline import (
-    get_current_project_name,
-    get_current_task_name,
-)
+from openpype.pipeline import get_current_task_name
 from openpype.hosts.blender.api import plugin, lib
+from openpype.hosts.blender.api.render_lib import prepare_rendering
 from openpype.hosts.blender.api.pipeline import AVALON_INSTANCES
 
 
@@ -20,245 +17,6 @@ class CreateRenderlayer(plugin.Creator):
     family = "renderlayer"
     icon = "eye"
 
-    @staticmethod
-    def get_default_render_folder(settings):
-        """Get default render folder from blender settings."""
-
-        return (settings["blender"]
-                        ["RenderSettings"]
-                        ["default_render_image_folder"])
-
-    @staticmethod
-    def get_aov_separator(settings):
-        """Get aov separator from blender settings."""
-
-        aov_sep = (settings["blender"]
-                           ["RenderSettings"]
-                           ["aov_separator"])
-
-        if aov_sep == "dash":
-            return "-"
-        elif aov_sep == "underscore":
-            return "_"
-        elif aov_sep == "dot":
-            return "."
-        else:
-            raise ValueError(f"Invalid aov separator: {aov_sep}")
-
-    @staticmethod
-    def get_image_format(settings):
-        """Get image format from blender settings."""
-
-        return (settings["blender"]
-                        ["RenderSettings"]
-                        ["image_format"])
-
-    @staticmethod
-    def get_multilayer(settings):
-        """Get multilayer from blender settings."""
-
-        return (settings["blender"]
-                        ["RenderSettings"]
-                        ["multilayer_exr"])
-
-    @staticmethod
-    def get_render_product(output_path, name, aov_sep):
-        """
-        Generate the path to the render product. Blender interprets the `#`
-        as the frame number, when it renders.
-
-        Args:
-            file_path (str): The path to the blender scene.
-            render_folder (str): The render folder set in settings.
-            file_name (str): The name of the blender scene.
-            instance (pyblish.api.Instance): The instance to publish.
-            ext (str): The image format to render.
-        """
-        filepath = os.path.join(output_path, name)
-        render_product = f"{filepath}{aov_sep}beauty.####"
-        render_product = render_product.replace("\\", "/")
-
-        return render_product
-
-    @staticmethod
-    def set_render_format(ext, multilayer):
-        # Set Blender to save the file with the right extension
-        bpy.context.scene.render.use_file_extension = True
-
-        image_settings = bpy.context.scene.render.image_settings
-
-        if ext == "exr":
-            image_settings.file_format = (
-                "OPEN_EXR_MULTILAYER" if multilayer else "OPEN_EXR")
-        elif ext == "bmp":
-            image_settings.file_format = "BMP"
-        elif ext == "rgb":
-            image_settings.file_format = "IRIS"
-        elif ext == "png":
-            image_settings.file_format = "PNG"
-        elif ext == "jpeg":
-            image_settings.file_format = "JPEG"
-        elif ext == "jp2":
-            image_settings.file_format = "JPEG2000"
-        elif ext == "tga":
-            image_settings.file_format = "TARGA"
-        elif ext == "tif":
-            image_settings.file_format = "TIFF"
-
-    @staticmethod
-    def set_render_passes(settings):
-        aov_list = (settings["blender"]
-                            ["RenderSettings"]
-                            ["aov_list"])
-
-        custom_passes = (settings["blender"]
-                                 ["RenderSettings"]
-                                 ["custom_passes"])
-
-        vl = bpy.context.view_layer
-
-        vl.use_pass_combined = "combined" in aov_list
-        vl.use_pass_z = "z" in aov_list
-        vl.use_pass_mist = "mist" in aov_list
-        vl.use_pass_normal = "normal" in aov_list
-        vl.use_pass_diffuse_direct = "diffuse_light" in aov_list
-        vl.use_pass_diffuse_color = "diffuse_color" in aov_list
-        vl.use_pass_glossy_direct = "specular_light" in aov_list
-        vl.use_pass_glossy_color = "specular_color" in aov_list
-        vl.eevee.use_pass_volume_direct = "volume_light" in aov_list
-        vl.use_pass_emit = "emission" in aov_list
-        vl.use_pass_environment = "environment" in aov_list
-        vl.use_pass_shadow = "shadow" in aov_list
-        vl.use_pass_ambient_occlusion = "ao" in aov_list
-
-        aovs_names = [aov.name for aov in vl.aovs]
-        for cp in custom_passes:
-            cp_name = cp[0]
-            if cp_name not in aovs_names:
-                aov = vl.aovs.add()
-                aov.name = cp_name
-            else:
-                aov = vl.aovs[cp_name]
-            aov.type = cp[1].get("type", "VALUE")
-
-        return aov_list, custom_passes
-
-    def set_node_tree(self, output_path, name, aov_sep, ext, multilayer):
-        # Set the scene to use the compositor node tree to render
-        bpy.context.scene.use_nodes = True
-
-        tree = bpy.context.scene.node_tree
-
-        # Get the Render Layers node
-        rl_node = None
-        for node in tree.nodes:
-            if node.bl_idname == "CompositorNodeRLayers":
-                rl_node = node
-                break
-
-        # If there's not a Render Layers node, we create it
-        if not rl_node:
-            rl_node = tree.nodes.new("CompositorNodeRLayers")
-
-        # Get the enabled output sockets, that are the active passes for the
-        # render.
-        # We also exclude some layers.
-        exclude_sockets = ["Image", "Alpha"]
-        passes = [
-            socket
-            for socket in rl_node.outputs
-            if socket.enabled and socket.name not in exclude_sockets
-        ]
-
-        # Remove all output nodes
-        for node in tree.nodes:
-            if node.bl_idname == "CompositorNodeOutputFile":
-                tree.nodes.remove(node)
-
-        # Create a new output node
-        output = tree.nodes.new("CompositorNodeOutputFile")
-
-        image_settings = bpy.context.scene.render.image_settings
-        output.format.file_format = image_settings.file_format
-
-        # In case of a multilayer exr, we don't need to use the output node,
-        # because the blender render already outputs a multilayer exr.
-        if ext == "exr" and multilayer:
-            output.layer_slots.clear()
-            return []
-
-        output.file_slots.clear()
-        output.base_path = output_path
-
-        aov_file_products = []
-
-        # For each active render pass, we add a new socket to the output node
-        # and link it
-        for render_pass in passes:
-            filepath = f"{name}{aov_sep}{render_pass.name}.####"
-
-            output.file_slots.new(filepath)
-
-            aov_file_products.append(
-                (render_pass.name, os.path.join(output_path, filepath)))
-
-            node_input = output.inputs[-1]
-
-            tree.links.new(render_pass, node_input)
-
-        return aov_file_products
-
-    @staticmethod
-    def imprint_render_settings(node, data):
-        RENDER_DATA = "render_data"
-        if not node.get(RENDER_DATA):
-            node[RENDER_DATA] = {}
-        for key, value in data.items():
-            if value is None:
-                continue
-            node[RENDER_DATA][key] = value
-
-    def prepare_rendering(self, asset_group, name):
-        filepath = bpy.data.filepath
-        assert filepath, "Workfile not saved. Please save the file first."
-
-        file_path = os.path.dirname(filepath)
-        file_name = os.path.basename(filepath)
-        file_name, _ = os.path.splitext(file_name)
-
-        project = get_current_project_name()
-        settings = get_project_settings(project)
-
-        render_folder = self.get_default_render_folder(settings)
-        aov_sep = self.get_aov_separator(settings)
-        ext = self.get_image_format(settings)
-        multilayer = self.get_multilayer(settings)
-
-        self.set_render_format(ext, multilayer)
-        aov_list, custom_passes = self.set_render_passes(settings)
-
-        output_path = os.path.join(file_path, render_folder, file_name)
-
-        render_product = self.get_render_product(output_path, name, aov_sep)
-        aov_file_product = self.set_node_tree(
-            output_path, name, aov_sep, ext, multilayer)
-
-        bpy.context.scene.render.filepath = render_product
-
-        render_settings = {
-            "render_folder": render_folder,
-            "aov_separator": aov_sep,
-            "image_format": ext,
-            "multilayer_exr": multilayer,
-            "aov_list": aov_list,
-            "custom_passes": custom_passes,
-            "render_product": render_product,
-            "aov_file_product": aov_file_product,
-            "review": True,
-        }
-
-        self.imprint_render_settings(asset_group, render_settings)
-
     def process(self):
         # Get Instance Container or create it if it does not exist
         instances = bpy.data.collections.get(AVALON_INSTANCES)
@@ -277,7 +35,7 @@ class CreateRenderlayer(plugin.Creator):
             self.data['task'] = get_current_task_name()
             lib.imprint(asset_group, self.data)
 
-            self.prepare_rendering(asset_group, name)
+            prepare_rendering(asset_group)
         except Exception:
             # Remove the instance if there was an error
             bpy.data.collections.remove(asset_group)
diff --git a/openpype/hosts/blender/plugins/publish/validate_deadline_publish.py b/openpype/hosts/blender/plugins/publish/validate_deadline_publish.py
new file mode 100644
index 0000000000..54a4442bdb
--- /dev/null
+++ b/openpype/hosts/blender/plugins/publish/validate_deadline_publish.py
@@ -0,0 +1,47 @@
+import os
+
+import bpy
+
+import pyblish.api
+from openpype.pipeline.publish import (
+    RepairAction,
+    ValidateContentsOrder,
+    PublishValidationError,
+    OptionalPyblishPluginMixin
+)
+from openpype.hosts.blender.api.render_lib import prepare_rendering
+
+
+class ValidateDeadlinePublish(pyblish.api.InstancePlugin,
+                              OptionalPyblishPluginMixin):
+    """Validates Render File Directory is
+    not the same in every submission
+    """
+
+    order = ValidateContentsOrder
+    families = ["renderlayer"]
+    hosts = ["blender"]
+    label = "Validate Render Output for Deadline"
+    optional = True
+    actions = [RepairAction]
+
+    def process(self, instance):
+        if not self.is_active(instance.data):
+            return
+        filepath = bpy.data.filepath
+        file = os.path.basename(filepath)
+        filename, ext = os.path.splitext(file)
+        if filename not in bpy.context.scene.render.filepath:
+            raise PublishValidationError(
+                "Render output folder "
+                "doesn't match the max scene name! "
+                "Use Repair action to "
+                "fix the folder file path.."
+            )
+
+    @classmethod
+    def repair(cls, instance):
+        container = bpy.data.collections[str(instance)]
+        prepare_rendering(container)
+        bpy.ops.wm.save_as_mainfile(filepath=bpy.data.filepath)
+        cls.log.debug("Reset the render output folder...")

From c315ee8f65db1a6a973d6480070c5c098c33327f Mon Sep 17 00:00:00 2001
From: Simone Barbieri <simone.barbieri@hey.com>
Date: Fri, 15 Sep 2023 17:20:26 +0100
Subject: [PATCH 247/366] Hound fixes

---
 openpype/hosts/blender/api/render_lib.py | 17 +++++++++++++----
 1 file changed, 13 insertions(+), 4 deletions(-)

diff --git a/openpype/hosts/blender/api/render_lib.py b/openpype/hosts/blender/api/render_lib.py
index 994de43503..43560ee6d5 100644
--- a/openpype/hosts/blender/api/render_lib.py
+++ b/openpype/hosts/blender/api/render_lib.py
@@ -13,12 +13,13 @@ def get_default_render_folder(settings):
                     ["RenderSettings"]
                     ["default_render_image_folder"])
 
+
 def get_aov_separator(settings):
     """Get aov separator from blender settings."""
 
     aov_sep = (settings["blender"]
-                        ["RenderSettings"]
-                        ["aov_separator"])
+                       ["RenderSettings"]
+                       ["aov_separator"])
 
     if aov_sep == "dash":
         return "-"
@@ -29,6 +30,7 @@ def get_aov_separator(settings):
     else:
         raise ValueError(f"Invalid aov separator: {aov_sep}")
 
+
 def get_image_format(settings):
     """Get image format from blender settings."""
 
@@ -36,6 +38,7 @@ def get_image_format(settings):
                     ["RenderSettings"]
                     ["image_format"])
 
+
 def get_multilayer(settings):
     """Get multilayer from blender settings."""
 
@@ -43,6 +46,7 @@ def get_multilayer(settings):
                     ["RenderSettings"]
                     ["multilayer_exr"])
 
+
 def get_render_product(output_path, name, aov_sep):
     """
     Generate the path to the render product. Blender interprets the `#`
@@ -61,6 +65,7 @@ def get_render_product(output_path, name, aov_sep):
 
     return render_product
 
+
 def set_render_format(ext, multilayer):
     # Set Blender to save the file with the right extension
     bpy.context.scene.render.use_file_extension = True
@@ -85,14 +90,15 @@ def set_render_format(ext, multilayer):
     elif ext == "tif":
         image_settings.file_format = "TIFF"
 
+
 def set_render_passes(settings):
     aov_list = (settings["blender"]
                         ["RenderSettings"]
                         ["aov_list"])
 
     custom_passes = (settings["blender"]
-                                ["RenderSettings"]
-                                ["custom_passes"])
+                             ["RenderSettings"]
+                             ["custom_passes"])
 
     vl = bpy.context.view_layer
 
@@ -122,6 +128,7 @@ def set_render_passes(settings):
 
     return aov_list, custom_passes
 
+
 def set_node_tree(output_path, name, aov_sep, ext, multilayer):
     # Set the scene to use the compositor node tree to render
     bpy.context.scene.use_nodes = True
@@ -187,6 +194,7 @@ def set_node_tree(output_path, name, aov_sep, ext, multilayer):
 
     return aov_file_products
 
+
 def imprint_render_settings(node, data):
     RENDER_DATA = "render_data"
     if not node.get(RENDER_DATA):
@@ -196,6 +204,7 @@ def imprint_render_settings(node, data):
             continue
         node[RENDER_DATA][key] = value
 
+
 def prepare_rendering(asset_group):
     name = asset_group.name
 

From 11921a9de995794cbc950ce183b5d3e837d78d17 Mon Sep 17 00:00:00 2001
From: Simone Barbieri <simone.barbieri@hey.com>
Date: Fri, 15 Sep 2023 17:20:43 +0100
Subject: [PATCH 248/366] Added settings for new validator

---
 .../defaults/project_settings/blender.json    |  5 ++
 .../schemas/schema_blender_publish.json       | 84 +++++++++++++------
 .../server/settings/publish_plugins.py        | 10 +++
 3 files changed, 75 insertions(+), 24 deletions(-)

diff --git a/openpype/settings/defaults/project_settings/blender.json b/openpype/settings/defaults/project_settings/blender.json
index 9cbbb49593..f3eb31174f 100644
--- a/openpype/settings/defaults/project_settings/blender.json
+++ b/openpype/settings/defaults/project_settings/blender.json
@@ -46,6 +46,11 @@
             "optional": false,
             "active": true
         },
+        "ValidateDeadlinePublish": {
+            "enabled": true,
+            "optional": false,
+            "active": true
+        },
         "ValidateMeshHasUvs": {
             "enabled": true,
             "optional": true,
diff --git a/openpype/settings/entities/schemas/projects_schema/schemas/schema_blender_publish.json b/openpype/settings/entities/schemas/projects_schema/schemas/schema_blender_publish.json
index 05e7f13e70..7f1a8a915b 100644
--- a/openpype/settings/entities/schemas/projects_schema/schemas/schema_blender_publish.json
+++ b/openpype/settings/entities/schemas/projects_schema/schemas/schema_blender_publish.json
@@ -51,30 +51,6 @@
                 }
             ]
         },
-        {
-            "type": "dict",
-            "collapsible": true,
-            "key": "ValidateRenderCameraIsSet",
-            "label": "Validate Render Camera Is Set",
-            "checkbox_key": "enabled",
-            "children": [
-                {
-                    "type": "boolean",
-                    "key": "enabled",
-                    "label": "Enabled"
-                },
-                {
-                    "type": "boolean",
-                    "key": "optional",
-                    "label": "Optional"
-                },
-                {
-                    "type": "boolean",
-                    "key": "active",
-                    "label": "Active"
-                }
-            ]
-        },
         {
             "type": "collapsible-wrap",
             "label": "Model",
@@ -103,6 +79,66 @@
                 }
             ]
         },
+        {
+            "type": "collapsible-wrap",
+            "label": "Render",
+            "children": [
+                {
+                    "type": "schema_template",
+                    "name": "template_publish_plugin",
+                    "template_data": [
+                        {
+                            "type": "dict",
+                            "collapsible": true,
+                            "key": "ValidateRenderCameraIsSet",
+                            "label": "Validate Render Camera Is Set",
+                            "checkbox_key": "enabled",
+                            "children": [
+                                {
+                                    "type": "boolean",
+                                    "key": "enabled",
+                                    "label": "Enabled"
+                                },
+                                {
+                                    "type": "boolean",
+                                    "key": "optional",
+                                    "label": "Optional"
+                                },
+                                {
+                                    "type": "boolean",
+                                    "key": "active",
+                                    "label": "Active"
+                                }
+                            ]
+                        },
+                        {
+                            "type": "dict",
+                            "collapsible": true,
+                            "key": "ValidateDeadlinePublish",
+                            "label": "Validate Render Output for Deadline",
+                            "checkbox_key": "enabled",
+                            "children": [
+                                {
+                                    "type": "boolean",
+                                    "key": "enabled",
+                                    "label": "Enabled"
+                                },
+                                {
+                                    "type": "boolean",
+                                    "key": "optional",
+                                    "label": "Optional"
+                                },
+                                {
+                                    "type": "boolean",
+                                    "key": "active",
+                                    "label": "Active"
+                                }
+                            ]
+                        }
+                    ]
+                }
+            ]
+        },
         {
             "type": "splitter"
         },
diff --git a/server_addon/blender/server/settings/publish_plugins.py b/server_addon/blender/server/settings/publish_plugins.py
index 575bfe9f39..5e047b7013 100644
--- a/server_addon/blender/server/settings/publish_plugins.py
+++ b/server_addon/blender/server/settings/publish_plugins.py
@@ -73,6 +73,11 @@ class PublishPuginsModel(BaseSettingsModel):
         title="Validate Render Camera Is Set",
         section="Validators"
     )
+    ValidateDeadlinePublish: ValidatePluginModel = Field(
+        default_factory=ValidatePluginModel,
+        title="Validate Render Output for Deadline",
+        section="Validators"
+    )
     ValidateMeshHasUvs: ValidatePluginModel = Field(
         default_factory=ValidatePluginModel,
         title="Validate Mesh Has Uvs"
@@ -149,6 +154,11 @@ DEFAULT_BLENDER_PUBLISH_SETTINGS = {
         "optional": False,
         "active": True
     },
+    "ValidateDeadlinePublish": {
+        "enabled": True,
+        "optional": False,
+        "active": True
+    },
     "ValidateMeshHasUvs": {
         "enabled": True,
         "optional": True,

From 2acbf241ad12b32affa6772e87728c31e0b3135c Mon Sep 17 00:00:00 2001
From: Simone Barbieri <simone.barbieri@hey.com>
Date: Fri, 15 Sep 2023 18:05:23 +0100
Subject: [PATCH 249/366] Changed family to "render"

---
 openpype/hosts/blender/plugins/create/create_render.py        | 4 +---
 openpype/hosts/blender/plugins/publish/collect_render.py      | 3 ++-
 .../blender/plugins/publish/increment_workfile_version.py     | 2 +-
 .../blender/plugins/publish/validate_deadline_publish.py      | 2 +-
 .../blender/plugins/publish/validate_render_camera_is_set.py  | 2 +-
 .../deadline/plugins/publish/submit_blender_deadline.py       | 2 +-
 6 files changed, 7 insertions(+), 8 deletions(-)

diff --git a/openpype/hosts/blender/plugins/create/create_render.py b/openpype/hosts/blender/plugins/create/create_render.py
index 7a91726a5f..f938a21808 100644
--- a/openpype/hosts/blender/plugins/create/create_render.py
+++ b/openpype/hosts/blender/plugins/create/create_render.py
@@ -1,6 +1,4 @@
 """Create render."""
-import os
-
 import bpy
 
 from openpype.pipeline import get_current_task_name
@@ -14,7 +12,7 @@ class CreateRenderlayer(plugin.Creator):
 
     name = "renderingMain"
     label = "Render"
-    family = "renderlayer"
+    family = "render"
     icon = "eye"
 
     def process(self):
diff --git a/openpype/hosts/blender/plugins/publish/collect_render.py b/openpype/hosts/blender/plugins/publish/collect_render.py
index e0fc933241..92e2473a95 100644
--- a/openpype/hosts/blender/plugins/publish/collect_render.py
+++ b/openpype/hosts/blender/plugins/publish/collect_render.py
@@ -15,7 +15,7 @@ class CollectBlenderRender(pyblish.api.InstancePlugin):
 
     order = pyblish.api.CollectorOrder + 0.01
     hosts = ["blender"]
-    families = ["renderlayer"]
+    families = ["render"]
     label = "Collect Render Layers"
     sync_workfile_version = False
 
@@ -100,6 +100,7 @@ class CollectBlenderRender(pyblish.api.InstancePlugin):
         expected_files = expected_beauty | expected_aovs
 
         instance.data.update({
+            "family": "render.farm",
             "frameStart": frame_start,
             "frameEnd": frame_end,
             "frameStartHandle": frame_handle_start,
diff --git a/openpype/hosts/blender/plugins/publish/increment_workfile_version.py b/openpype/hosts/blender/plugins/publish/increment_workfile_version.py
index 5f49ad7185..3d176f9c30 100644
--- a/openpype/hosts/blender/plugins/publish/increment_workfile_version.py
+++ b/openpype/hosts/blender/plugins/publish/increment_workfile_version.py
@@ -10,7 +10,7 @@ class IncrementWorkfileVersion(pyblish.api.ContextPlugin):
     optional = True
     hosts = ["blender"]
     families = ["animation", "model", "rig", "action", "layout", "blendScene",
-                "renderlayer"]
+                "render"]
 
     def process(self, context):
 
diff --git a/openpype/hosts/blender/plugins/publish/validate_deadline_publish.py b/openpype/hosts/blender/plugins/publish/validate_deadline_publish.py
index 54a4442bdb..f89a7d3d58 100644
--- a/openpype/hosts/blender/plugins/publish/validate_deadline_publish.py
+++ b/openpype/hosts/blender/plugins/publish/validate_deadline_publish.py
@@ -19,7 +19,7 @@ class ValidateDeadlinePublish(pyblish.api.InstancePlugin,
     """
 
     order = ValidateContentsOrder
-    families = ["renderlayer"]
+    families = ["render.farm"]
     hosts = ["blender"]
     label = "Validate Render Output for Deadline"
     optional = True
diff --git a/openpype/hosts/blender/plugins/publish/validate_render_camera_is_set.py b/openpype/hosts/blender/plugins/publish/validate_render_camera_is_set.py
index 5a06c1ff0a..ba3a796f35 100644
--- a/openpype/hosts/blender/plugins/publish/validate_render_camera_is_set.py
+++ b/openpype/hosts/blender/plugins/publish/validate_render_camera_is_set.py
@@ -8,7 +8,7 @@ class ValidateRenderCameraIsSet(pyblish.api.InstancePlugin):
 
     order = pyblish.api.ValidatorOrder
     hosts = ["blender"]
-    families = ["renderlayer"]
+    families = ["render"]
     label = "Validate Render Camera Is Set"
     optional = False
 
diff --git a/openpype/modules/deadline/plugins/publish/submit_blender_deadline.py b/openpype/modules/deadline/plugins/publish/submit_blender_deadline.py
index ad456c0d13..307fc8b5a2 100644
--- a/openpype/modules/deadline/plugins/publish/submit_blender_deadline.py
+++ b/openpype/modules/deadline/plugins/publish/submit_blender_deadline.py
@@ -27,7 +27,7 @@ class BlenderPluginInfo():
 class BlenderSubmitDeadline(abstract_submit_deadline.AbstractSubmitDeadline):
     label = "Submit Render to Deadline"
     hosts = ["blender"]
-    families = ["renderlayer"]
+    families = ["render.farm"]
 
     use_published = True
     priority = 50

From 851f234237d69dd8ccdea76304a2f1ab7d7a564a Mon Sep 17 00:00:00 2001
From: Ynbot <bot@ynput.io>
Date: Sat, 16 Sep 2023 03:24:27 +0000
Subject: [PATCH 250/366] [Automated] Bump version

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

diff --git a/openpype/version.py b/openpype/version.py
index c4a87e7843..bbed1b0ef3 100644
--- a/openpype/version.py
+++ b/openpype/version.py
@@ -1,3 +1,3 @@
 # -*- coding: utf-8 -*-
 """Package declaring Pype version."""
-__version__ = "3.16.7-nightly.1"
+__version__ = "3.16.7-nightly.2"

From 10ed783907dbd3df9c511c71cf144b75ccd810f3 Mon Sep 17 00:00:00 2001
From: "github-actions[bot]" <github-actions[bot]@users.noreply.github.com>
Date: Sat, 16 Sep 2023 03:25:05 +0000
Subject: [PATCH 251/366] chore(): update bug report / version

---
 .github/ISSUE_TEMPLATE/bug_report.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/ISSUE_TEMPLATE/bug_report.yml b/.github/ISSUE_TEMPLATE/bug_report.yml
index 35564c2bf0..cf3cb8ba1a 100644
--- a/.github/ISSUE_TEMPLATE/bug_report.yml
+++ b/.github/ISSUE_TEMPLATE/bug_report.yml
@@ -35,6 +35,7 @@ body:
       label: Version
       description: What version are you running? Look to OpenPype Tray
       options:
+        - 3.16.7-nightly.2
         - 3.16.7-nightly.1
         - 3.16.6
         - 3.16.6-nightly.1
@@ -134,7 +135,6 @@ body:
         - 3.14.10-nightly.1
         - 3.14.9
         - 3.14.9-nightly.5
-        - 3.14.9-nightly.4
     validations:
       required: true
   - type: dropdown

From d38cf8258954523f7025015670bfe6b7130c6d08 Mon Sep 17 00:00:00 2001
From: Toke Stuart Jepsen <tokejepsen@gmail.com>
Date: Mon, 18 Sep 2023 08:49:51 +0100
Subject: [PATCH 252/366] Fix file path fetching from context.

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

diff --git a/openpype/hosts/maya/plugins/load/load_audio.py b/openpype/hosts/maya/plugins/load/load_audio.py
index 2da5a6f1c2..2ea0b134d1 100644
--- a/openpype/hosts/maya/plugins/load/load_audio.py
+++ b/openpype/hosts/maya/plugins/load/load_audio.py
@@ -27,7 +27,7 @@ class AudioLoader(load.LoaderPlugin):
 
         start_frame = cmds.playbackOptions(query=True, min=True)
         sound_node = cmds.sound(
-            file=context["representation"]["data"]["path"], offset=start_frame
+            file=self.filepath_from_context(context), offset=start_frame
         )
         cmds.timeControl(
             mel.eval("$gPlayBackSlider=$gPlayBackSlider"),

From 7c1d81d62c267ad04c36f33c94ecb1aec3f569aa Mon Sep 17 00:00:00 2001
From: Toke Stuart Jepsen <tokejepsen@gmail.com>
Date: Mon, 18 Sep 2023 08:50:11 +0100
Subject: [PATCH 253/366] Improve loader label.

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

diff --git a/openpype/hosts/maya/plugins/load/load_audio.py b/openpype/hosts/maya/plugins/load/load_audio.py
index 2ea0b134d1..ecf98303d2 100644
--- a/openpype/hosts/maya/plugins/load/load_audio.py
+++ b/openpype/hosts/maya/plugins/load/load_audio.py
@@ -18,7 +18,7 @@ class AudioLoader(load.LoaderPlugin):
     """Specific loader of audio."""
 
     families = ["audio"]
-    label = "Import audio"
+    label = "Load audio"
     representations = ["wav"]
     icon = "volume-up"
     color = "orange"

From 73e928efc99dbcd90b84d09cd1de0397ed3f633b Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Mon, 18 Sep 2023 10:12:58 +0200
Subject: [PATCH 254/366] Fix - _id key used instead of id (#5626)

Just 'id' is not returned because value in fields.
---
 openpype/client/server/entities.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/client/server/entities.py b/openpype/client/server/entities.py
index 39322627bb..3ee62a3172 100644
--- a/openpype/client/server/entities.py
+++ b/openpype/client/server/entities.py
@@ -422,7 +422,7 @@ def get_last_version_by_subset_name(
     if not subset:
         return None
     return get_last_version_by_subset_id(
-        project_name, subset["id"], fields=fields
+        project_name, subset["_id"], fields=fields
     )
 
 

From ccf4b7f54781d81d9d6d331f63e3a5a8ab0e0d6f Mon Sep 17 00:00:00 2001
From: Simone Barbieri <simone.barbieri@hey.com>
Date: Mon, 18 Sep 2023 10:52:38 +0100
Subject: [PATCH 255/366] Fix error description

Co-authored-by: Roy Nieterau <roy_nieterau@hotmail.com>
---
 .../hosts/blender/plugins/publish/validate_deadline_publish.py  | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/hosts/blender/plugins/publish/validate_deadline_publish.py b/openpype/hosts/blender/plugins/publish/validate_deadline_publish.py
index f89a7d3d58..14220b5c9c 100644
--- a/openpype/hosts/blender/plugins/publish/validate_deadline_publish.py
+++ b/openpype/hosts/blender/plugins/publish/validate_deadline_publish.py
@@ -34,7 +34,7 @@ class ValidateDeadlinePublish(pyblish.api.InstancePlugin,
         if filename not in bpy.context.scene.render.filepath:
             raise PublishValidationError(
                 "Render output folder "
-                "doesn't match the max scene name! "
+                "doesn't match the blender scene name! "
                 "Use Repair action to "
                 "fix the folder file path.."
             )

From 4737ca8d5962b3d27d93f6799f58884e2c0a47ae Mon Sep 17 00:00:00 2001
From: Simone Barbieri <simone.barbieri@hey.com>
Date: Mon, 18 Sep 2023 11:08:21 +0100
Subject: [PATCH 256/366] Added note on the Multilayer EXR setting

---
 .../schemas/projects_schema/schema_project_blender.json       | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/openpype/settings/entities/schemas/projects_schema/schema_project_blender.json b/openpype/settings/entities/schemas/projects_schema/schema_project_blender.json
index a283a2ff5c..4c9405fcd3 100644
--- a/openpype/settings/entities/schemas/projects_schema/schema_project_blender.json
+++ b/openpype/settings/entities/schemas/projects_schema/schema_project_blender.json
@@ -99,6 +99,10 @@
                     "type": "boolean",
                     "label": "Multilayer (EXR)"
                 },
+                {
+                    "type": "label",
+                    "label": "Note: Multilayer EXR is only used when output format type set to EXR."
+                },
                 {
                     "key": "aov_list",
                     "label": "AOVs to create",

From 36a8976c580d822c816992c752181b48a884202d Mon Sep 17 00:00:00 2001
From: Jakub Trllo <43494761+iLLiCiTiT@users.noreply.github.com>
Date: Mon, 18 Sep 2023 14:55:07 +0200
Subject: [PATCH 257/366] AYON: Mark deprecated settings in Maya (#5627)

* Mark color management preferences as deprecated

* add migration hint
---
 server_addon/maya/server/settings/imageio.py | 11 ++++++-----
 1 file changed, 6 insertions(+), 5 deletions(-)

diff --git a/server_addon/maya/server/settings/imageio.py b/server_addon/maya/server/settings/imageio.py
index 7512bfe253..946a14c866 100644
--- a/server_addon/maya/server/settings/imageio.py
+++ b/server_addon/maya/server/settings/imageio.py
@@ -39,8 +39,10 @@ class ImageIOFileRulesModel(BaseSettingsModel):
 
 
 class ColorManagementPreferenceV2Model(BaseSettingsModel):
-    """Color Management Preference v2 (Maya 2022+)."""
-    _layout = "expanded"
+    """Color Management Preference v2 (Maya 2022+).
+
+    Please migrate all to 'imageio/workfile' and enable it.
+    """
 
     enabled: bool = Field(True, title="Use Color Management Preference v2")
 
@@ -51,7 +53,6 @@ class ColorManagementPreferenceV2Model(BaseSettingsModel):
 
 class ColorManagementPreferenceModel(BaseSettingsModel):
     """Color Management Preference (legacy)."""
-    _layout = "expanded"
 
     renderSpace: str = Field(title="Rendering Space")
     viewTransform: str = Field(title="Viewer Transform ")
@@ -89,11 +90,11 @@ class ImageIOSettings(BaseSettingsModel):
     # Deprecated
     colorManagementPreference_v2: ColorManagementPreferenceV2Model = Field(
         default_factory=ColorManagementPreferenceV2Model,
-        title="Color Management Preference v2 (Maya 2022+)"
+        title="DEPRECATED: Color Management Preference v2 (Maya 2022+)"
     )
     colorManagementPreference: ColorManagementPreferenceModel = Field(
         default_factory=ColorManagementPreferenceModel,
-        title="Color Management Preference (legacy)"
+        title="DEPRECATED: Color Management Preference (legacy)"
     )
 
 

From 411f4bacd16d3d3c5c4ffb29d69f88f383b094dc Mon Sep 17 00:00:00 2001
From: Toke Stuart Jepsen <tokejepsen@gmail.com>
Date: Mon, 18 Sep 2023 15:03:45 +0100
Subject: [PATCH 258/366] Support new publisher for colorsets validation.

---
 .../maya/plugins/publish/validate_color_sets.py   | 15 +++++++++------
 1 file changed, 9 insertions(+), 6 deletions(-)

diff --git a/openpype/hosts/maya/plugins/publish/validate_color_sets.py b/openpype/hosts/maya/plugins/publish/validate_color_sets.py
index 766124cd9e..173fee4179 100644
--- a/openpype/hosts/maya/plugins/publish/validate_color_sets.py
+++ b/openpype/hosts/maya/plugins/publish/validate_color_sets.py
@@ -3,9 +3,10 @@ from maya import cmds
 import pyblish.api
 import openpype.hosts.maya.api.action
 from openpype.pipeline.publish import (
-    RepairAction,
     ValidateMeshOrder,
-    OptionalPyblishPluginMixin
+    OptionalPyblishPluginMixin,
+    PublishValidationError,
+    RepairAction
 )
 
 
@@ -22,8 +23,9 @@ class ValidateColorSets(pyblish.api.Validator,
     hosts = ['maya']
     families = ['model']
     label = 'Mesh ColorSets'
-    actions = [openpype.hosts.maya.api.action.SelectInvalidAction,
-               RepairAction]
+    actions = [
+        openpype.hosts.maya.api.action.SelectInvalidAction, RepairAction
+    ]
     optional = True
 
     @staticmethod
@@ -48,8 +50,9 @@ class ValidateColorSets(pyblish.api.Validator,
         invalid = self.get_invalid(instance)
 
         if invalid:
-            raise ValueError("Meshes found with "
-                             "Color Sets: {0}".format(invalid))
+            raise PublishValidationError(
+                message="Meshes found with Color Sets: {0}".format(invalid)
+            )
 
     @classmethod
     def repair(cls, instance):

From 9f040265e7cd965df20137d9da12396fa8338310 Mon Sep 17 00:00:00 2001
From: Toke Stuart Jepsen <tokejepsen@gmail.com>
Date: Mon, 18 Sep 2023 16:07:54 +0100
Subject: [PATCH 259/366] Remove context prompt.

---
 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 60495ac652..3647ec0b6b 100644
--- a/openpype/hosts/maya/api/pipeline.py
+++ b/openpype/hosts/maya/api/pipeline.py
@@ -659,17 +659,6 @@ def on_task_changed():
         lib.set_context_settings()
         lib.update_content_on_context_change()
 
-    msg = "  project: {}\n  asset: {}\n  task:{}".format(
-        get_current_project_name(),
-        get_current_asset_name(),
-        get_current_task_name()
-    )
-
-    lib.show_message(
-        "Context was changed",
-        ("Context was changed to:\n{}".format(msg)),
-    )
-
 
 def before_workfile_open():
     if handle_workfile_locks():

From 6c70df2a2e482cc1ad21d9f62b05a30e4282865a Mon Sep 17 00:00:00 2001
From: Mustafa-Zarkash <mustafataherzaky@outlook.com>
Date: Mon, 18 Sep 2023 21:02:58 +0300
Subject: [PATCH 260/366] remove unnecessary logic

---
 .../hosts/houdini/plugins/load/load_fbx.py    | 23 +++++--------------
 1 file changed, 6 insertions(+), 17 deletions(-)

diff --git a/openpype/hosts/houdini/plugins/load/load_fbx.py b/openpype/hosts/houdini/plugins/load/load_fbx.py
index 7e7f0c04e5..cac22d62d4 100644
--- a/openpype/hosts/houdini/plugins/load/load_fbx.py
+++ b/openpype/hosts/houdini/plugins/load/load_fbx.py
@@ -21,8 +21,9 @@ class FbxLoader(load.LoaderPlugin):
 
     def load(self, context, name=None, namespace=None, data=None):
 
-        # get file path
-        file_path = self.get_file_path(context=context)
+        # get file path from context
+        file_path = self.filepath_from_context(context)
+        file_path = file_path.replace("\\", "/")
 
         # get necessary data
         namespace, node_name = self.get_node_name(context, name, namespace)
@@ -56,8 +57,9 @@ class FbxLoader(load.LoaderPlugin):
             self.log.error("Could not find node of type `file`")
             return
 
-        # Update the file path
-        file_path = self.get_file_path(representation=representation)
+        # Update the file path from representation
+        file_path = get_representation_path(representation)
+        file_path = file_path.replace("\\", "/")
 
         file_node.setParms({"file": file_path})
 
@@ -72,19 +74,6 @@ class FbxLoader(load.LoaderPlugin):
     def switch(self, container, representation):
         self.update(container, representation)
 
-    def get_file_path(self, context=None, representation=None):
-        """Return formatted file path."""
-
-        # Format file name, Houdini only wants forward slashes
-        if context:
-            file_path = self.filepath_from_context(context)
-        elif representation:
-            file_path = get_representation_path(representation)
-        else:
-            return ""
-
-        return file_path.replace("\\", "/")
-
     def get_node_name(self, context, name=None, namespace=None):
         """Define node name."""
 

From c03326f5d8d0c45427d5cb24187c390d2b8c5113 Mon Sep 17 00:00:00 2001
From: Kayla Man <moonyuet2008@hotmail.com>
Date: Tue, 19 Sep 2023 19:19:40 +0800
Subject: [PATCH 261/366] Jakub's comment on the review plugin

---
 openpype/hosts/nuke/api/plugin.py             |   5 +
 .../publish/extract_review_data_mov.py        |   2 +-
 openpype/settings/ayon_settings.py            |  21 ++-
 .../defaults/project_settings/nuke.json       |  54 +++++++
 .../schemas/schema_nuke_publish.json          | 145 ++++++++++++++++++
 .../nuke/server/settings/publish_plugins.py   |  10 +-
 .../settings_project_global.md                |  12 +-
 website/docs/pype2/admin_presets_plugins.md   |   3 +-
 8 files changed, 236 insertions(+), 16 deletions(-)

diff --git a/openpype/hosts/nuke/api/plugin.py b/openpype/hosts/nuke/api/plugin.py
index a0e1525cd0..adbe43e481 100644
--- a/openpype/hosts/nuke/api/plugin.py
+++ b/openpype/hosts/nuke/api/plugin.py
@@ -21,6 +21,9 @@ from openpype.pipeline import (
     CreatedInstance,
     get_current_task_name
 )
+from openpype.lib.transcoding import (
+    VIDEO_EXTENSIONS
+)
 from .lib import (
     INSTANCE_DATA_KNOB,
     Knobby,
@@ -801,6 +804,8 @@ class ExporterReviewMov(ExporterReview):
         self.log.info("File info was set...")
 
         self.file = self.fhead + self.name + ".{}".format(self.ext)
+        if self.ext != VIDEO_EXTENSIONS:
+            self.file = os.path.basename(self.path_in)
         self.path = os.path.join(
             self.staging_dir, self.file).replace("\\", "/")
 
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 956d1a54a3..1568a2de9b 100644
--- a/openpype/hosts/nuke/plugins/publish/extract_review_data_mov.py
+++ b/openpype/hosts/nuke/plugins/publish/extract_review_data_mov.py
@@ -8,7 +8,7 @@ from openpype.hosts.nuke.api import plugin
 from openpype.hosts.nuke.api.lib import maintained_selection
 
 
-class ExtractReviewDataMov(publish.Extractor):
+class ExtractReviewDataBakingStreams(publish.Extractor):
     """Extracts movie and thumbnail with baked in luts
 
     must be run after extract_render_local.py
diff --git a/openpype/settings/ayon_settings.py b/openpype/settings/ayon_settings.py
index 9a4f0607e0..b7fcaa1216 100644
--- a/openpype/settings/ayon_settings.py
+++ b/openpype/settings/ayon_settings.py
@@ -748,7 +748,19 @@ def _convert_nuke_project_settings(ayon_settings, output):
     )
 
     new_review_data_outputs = {}
-    for item in ayon_publish["ExtractReviewDataMov"]["outputs"]:
+    outputs_settings = None
+    # just in case that the users having old presets in outputs setting
+    deprecrated_review_settings = ayon_publish["ExtractReviewDataMov"]
+    current_review_settings = (
+        ayon_publish["ExtractReviewDataBakingStreams"]
+    )
+    if deprecrated_review_settings["outputs"] == (
+        current_review_settings["outputs"]):
+        outputs_settings = current_review_settings["outputs"]
+    else:
+        outputs_settings = deprecrated_review_settings["outputs"]
+
+    for item in outputs_settings:
         item_filter = item["filter"]
         if "product_names" in item_filter:
             item_filter["subsets"] = item_filter.pop("product_names")
@@ -767,7 +779,12 @@ def _convert_nuke_project_settings(ayon_settings, output):
 
         name = item.pop("name")
         new_review_data_outputs[name] = item
-    ayon_publish["ExtractReviewDataMov"]["outputs"] = new_review_data_outputs
+
+    if deprecrated_review_settings["outputs"] == (
+        current_review_settings["outputs"]):
+        current_review_settings["outputs"] = new_review_data_outputs
+    else:
+        deprecrated_review_settings["outputs"] = new_review_data_outputs
 
     collect_instance_data = ayon_publish["CollectInstanceData"]
     if "sync_workfile_version_on_product_types" in collect_instance_data:
diff --git a/openpype/settings/defaults/project_settings/nuke.json b/openpype/settings/defaults/project_settings/nuke.json
index 7961e77113..fac78dbcd5 100644
--- a/openpype/settings/defaults/project_settings/nuke.json
+++ b/openpype/settings/defaults/project_settings/nuke.json
@@ -501,6 +501,60 @@
                 }
             }
         },
+        "ExtractReviewDataBakingStreams": {
+            "enabled": true,
+            "viewer_lut_raw": false,
+            "outputs": {
+                "baking": {
+                    "filter": {
+                        "task_types": [],
+                        "families": [],
+                        "subsets": []
+                    },
+                    "read_raw": false,
+                    "viewer_process_override": "",
+                    "bake_viewer_process": true,
+                    "bake_viewer_input_process": true,
+                    "reformat_nodes_config": {
+                        "enabled": false,
+                        "reposition_nodes": [
+                            {
+                                "node_class": "Reformat",
+                                "knobs": [
+                                    {
+                                        "type": "text",
+                                        "name": "type",
+                                        "value": "to format"
+                                    },
+                                    {
+                                        "type": "text",
+                                        "name": "format",
+                                        "value": "HD_1080"
+                                    },
+                                    {
+                                        "type": "text",
+                                        "name": "filter",
+                                        "value": "Lanczos6"
+                                    },
+                                    {
+                                        "type": "bool",
+                                        "name": "black_outside",
+                                        "value": true
+                                    },
+                                    {
+                                        "type": "bool",
+                                        "name": "pbb",
+                                        "value": false
+                                    }
+                                ]
+                            }
+                        ]
+                    },
+                    "extension": "mov",
+                    "add_custom_tags": []
+                }
+            }
+        },
         "ExtractSlateFrame": {
             "viewer_lut_raw": false,
             "key_value_mapping": {
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 f006392bef..0f366d55ba 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
@@ -371,6 +371,151 @@
 
             ]
         },
+        {
+            "type": "label",
+            "label": "^ Settings and for <span style=\"color:#FF0000\";><b>ExtractReviewDataMov</b></span> is deprecated and will be soon removed.  <br> Please use <b>ExtractReviewDataBakingStreams</b> instead."
+        },
+        {
+            "type": "dict",
+            "collapsible": true,
+            "checkbox_key": "enabled",
+            "key": "ExtractReviewDataBakingStreams",
+            "label": "ExtractReviewDataBakingStreams",
+            "is_group": true,
+            "children": [
+                {
+                    "type": "boolean",
+                    "key": "enabled",
+                    "label": "Enabled"
+                },
+                {
+                    "type": "boolean",
+                    "key": "viewer_lut_raw",
+                    "label": "Viewer LUT raw"
+                },
+                {
+                    "key": "outputs",
+                    "label": "Output Definitions",
+                    "type": "dict-modifiable",
+                    "highlight_content": true,
+                    "object_type": {
+                        "type": "dict",
+                        "children": [
+                            {
+                                "type": "dict",
+                                "collapsible": false,
+                                "key": "filter",
+                                "label": "Filtering",
+                                "children": [
+                                    {
+                                        "key": "task_types",
+                                        "label": "Task types",
+                                        "type": "task-types-enum"
+                                    },
+                                    {
+                                        "key": "families",
+                                        "label": "Families",
+                                        "type": "list",
+                                        "object_type": "text"
+                                    },
+                                    {
+                                        "key": "subsets",
+                                        "label": "Subsets",
+                                        "type": "list",
+                                        "object_type": "text"
+                                    }
+                                ]
+                            },
+                            {
+                                "type": "separator"
+                            },
+                            {
+                                "type": "boolean",
+                                "key": "read_raw",
+                                "label": "Read colorspace RAW",
+                                "default": false
+                            },
+                            {
+                                "type": "text",
+                                "key": "viewer_process_override",
+                                "label": "Viewer Process colorspace profile override"
+                            },
+                            {
+                                "type": "boolean",
+                                "key": "bake_viewer_process",
+                                "label": "Bake Viewer Process"
+                            },
+                            {
+                                "type": "boolean",
+                                "key": "bake_viewer_input_process",
+                                "label": "Bake Viewer Input Process (LUTs)"
+                            },
+                            {
+                                "type": "separator"
+                            },
+                            {
+                                "key": "reformat_nodes_config",
+                                "type": "dict",
+                                "label": "Reformat Nodes",
+                                "collapsible": true,
+                                "checkbox_key": "enabled",
+                                "children": [
+                                    {
+                                        "type": "boolean",
+                                        "key": "enabled",
+                                        "label": "Enabled"
+                                    },
+                                    {
+                                        "type": "label",
+                                        "label": "Reposition knobs supported only.<br/>You can add multiple reformat nodes <br/>and set their knobs. Order of reformat <br/>nodes is important. First reformat node <br/>will be applied first and last reformat <br/>node will be applied last."
+                                    },
+                                    {
+                                        "key": "reposition_nodes",
+                                        "type": "list",
+                                        "label": "Reposition nodes",
+                                        "object_type": {
+                                            "type": "dict",
+                                            "children": [
+                                                {
+                                                    "key": "node_class",
+                                                    "label": "Node class",
+                                                    "type": "text"
+                                                },
+                                                {
+                                                    "type": "schema_template",
+                                                    "name": "template_nuke_knob_inputs",
+                                                    "template_data": [
+                                                        {
+                                                            "label": "Node knobs",
+                                                            "key": "knobs"
+                                                        }
+                                                    ]
+                                                }
+                                            ]
+                                        }
+                                    }
+                                ]
+                            },
+                            {
+                                "type": "separator"
+                            },
+                            {
+                                "type": "text",
+                                "key": "extension",
+                                "label": "Write node file type"
+                            },
+                            {
+                                "key": "add_custom_tags",
+                                "label": "Add custom tags",
+                                "type": "list",
+                                "object_type": "text"
+                            }
+                        ]
+                    }
+                }
+
+            ]
+        },
         {
             "type": "dict",
             "collapsible": true,
diff --git a/server_addon/nuke/server/settings/publish_plugins.py b/server_addon/nuke/server/settings/publish_plugins.py
index c78685534f..423448219d 100644
--- a/server_addon/nuke/server/settings/publish_plugins.py
+++ b/server_addon/nuke/server/settings/publish_plugins.py
@@ -165,7 +165,7 @@ class BakingStreamModel(BaseSettingsModel):
         title="Custom tags", default_factory=list)
 
 
-class ExtractReviewDataMovModel(BaseSettingsModel):
+class ExtractReviewBakingStreamsModel(BaseSettingsModel):
     enabled: bool = Field(title="Enabled")
     viewer_lut_raw: bool = Field(title="Viewer lut raw")
     outputs: list[BakingStreamModel] = Field(
@@ -266,9 +266,9 @@ class PublishPuginsModel(BaseSettingsModel):
         title="Extract Review Data Lut",
         default_factory=ExtractReviewDataLutModel
     )
-    ExtractReviewDataMov: ExtractReviewDataMovModel = Field(
-        title="Extract Review Data Mov",
-        default_factory=ExtractReviewDataMovModel
+    ExtractReviewDataBakingStreams: ExtractReviewBakingStreamsModel = Field(
+        title="Extract Review Data Baking Streams",
+        default_factory=ExtractReviewBakingStreamsModel
     )
     ExtractSlateFrame: ExtractSlateFrameModel = Field(
         title="Extract Slate Frame",
@@ -410,7 +410,7 @@ DEFAULT_PUBLISH_PLUGIN_SETTINGS = {
     "ExtractReviewDataLut": {
         "enabled": False
     },
-    "ExtractReviewDataMov": {
+    "ExtractReviewDataBakingStreams": {
         "enabled": True,
         "viewer_lut_raw": False,
         "outputs": [
diff --git a/website/docs/project_settings/settings_project_global.md b/website/docs/project_settings/settings_project_global.md
index 5ddf247d98..9092ccdcdf 100644
--- a/website/docs/project_settings/settings_project_global.md
+++ b/website/docs/project_settings/settings_project_global.md
@@ -189,10 +189,10 @@ A profile may generate multiple outputs from a single input. Each output must de
     - Profile filtering defines which group of output definitions is used but output definitions may require more specific filters on their own.
     - They may filter by subset name (regex can be used) or publish families. Publish families are more complex as are based on knowing code base.
     - Filtering by custom tags -> this is used for targeting to output definitions from other extractors using settings (at this moment only Nuke bake extractor can target using custom tags).
-        - Nuke extractor settings path: `project_settings/nuke/publish/ExtractReviewDataMov/outputs/baking/add_custom_tags`
+        - Nuke extractor settings path: `project_settings/nuke/publish/ExtractReviewDataBakingStreams/outputs/baking/add_custom_tags`
     - Filtering by input length. Input may be video, sequence or single image. It is possible that `.mp4` should be created only when input is video or sequence and to create review `.png` when input is single frame. In some cases the output should be created even if it's single frame or multi frame input.
 
-    
+
 ### Extract Burnin
 
 Plugin is responsible for adding burnins into review representations.
@@ -226,13 +226,13 @@ A burnin profile may set multiple burnin outputs from one input. The burnin's na
 | **Bottom Centered** | Bottom center content. | str | "{username}" |
 | **Bottom Right** | Bottom right corner content. | str | "{frame_start}-{current_frame}-{frame_end}" |
 
-Each burnin profile can be configured with additional family filtering and can 
-add additional tags to the burnin representation, these can be configured under 
+Each burnin profile can be configured with additional family filtering and can
+add additional tags to the burnin representation, these can be configured under
 the profile's **Additional filtering** section.
 
 :::note Filename suffix
-The filename suffix is appended to filename of the source representation. For 
-example, if the source representation has suffix **"h264"** and the burnin 
+The filename suffix is appended to filename of the source representation. For
+example, if the source representation has suffix **"h264"** and the burnin
 suffix is **"client"** then the final suffix is **"h264_client"**.
 :::
 
diff --git a/website/docs/pype2/admin_presets_plugins.md b/website/docs/pype2/admin_presets_plugins.md
index 6a057f4bb4..a869ead819 100644
--- a/website/docs/pype2/admin_presets_plugins.md
+++ b/website/docs/pype2/admin_presets_plugins.md
@@ -534,8 +534,7 @@ Plugin responsible for generating thumbnails with colorspace controlled by Nuke.
 }
 ```
 
-### `ExtractReviewDataMov`
-
+### `ExtractReviewDataBakingStreams`
 `viewer_lut_raw` **true** will publish the baked mov file without any colorspace conversion. It will be baked with the workfile workspace. This can happen in case the Viewer input process uses baked screen space luts.
 
 #### baking with controlled colorspace

From e0fba9713d37c4cf73210c2c37179f9403b2399a Mon Sep 17 00:00:00 2001
From: Kayla Man <moonyuet2008@hotmail.com>
Date: Tue, 19 Sep 2023 19:22:52 +0800
Subject: [PATCH 262/366] hound

---
 openpype/settings/ayon_settings.py | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/openpype/settings/ayon_settings.py b/openpype/settings/ayon_settings.py
index b7fcaa1216..0b72d267f7 100644
--- a/openpype/settings/ayon_settings.py
+++ b/openpype/settings/ayon_settings.py
@@ -755,7 +755,8 @@ def _convert_nuke_project_settings(ayon_settings, output):
         ayon_publish["ExtractReviewDataBakingStreams"]
     )
     if deprecrated_review_settings["outputs"] == (
-        current_review_settings["outputs"]):
+        current_review_settings["outputs"]
+    ):
         outputs_settings = current_review_settings["outputs"]
     else:
         outputs_settings = deprecrated_review_settings["outputs"]
@@ -781,7 +782,8 @@ def _convert_nuke_project_settings(ayon_settings, output):
         new_review_data_outputs[name] = item
 
     if deprecrated_review_settings["outputs"] == (
-        current_review_settings["outputs"]):
+        current_review_settings["outputs"]
+    ):
         current_review_settings["outputs"] = new_review_data_outputs
     else:
         deprecrated_review_settings["outputs"] = new_review_data_outputs

From b8997c5ae49841ed3dfc82c30d394909a3b88722 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ond=C5=99ej=20Samohel?=
 <33513211+antirotor@users.noreply.github.com>
Date: Tue, 19 Sep 2023 14:23:45 +0200
Subject: [PATCH 263/366] create symlinks for ssl libs (#5633)

build was missing `libssl.1.1.so` and `libcrypto.1.1.so` symlinks needed by the executable itself, because python is now explicitly build with OpenSSL 1.1.1
---
 Dockerfile.centos7 | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/Dockerfile.centos7 b/Dockerfile.centos7
index 9217140f20..ab1d3f8253 100644
--- a/Dockerfile.centos7
+++ b/Dockerfile.centos7
@@ -109,6 +109,8 @@ RUN source $HOME/.bashrc \
 RUN cp /usr/lib64/libffi* ./build/exe.linux-x86_64-3.9/lib \
     && cp /usr/lib64/openssl11/libssl* ./build/exe.linux-x86_64-3.9/lib \
     && cp /usr/lib64/openssl11/libcrypto* ./build/exe.linux-x86_64-3.9/lib \
+    && ln -sr ./build/exe.linux-x86_64-3.9/lib/libssl.so ./build/exe.linux-x86_64-3.9/lib/libssl.1.1.so \
+    && ln -sr ./build/exe.linux-x86_64-3.9/lib/libcrypto.so ./build/exe.linux-x86_64-3.9/lib/libcrypto.1.1.so \
     && cp /root/.pyenv/versions/${OPENPYPE_PYTHON_VERSION}/lib/libpython* ./build/exe.linux-x86_64-3.9/lib \
     && cp /usr/lib64/libxcb* ./build/exe.linux-x86_64-3.9/vendor/python/PySide2/Qt/lib
 

From 5b2e9da304697aea73af8cac3616d895e4bdd0d0 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Tue, 19 Sep 2023 14:52:19 +0200
Subject: [PATCH 264/366] (nuke): fix set colorspace on writes

---
 openpype/hosts/nuke/api/lib.py | 48 +++++++++++++++++++++++++++-------
 1 file changed, 38 insertions(+), 10 deletions(-)

diff --git a/openpype/hosts/nuke/api/lib.py b/openpype/hosts/nuke/api/lib.py
index 41e6a27cef..8626151beb 100644
--- a/openpype/hosts/nuke/api/lib.py
+++ b/openpype/hosts/nuke/api/lib.py
@@ -2320,23 +2320,51 @@ Reopening Nuke should synchronize these paths and resolve any discrepancies.
 
             # get data from avalon knob
             avalon_knob_data = read_avalon_data(node)
+            node_data = get_node_data(node, INSTANCE_DATA_KNOB)
 
             if avalon_knob_data.get("id") != "pyblish.avalon.instance":
+
+            if (
+                # backward compatibility
+                # TODO: remove this once old avalon data api will be removed
+                avalon_knob_data
+                and avalon_knob_data.get("id") != "pyblish.avalon.instance"
+            ):
+                continue
+            elif (
+                node_data
+                and node_data.get("id") != "pyblish.avalon.instance"
+            ):
                 continue
 
-            if "creator" not in avalon_knob_data:
+            if (
+                # backward compatibility
+                # TODO: remove this once old avalon data api will be removed
+                avalon_knob_data
+                and "creator" not in avalon_knob_data
+            ):
+                continue
+            elif (
+                node_data
+                and "creator_identifier" not in node_data
+            ):
                 continue
 
-            # establish families
-            families = [avalon_knob_data["family"]]
-            if avalon_knob_data.get("families"):
-                families.append(avalon_knob_data.get("families"))
 
-            nuke_imageio_writes = get_imageio_node_setting(
-                node_class=avalon_knob_data["families"],
-                plugin_name=avalon_knob_data["creator"],
-                subset=avalon_knob_data["subset"]
-            )
+            nuke_imageio_writes = None
+            if avalon_knob_data:
+                # establish families
+                families = [avalon_knob_data["family"]]
+                if avalon_knob_data.get("families"):
+                    families.append(avalon_knob_data.get("families"))
+
+                nuke_imageio_writes = get_imageio_node_setting(
+                    node_class=avalon_knob_data["families"],
+                    plugin_name=avalon_knob_data["creator"],
+                    subset=avalon_knob_data["subset"]
+                )
+            elif node_data:
+                nuke_imageio_writes = get_write_node_template_attr(node)
 
             log.debug("nuke_imageio_writes: `{}`".format(nuke_imageio_writes))
 

From 961013e9afd5074b768ee73fe0a10464bdb62cd0 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Tue, 19 Sep 2023 15:03:18 +0200
Subject: [PATCH 265/366] Nuke: adding print of name of node which is processed

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

diff --git a/openpype/hosts/nuke/api/lib.py b/openpype/hosts/nuke/api/lib.py
index 8626151beb..fb2b5d0f45 100644
--- a/openpype/hosts/nuke/api/lib.py
+++ b/openpype/hosts/nuke/api/lib.py
@@ -2316,14 +2316,13 @@ Reopening Nuke should synchronize these paths and resolve any discrepancies.
         ''' Adds correct colorspace to write node dict
 
         '''
-        for node in nuke.allNodes(filter="Group"):
+        for node in nuke.allNodes(filter="Group", group=self._root_node):
+            log.info("Setting colorspace to `{}`".format(node.name()))
 
             # get data from avalon knob
             avalon_knob_data = read_avalon_data(node)
             node_data = get_node_data(node, INSTANCE_DATA_KNOB)
 
-            if avalon_knob_data.get("id") != "pyblish.avalon.instance":
-
             if (
                 # backward compatibility
                 # TODO: remove this once old avalon data api will be removed
@@ -2350,7 +2349,6 @@ Reopening Nuke should synchronize these paths and resolve any discrepancies.
             ):
                 continue
 
-
             nuke_imageio_writes = None
             if avalon_knob_data:
                 # establish families

From 3d7479b65ec4a5b862633536791ac0773d5cdd67 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Tue, 19 Sep 2023 15:43:26 +0200
Subject: [PATCH 266/366] nuke: extract review data mov read node with
 expression

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

diff --git a/openpype/hosts/nuke/api/plugin.py b/openpype/hosts/nuke/api/plugin.py
index a0e1525cd0..1e318e17cf 100644
--- a/openpype/hosts/nuke/api/plugin.py
+++ b/openpype/hosts/nuke/api/plugin.py
@@ -869,6 +869,11 @@ class ExporterReviewMov(ExporterReview):
         r_node["origlast"].setValue(self.last_frame)
         r_node["colorspace"].setValue(self.write_colorspace)
 
+        # do not rely on defaults, set explicitly
+        # to be sure it is set correctly
+        r_node["frame_mode"].setValue("expression")
+        r_node["frame"].setValue("")
+
         if read_raw:
             r_node["raw"].setValue(1)
 

From a8fa44c3fda18d0799fc171cb6461ba80672a36d Mon Sep 17 00:00:00 2001
From: Jakub Trllo <43494761+iLLiCiTiT@users.noreply.github.com>
Date: Tue, 19 Sep 2023 16:52:51 +0200
Subject: [PATCH 267/366] AYON: Ignore separated modules (#5619)

* ayon mode explicitly ignores addons that have own repository

* change warning message of missing addon directory to debug

* Better log message
---
 openpype/modules/base.py | 20 ++++++++++++++++----
 1 file changed, 16 insertions(+), 4 deletions(-)

diff --git a/openpype/modules/base.py b/openpype/modules/base.py
index 84e213288c..a3c21718b9 100644
--- a/openpype/modules/base.py
+++ b/openpype/modules/base.py
@@ -59,6 +59,14 @@ IGNORED_DEFAULT_FILENAMES = (
     "example_addons",
     "default_modules",
 )
+# Modules that won't be loaded in AYON mode from "./openpype/modules"
+# - the same modules are ignored in "./server_addon/create_ayon_addons.py"
+IGNORED_FILENAMES_IN_AYON = {
+    "ftrack",
+    "shotgrid",
+    "sync_server",
+    "slack",
+}
 
 
 # Inherit from `object` for Python 2 hosts
@@ -392,9 +400,9 @@ def _load_ayon_addons(openpype_modules, modules_key, log):
         folder_name = "{}_{}".format(addon_name, addon_version)
         addon_dir = os.path.join(addons_dir, folder_name)
         if not os.path.exists(addon_dir):
-            log.warning((
-                "Directory for addon {} {} does not exists. Path \"{}\""
-            ).format(addon_name, addon_version, addon_dir))
+            log.debug((
+                "No localized client code found for addon {} {}."
+            ).format(addon_name, addon_version))
             continue
 
         sys.path.insert(0, addon_dir)
@@ -483,6 +491,10 @@ def _load_modules():
 
         is_in_current_dir = dirpath == current_dir
         is_in_host_dir = dirpath == hosts_dir
+        ignored_current_dir_filenames = set(IGNORED_DEFAULT_FILENAMES)
+        if AYON_SERVER_ENABLED:
+            ignored_current_dir_filenames |= IGNORED_FILENAMES_IN_AYON
+
         for filename in os.listdir(dirpath):
             # Ignore filenames
             if filename in IGNORED_FILENAMES:
@@ -490,7 +502,7 @@ def _load_modules():
 
             if (
                 is_in_current_dir
-                and filename in IGNORED_DEFAULT_FILENAMES
+                and filename in ignored_current_dir_filenames
             ):
                 continue
 

From bed1e35d20dfc949a8b8c3864bbb526644fa37df Mon Sep 17 00:00:00 2001
From: 64qam <dvorak.peta@gmail.com>
Date: Tue, 19 Sep 2023 16:54:48 +0200
Subject: [PATCH 268/366] Default create a desktop icon is checked (#5636)

---
 inno_setup.iss | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/inno_setup.iss b/inno_setup.iss
index 418bedbd4d..d9a41d22ee 100644
--- a/inno_setup.iss
+++ b/inno_setup.iss
@@ -36,7 +36,7 @@ WizardStyle=modern
 Name: "english"; MessagesFile: "compiler:Default.isl"
 
 [Tasks]
-Name: "desktopicon"; Description: "{cm:CreateDesktopIcon}"; GroupDescription: "{cm:AdditionalIcons}"; Flags: unchecked
+Name: "desktopicon"; Description: "{cm:CreateDesktopIcon}"; GroupDescription: "{cm:AdditionalIcons}"
 
 [InstallDelete]
 ; clean everything in previous installation folder
@@ -53,4 +53,3 @@ Name: "{autodesktop}\{#MyAppName} {#AppVer}"; Filename: "{app}\openpype_gui.exe"
 
 [Run]
 Filename: "{app}\openpype_gui.exe"; Description: "{cm:LaunchProgram,OpenPype}"; Flags: nowait postinstall skipifsilent
-

From 50af3321ae9a9e0118f6b25eb7845ce6f9ab1762 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <43494761+iLLiCiTiT@users.noreply.github.com>
Date: Tue, 19 Sep 2023 17:18:46 +0200
Subject: [PATCH 269/366] AYON: Avoid creation of duplicated links (#5593)

* create set of output links before creation

* find all existing links before creating them

* Added small comment
---
 .../publish/integrate_inputlinks_ayon.py      | 67 ++++++++++++++++---
 1 file changed, 57 insertions(+), 10 deletions(-)

diff --git a/openpype/plugins/publish/integrate_inputlinks_ayon.py b/openpype/plugins/publish/integrate_inputlinks_ayon.py
index 180524cd08..28684aa889 100644
--- a/openpype/plugins/publish/integrate_inputlinks_ayon.py
+++ b/openpype/plugins/publish/integrate_inputlinks_ayon.py
@@ -1,7 +1,11 @@
 import collections
 
 import pyblish.api
-from ayon_api import create_link, make_sure_link_type_exists
+from ayon_api import (
+    create_link,
+    make_sure_link_type_exists,
+    get_versions_links,
+)
 
 from openpype import AYON_SERVER_ENABLED
 
@@ -124,6 +128,33 @@ class IntegrateInputLinksAYON(pyblish.api.ContextPlugin):
                     version_entity["_id"],
                 )
 
+    def _get_existing_links(self, project_name, link_type, entity_ids):
+        """Find all existing links for given version ids.
+
+        Args:
+            project_name (str): Name of project.
+            link_type (str): Type of link.
+            entity_ids (set[str]): Set of version ids.
+
+        Returns:
+            dict[str, set[str]]: Existing links by version id.
+        """
+
+        output = collections.defaultdict(set)
+        if not entity_ids:
+            return output
+
+        existing_in_links = get_versions_links(
+            project_name, entity_ids, [link_type], "output"
+        )
+
+        for entity_id, links in existing_in_links.items():
+            if not links:
+                continue
+            for link in links:
+                output[entity_id].add(link["entityId"])
+        return output
+
     def create_links_on_server(self, context, new_links):
         """Create new links on server.
 
@@ -144,16 +175,32 @@ class IntegrateInputLinksAYON(pyblish.api.ContextPlugin):
 
         # Create link themselves
         for link_type, items in new_links.items():
+            mapping = collections.defaultdict(set)
+            # Make sure there are no duplicates of src > dst ids
             for item in items:
-                input_id, output_id = item
-                create_link(
-                    project_name,
-                    link_type,
-                    input_id,
-                    "version",
-                    output_id,
-                    "version"
-                )
+                _input_id, _output_id = item
+                mapping[_input_id].add(_output_id)
+
+            existing_links_by_in_id = self._get_existing_links(
+                project_name, link_type, set(mapping.keys())
+            )
+
+            for input_id, output_ids in mapping.items():
+                existing_links = existing_links_by_in_id[input_id]
+                for output_id in output_ids:
+                    # Skip creation of link if already exists
+                    # NOTE: AYON server does not support
+                    #     to have same links
+                    if output_id in existing_links:
+                        continue
+                    create_link(
+                        project_name,
+                        link_type,
+                        input_id,
+                        "version",
+                        output_id,
+                        "version"
+                    )
 
 
 if not AYON_SERVER_ENABLED:

From 85951d58f64920b33e9c6902569d890dcc1690f2 Mon Sep 17 00:00:00 2001
From: Ynbot <bot@ynput.io>
Date: Tue, 19 Sep 2023 15:31:39 +0000
Subject: [PATCH 270/366] [Automated] Release

---
 CHANGELOG.md        | 251 ++++++++++++++++++++++++++++++++++++++++++++
 openpype/version.py |   2 +-
 pyproject.toml      |   2 +-
 3 files changed, 253 insertions(+), 2 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 0d7620869b..935e7dbc4c 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,6 +1,257 @@
 # Changelog
 
 
+## [3.16.7](https://github.com/ynput/OpenPype/tree/3.16.7)
+
+
+[Full Changelog](https://github.com/ynput/OpenPype/compare/3.16.6...3.16.7)
+
+### **🆕 New features**
+
+
+<details>
+<summary>Maya: Extract active view as thumbnail when no thumbnail set <a href="https://github.com/ynput/OpenPype/pull/5426">#5426</a></summary>
+
+This sets the Maya instance's thumbnail to the current active view if no thumbnail was set yet.
+
+
+___
+
+</details>
+
+
+<details>
+<summary>Maya: Implement USD publish and load using native `mayaUsdPlugin` <a href="https://github.com/ynput/OpenPype/pull/5573">#5573</a></summary>
+
+Implement Creator and Loaders for extraction and loading of USD files using Maya's own `mayaUsdPlugin`.Also adds support to load a `usd` file into an Arnold Standin (`aiStandin`) and assigning looks to it.
+
+
+___
+
+</details>
+
+
+<details>
+<summary>AYON: Ignore separated modules <a href="https://github.com/ynput/OpenPype/pull/5619">#5619</a></summary>
+
+Do not load already separated modules from default directory.
+
+
+___
+
+</details>
+
+### **🚀 Enhancements**
+
+
+<details>
+<summary>Maya: Reduce amount of code for Collect Looks <a href="https://github.com/ynput/OpenPype/pull/5253">#5253</a></summary>
+
+- Refactor `get_file_node_files` because popping from `paths` by index should have been done in reversed order anyway. It's now changed to not need popping at all.
+- Removed unused `RENDERER_NODE_TYPES` and if-branch which collected `node_attrs` list which was unused + collected members which was also done outside of the if branch and thus generated no extra data.
+- Collected all materials from look set attributes at once instead of multiple queries
+- Collected all file nodes in history from a single query instead of per type
+- Restructured assignment of `instance.data["resources"]` to be more readable
+- Cached `PXR_NODES` only ones (Note: plugin load is checked on discovery of the collect look plugin) instead of querying plugin load and its nodes per file node per attribute
+- Removed some debug logs or combined some messages
+
+
+___
+
+</details>
+
+
+<details>
+<summary>AYON: Mark deprecated settings in Maya <a href="https://github.com/ynput/OpenPype/pull/5627">#5627</a></summary>
+
+Added deprecated info to docstrings of maya colormanagement settings.Resolves: https://github.com/ynput/OpenPype/issues/5556
+
+
+___
+
+</details>
+
+
+<details>
+<summary>Max: switching versions of maxScene maintain parentage/links with the loaders <a href="https://github.com/ynput/OpenPype/pull/5424">#5424</a></summary>
+
+When using scene inventory to manage or update the version of the loading objects, the linked modifiers or parentage of the objects would be kept.Meanwhile, loaded objects from all loaders no longer parented to the container with OP Data.
+
+
+___
+
+</details>
+
+
+<details>
+<summary>3ds max: small tweaks to obj extractor and model publishing flow <a href="https://github.com/ynput/OpenPype/pull/5605">#5605</a></summary>
+
+There migh be situation where OBJ Extractor passes without failure, but no obj file is produced. This is adding simple check directly into the extractor to catch it earlier then in the integration phase. Also switched `Validate USD Plugin` to optional, because it was always run no matter if the Extract USD was enabled or not, hindering testing (and publishing).
+
+
+___
+
+</details>
+
+
+<details>
+<summary>TVPaint: Plugin can be reopened <a href="https://github.com/ynput/OpenPype/pull/5610">#5610</a></summary>
+
+TVPaint plugin can be reopened.
+
+
+___
+
+</details>
+
+
+<details>
+<summary>Maya: Remove context prompt <a href="https://github.com/ynput/OpenPype/pull/5632">#5632</a></summary>
+
+More of a plea than a PR, but could we please remove the context prompt in Maya when switching tasks?
+
+
+___
+
+</details>
+
+
+<details>
+<summary>General: Create a desktop icon is checked <a href="https://github.com/ynput/OpenPype/pull/5636">#5636</a></summary>
+
+In OP Installer `Create a desktop icon` is checked by default. 
+___
+
+</details>
+
+### **🐛 Bug fixes**
+
+
+<details>
+<summary>Maya: Extract look is not AYON compatible - OP-5375 <a href="https://github.com/ynput/OpenPype/pull/5341">#5341</a></summary>
+
+The textures that would use hardlinking are going through texture processors. Currently all texture processors are hardcoded to copy texture instead of respecting the settings of forcing to copy.The texture processors were last modified 4 months ago, so effectively all clients that are on any pipeline updated in the last 4 months wont be utilizing hardlinking at all, since the hardcoded texture processors will copy texture no matter the OS.This opts for completely disabling the hardlinking feature, while we figure out what to do about it.
+
+
+___
+
+</details>
+
+
+<details>
+<summary>Maya: Multiverse USD Override inherit from correct new style creator <a href="https://github.com/ynput/OpenPype/pull/5566">#5566</a></summary>
+
+Fix Creator for Multiverse USD Override by inheriting from correct new style creator class type
+
+
+___
+
+</details>
+
+
+<details>
+<summary>Max: Bug Fix  Alembic Loaders with Ornatrix <a href="https://github.com/ynput/OpenPype/pull/5434">#5434</a></summary>
+
+Bugfix the alembic loader with both ornatrix alembic and max alembic supportsAdd the ornatrix alembic loaders for loading the alembic with Ornatrix-related modifiers.
+
+
+___
+
+</details>
+
+
+<details>
+<summary>AYON: Avoid creation of duplicated links <a href="https://github.com/ynput/OpenPype/pull/5593">#5593</a></summary>
+
+Handle cases when an existing link should be recreated and do not create the same link multitple times during single publishing.
+
+
+___
+
+</details>
+
+
+<details>
+<summary>Extract Review: Multilayer specification for ffmpeg <a href="https://github.com/ynput/OpenPype/pull/5613">#5613</a></summary>
+
+Extract review is specifying layer name when exr is multilayer.
+
+
+___
+
+</details>
+
+
+<details>
+<summary>Fussion: added support for Fusion 17 <a href="https://github.com/ynput/OpenPype/pull/5614">#5614</a></summary>
+
+Fusion 17 still uses Python 3.6 which causes issues with some our delivered libraries. Vendorized necessary set for Python 3.6
+
+
+___
+
+</details>
+
+
+<details>
+<summary>Publisher: Fix screenshot widget <a href="https://github.com/ynput/OpenPype/pull/5615">#5615</a></summary>
+
+Use correct super method name.EDITED:Removed fade animation which is not triggered at some cases, e.g. in Nuke the animation does not start. I do expect that is caused by `exec_` on the dialog, which blocks event processing to the animation, even when I've added the window as parent it still didn't trigger registered callback.Modified how the "empty" space is not filled by using paths instead of clear mode on painter. Added render hints to add antialiasing.
+
+
+___
+
+</details>
+
+
+<details>
+<summary>Photoshop: auto_images without alpha will not fail <a href="https://github.com/ynput/OpenPype/pull/5620">#5620</a></summary>
+
+ExtractReview caused issue on `auto_image` instance without alpha channel, this fixes it.
+
+
+___
+
+</details>
+
+
+<details>
+<summary>Fix - _id key used instead of id in get_last_version_by_subset_name <a href="https://github.com/ynput/OpenPype/pull/5626">#5626</a></summary>
+
+Just 'id' is not returned because value in fields. Caused KeyError.
+
+
+___
+
+</details>
+
+
+<details>
+<summary>Bugfix: create symlinks for ssl libs on Centos 7 <a href="https://github.com/ynput/OpenPype/pull/5633">#5633</a></summary>
+
+Docker build was missing `libssl.1.1.so` and `libcrypto.1.1.so` symlinks needed by the executable itself, because Python is now explicitly built with OpenSSL 1.1.1
+
+
+___
+
+</details>
+
+### **📃 Documentation**
+
+
+<details>
+<summary>Documentation/local settings <a href="https://github.com/ynput/OpenPype/pull/5102">#5102</a></summary>
+
+I completed the "Working with local settings" page. I updated the screenshot, wrote an explanation for each empty category, and if available, linked the more detailed pages already existing. I also added the "Environments" category.
+
+
+___
+
+</details>
+
+
+
+
 ## [3.16.6](https://github.com/ynput/OpenPype/tree/3.16.6)
 
 
diff --git a/openpype/version.py b/openpype/version.py
index bbed1b0ef3..c593f0f71f 100644
--- a/openpype/version.py
+++ b/openpype/version.py
@@ -1,3 +1,3 @@
 # -*- coding: utf-8 -*-
 """Package declaring Pype version."""
-__version__ = "3.16.7-nightly.2"
+__version__ = "3.16.7"
diff --git a/pyproject.toml b/pyproject.toml
index f859e1aff4..b394a895e3 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "OpenPype"
-version = "3.16.6" # OpenPype
+version = "3.16.7" # OpenPype
 description = "Open VFX and Animation pipeline with support."
 authors = ["OpenPype Team <info@openpype.io>"]
 license = "MIT License"

From 16641e750045f8639a7138b83580ba089abfc492 Mon Sep 17 00:00:00 2001
From: "github-actions[bot]" <github-actions[bot]@users.noreply.github.com>
Date: Tue, 19 Sep 2023 15:32:44 +0000
Subject: [PATCH 271/366] chore(): update bug report / version

---
 .github/ISSUE_TEMPLATE/bug_report.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/ISSUE_TEMPLATE/bug_report.yml b/.github/ISSUE_TEMPLATE/bug_report.yml
index cf3cb8ba1a..9159d3fe4a 100644
--- a/.github/ISSUE_TEMPLATE/bug_report.yml
+++ b/.github/ISSUE_TEMPLATE/bug_report.yml
@@ -35,6 +35,7 @@ body:
       label: Version
       description: What version are you running? Look to OpenPype Tray
       options:
+        - 3.16.7
         - 3.16.7-nightly.2
         - 3.16.7-nightly.1
         - 3.16.6
@@ -134,7 +135,6 @@ body:
         - 3.14.10-nightly.2
         - 3.14.10-nightly.1
         - 3.14.9
-        - 3.14.9-nightly.5
     validations:
       required: true
   - type: dropdown

From 982c72224cdbf3b92ac954d42e03769a79bbd6f4 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <43494761+iLLiCiTiT@users.noreply.github.com>
Date: Thu, 27 Jul 2023 10:21:05 +0200
Subject: [PATCH 272/366] Chore: Remove schema from OpenPype root (#5355)

* removed schema from openpype root

* removed schema from include files
---
 schema/application-1.0.json    |  68 ----------------
 schema/asset-1.0.json          |  35 --------
 schema/asset-2.0.json          |  55 -------------
 schema/asset-3.0.json          |  55 -------------
 schema/config-1.0.json         |  85 --------------------
 schema/config-1.1.json         |  87 --------------------
 schema/config-2.0.json         |  87 --------------------
 schema/container-1.0.json      | 100 -----------------------
 schema/container-2.0.json      |  59 --------------
 schema/hero_version-1.0.json   |  44 ----------
 schema/inventory-1.0.json      |  10 ---
 schema/inventory-1.1.json      |  10 ---
 schema/project-2.0.json        |  86 --------------------
 schema/project-2.1.json        |  86 --------------------
 schema/project-3.0.json        |  59 --------------
 schema/representation-1.0.json |  28 -------
 schema/representation-2.0.json |  78 ------------------
 schema/session-1.0.json        | 143 ---------------------------------
 schema/session-2.0.json        | 134 ------------------------------
 schema/session-3.0.json        |  81 -------------------
 schema/shaders-1.0.json        |  32 --------
 schema/subset-1.0.json         |  35 --------
 schema/subset-2.0.json         |  51 ------------
 schema/subset-3.0.json         |  62 --------------
 schema/thumbnail-1.0.json      |  42 ----------
 schema/version-1.0.json        |  50 ------------
 schema/version-2.0.json        |  92 ---------------------
 schema/version-3.0.json        |  84 -------------------
 schema/workfile-1.0.json       |  52 ------------
 setup.py                       |   1 -
 30 files changed, 1891 deletions(-)
 delete mode 100644 schema/application-1.0.json
 delete mode 100644 schema/asset-1.0.json
 delete mode 100644 schema/asset-2.0.json
 delete mode 100644 schema/asset-3.0.json
 delete mode 100644 schema/config-1.0.json
 delete mode 100644 schema/config-1.1.json
 delete mode 100644 schema/config-2.0.json
 delete mode 100644 schema/container-1.0.json
 delete mode 100644 schema/container-2.0.json
 delete mode 100644 schema/hero_version-1.0.json
 delete mode 100644 schema/inventory-1.0.json
 delete mode 100644 schema/inventory-1.1.json
 delete mode 100644 schema/project-2.0.json
 delete mode 100644 schema/project-2.1.json
 delete mode 100644 schema/project-3.0.json
 delete mode 100644 schema/representation-1.0.json
 delete mode 100644 schema/representation-2.0.json
 delete mode 100644 schema/session-1.0.json
 delete mode 100644 schema/session-2.0.json
 delete mode 100644 schema/session-3.0.json
 delete mode 100644 schema/shaders-1.0.json
 delete mode 100644 schema/subset-1.0.json
 delete mode 100644 schema/subset-2.0.json
 delete mode 100644 schema/subset-3.0.json
 delete mode 100644 schema/thumbnail-1.0.json
 delete mode 100644 schema/version-1.0.json
 delete mode 100644 schema/version-2.0.json
 delete mode 100644 schema/version-3.0.json
 delete mode 100644 schema/workfile-1.0.json

diff --git a/schema/application-1.0.json b/schema/application-1.0.json
deleted file mode 100644
index 953abee569..0000000000
--- a/schema/application-1.0.json
+++ /dev/null
@@ -1,68 +0,0 @@
-{
-    "$schema": "http://json-schema.org/draft-04/schema#",
-
-    "title": "openpype:application-1.0",
-    "description": "An application definition.",
-
-    "type": "object",
-
-    "additionalProperties": true,
-
-    "required": [
-        "schema",
-        "label",
-        "application_dir",
-        "executable"
-    ],
-
-    "properties": {
-        "schema": {
-            "description": "Schema identifier for payload",
-            "type": "string"
-        },
-        "label": {
-            "description": "Nice name of application.",
-            "type": "string"
-        },
-        "application_dir": {
-            "description": "Name of directory used for application resources.",
-            "type": "string"
-        },
-        "executable": {
-            "description": "Name of callable executable, this is called to launch the application",
-            "type": "string"
-        },
-        "description": {
-            "description": "Description of application.",
-            "type": "string"
-        },
-        "environment": {
-            "description": "Key/value pairs for environment variables related to this application. Supports lists for paths, such as PYTHONPATH.",
-            "type": "object",
-            "items": {
-                "oneOf": [
-                    {"type": "string"},
-                    {"type": "array", "items": {"type": "string"}}
-                ]
-            }
-        },
-        "default_dirs": {
-            "type": "array",
-            "items": {
-                "type": "string"
-            }
-        },
-        "copy": {
-            "type": "object",
-            "patternProperties": {
-                "^.*$": {
-                    "anyOf": [
-                        {"type": "string"},
-                        {"type": "null"}
-                    ]
-                }
-            },
-            "additionalProperties": false
-        }
-    }
-}
diff --git a/schema/asset-1.0.json b/schema/asset-1.0.json
deleted file mode 100644
index ab104c002a..0000000000
--- a/schema/asset-1.0.json
+++ /dev/null
@@ -1,35 +0,0 @@
-{
-    "$schema": "http://json-schema.org/draft-04/schema#",
-
-    "title": "openpype:asset-1.0",
-    "description": "A unit of data",
-
-    "type": "object",
-
-    "additionalProperties": true,
-
-    "required": [
-        "schema",
-        "name",
-        "subsets"
-    ],
-
-    "properties": {
-        "schema": {
-            "description": "Schema identifier for payload",
-            "type": "string"
-        },
-        "name": {
-            "description": "Name of directory",
-            "type": "string"
-        },
-        "subsets": {
-            "type": "array",
-            "items": {
-                "$ref": "subset.json"
-            }
-        }
-    },
-
-    "definitions": {}
-}
diff --git a/schema/asset-2.0.json b/schema/asset-2.0.json
deleted file mode 100644
index b894d79792..0000000000
--- a/schema/asset-2.0.json
+++ /dev/null
@@ -1,55 +0,0 @@
-{
-    "$schema": "http://json-schema.org/draft-04/schema#",
-
-    "title": "openpype:asset-2.0",
-    "description": "A unit of data",
-
-    "type": "object",
-
-    "additionalProperties": true,
-
-    "required": [
-        "schema",
-        "type",
-        "name",
-        "silo",
-        "data"
-    ],
-
-    "properties": {
-        "schema": {
-            "description": "Schema identifier for payload",
-            "type": "string",
-            "enum": ["openpype:asset-2.0"],
-            "example": "openpype:asset-2.0"
-        },
-        "type": {
-            "description": "The type of document",
-            "type": "string",
-            "enum": ["asset"],
-            "example": "asset"
-        },
-        "parent": {
-            "description": "Unique identifier to parent document",
-            "example": "592c33475f8c1b064c4d1696"
-        },
-        "name": {
-            "description": "Name of asset",
-            "type": "string",
-            "pattern": "^[a-zA-Z0-9_.]*$",
-            "example": "Bruce"
-        },
-        "silo": {
-            "description": "Group or container of asset",
-            "type": "string",
-            "example": "assets"
-        },
-        "data": {
-            "description": "Document metadata",
-            "type": "object",
-            "example": {"key": "value"}
-        }
-    },
-
-    "definitions": {}
-}
diff --git a/schema/asset-3.0.json b/schema/asset-3.0.json
deleted file mode 100644
index 948704d2a1..0000000000
--- a/schema/asset-3.0.json
+++ /dev/null
@@ -1,55 +0,0 @@
-{
-    "$schema": "http://json-schema.org/draft-04/schema#",
-
-    "title": "openpype:asset-3.0",
-    "description": "A unit of data",
-
-    "type": "object",
-
-    "additionalProperties": true,
-
-    "required": [
-        "schema",
-        "type",
-        "name",
-        "data"
-    ],
-
-    "properties": {
-        "schema": {
-            "description": "Schema identifier for payload",
-            "type": "string",
-            "enum": ["openpype:asset-3.0"],
-            "example": "openpype:asset-3.0"
-        },
-        "type": {
-            "description": "The type of document",
-            "type": "string",
-            "enum": ["asset"],
-            "example": "asset"
-        },
-        "parent": {
-            "description": "Unique identifier to parent document",
-            "example": "592c33475f8c1b064c4d1696"
-        },
-        "name": {
-            "description": "Name of asset",
-            "type": "string",
-            "pattern": "^[a-zA-Z0-9_.]*$",
-            "example": "Bruce"
-        },
-        "silo": {
-            "description": "Group or container of asset",
-            "type": "string",
-            "pattern": "^[a-zA-Z0-9_.]*$",
-            "example": "assets"
-        },
-        "data": {
-            "description": "Document metadata",
-            "type": "object",
-            "example": {"key": "value"}
-        }
-    },
-
-    "definitions": {}
-}
diff --git a/schema/config-1.0.json b/schema/config-1.0.json
deleted file mode 100644
index 49398a57cd..0000000000
--- a/schema/config-1.0.json
+++ /dev/null
@@ -1,85 +0,0 @@
-{
-    "$schema": "http://json-schema.org/draft-04/schema#",
-
-    "title": "openpype:config-1.0",
-    "description": "A project configuration.",
-
-    "type": "object",
-
-    "additionalProperties": false,
-    "required": [
-        "tasks",
-        "apps"
-    ],
-
-    "properties": {
-        "schema": {
-            "description": "Schema identifier for payload",
-            "type": "string"
-        },
-        "template": {
-            "type": "object",
-            "additionalProperties": false,
-            "patternProperties": {
-                "^.*$": {
-                    "type": "string"
-                }
-            }
-        },
-        "tasks": {
-            "type": "array",
-            "items": {
-                "type": "object",
-                "properties": {
-                    "name": {"type": "string"},
-                    "icon": {"type": "string"},
-                    "group": {"type": "string"},
-                    "label": {"type": "string"}
-                },
-                "required": ["name"]
-            }
-        },
-        "apps": {
-            "type": "array",
-            "items": {
-                "type": "object",
-                "properties": {
-                    "name": {"type": "string"},
-                    "icon": {"type": "string"},
-                    "group": {"type": "string"},
-                    "label": {"type": "string"}
-                },
-                "required": ["name"]
-            }
-        },
-        "families": {
-            "type": "array",
-            "items": {
-                "type": "object",
-                "properties": {
-                    "name": {"type": "string"},
-                    "icon": {"type": "string"},
-                    "label": {"type": "string"},
-                    "hideFilter": {"type": "boolean"}
-                },
-                "required": ["name"]
-            }
-        },
-        "groups": {
-            "type": "array",
-            "items": {
-                "type": "object",
-                "properties": {
-                    "name": {"type": "string"},
-                    "icon": {"type": "string"},
-                    "color": {"type": "string"},
-                    "order": {"type": ["integer", "number"]}
-                },
-                "required": ["name"]
-            }
-        },
-        "copy": {
-            "type": "object"
-        }
-    }
-}
diff --git a/schema/config-1.1.json b/schema/config-1.1.json
deleted file mode 100644
index 6e15514aaf..0000000000
--- a/schema/config-1.1.json
+++ /dev/null
@@ -1,87 +0,0 @@
-{
-    "$schema": "http://json-schema.org/draft-04/schema#",
-
-    "title": "openpype:config-1.1",
-    "description": "A project configuration.",
-
-    "type": "object",
-
-    "additionalProperties": false,
-    "required": [
-        "tasks",
-        "apps"
-    ],
-
-    "properties": {
-        "schema": {
-            "description": "Schema identifier for payload",
-            "type": "string"
-        },
-        "template": {
-            "type": "object",
-            "additionalProperties": false,
-            "patternProperties": {
-                "^.*$": {
-                    "type": "string"
-                }
-            }
-        },
-        "tasks": {
-            "type": "object",
-            "items": {
-                "type": "object",
-                "properties": {
-                    "name": {"type": "string"},
-                    "icon": {"type": "string"},
-                    "group": {"type": "string"},
-                    "label": {"type": "string"}
-                },
-                "required": [
-                    "short_name"
-                ]
-            }
-        },
-        "apps": {
-            "type": "array",
-            "items": {
-                "type": "object",
-                "properties": {
-                    "name": {"type": "string"},
-                    "icon": {"type": "string"},
-                    "group": {"type": "string"},
-                    "label": {"type": "string"}
-                },
-                "required": ["name"]
-            }
-        },
-        "families": {
-            "type": "array",
-            "items": {
-                "type": "object",
-                "properties": {
-                    "name": {"type": "string"},
-                    "icon": {"type": "string"},
-                    "label": {"type": "string"},
-                    "hideFilter": {"type": "boolean"}
-                },
-                "required": ["name"]
-            }
-        },
-        "groups": {
-            "type": "array",
-            "items": {
-                "type": "object",
-                "properties": {
-                    "name": {"type": "string"},
-                    "icon": {"type": "string"},
-                    "color": {"type": "string"},
-                    "order": {"type": ["integer", "number"]}
-                },
-                "required": ["name"]
-            }
-        },
-        "copy": {
-            "type": "object"
-        }
-    }
-}
diff --git a/schema/config-2.0.json b/schema/config-2.0.json
deleted file mode 100644
index 54b226711a..0000000000
--- a/schema/config-2.0.json
+++ /dev/null
@@ -1,87 +0,0 @@
-{
-    "$schema": "http://json-schema.org/draft-04/schema#",
-
-    "title": "openpype:config-2.0",
-    "description": "A project configuration.",
-
-    "type": "object",
-
-    "additionalProperties": false,
-    "required": [
-        "tasks",
-        "apps"
-    ],
-
-    "properties": {
-        "schema": {
-            "description": "Schema identifier for payload",
-            "type": "string"
-        },
-        "templates": {
-            "type": "object"
-        },
-        "roots": {
-            "type": "object"
-        },
-        "imageio": {
-            "type": "object"
-        },
-        "tasks": {
-            "type": "object",
-            "items": {
-                "type": "object",
-                "properties": {
-                    "name": {"type": "string"},
-                    "icon": {"type": "string"},
-                    "group": {"type": "string"},
-                    "label": {"type": "string"}
-                },
-                "required": [
-                    "short_name"
-                ]
-            }
-        },
-        "apps": {
-            "type": "array",
-            "items": {
-                "type": "object",
-                "properties": {
-                    "name": {"type": "string"},
-                    "icon": {"type": "string"},
-                    "group": {"type": "string"},
-                    "label": {"type": "string"}
-                },
-                "required": ["name"]
-            }
-        },
-        "families": {
-            "type": "array",
-            "items": {
-                "type": "object",
-                "properties": {
-                    "name": {"type": "string"},
-                    "icon": {"type": "string"},
-                    "label": {"type": "string"},
-                    "hideFilter": {"type": "boolean"}
-                },
-                "required": ["name"]
-            }
-        },
-        "groups": {
-            "type": "array",
-            "items": {
-                "type": "object",
-                "properties": {
-                    "name": {"type": "string"},
-                    "icon": {"type": "string"},
-                    "color": {"type": "string"},
-                    "order": {"type": ["integer", "number"]}
-                },
-                "required": ["name"]
-            }
-        },
-        "copy": {
-            "type": "object"
-        }
-    }
-}
diff --git a/schema/container-1.0.json b/schema/container-1.0.json
deleted file mode 100644
index 012e8499e6..0000000000
--- a/schema/container-1.0.json
+++ /dev/null
@@ -1,100 +0,0 @@
-{
-    "$schema": "http://json-schema.org/draft-04/schema#",
-
-    "title": "openpype:container-1.0",
-    "description": "A loaded asset",
-
-    "type": "object",
-
-    "additionalProperties": true,
-
-    "required": [
-        "id",
-        "objectName",
-        "name",
-        "author",
-        "loader",
-        "families",
-        "time",
-        "subset",
-        "asset",
-        "representation",
-        "version",
-        "silo",
-        "path",
-        "source"
-    ],
-    "properties": {
-        "id": {
-            "description": "Identifier for finding object in host",
-            "type": "string",
-            "enum": ["pyblish.mindbender.container"],
-            "example": "pyblish.mindbender.container"
-        },
-        "objectName": {
-            "description": "Name of internal object, such as the objectSet in Maya.",
-            "type": "string",
-            "example": "Bruce_:rigDefault_CON"
-        },
-        "name": {
-            "description": "Full name of application object",
-            "type": "string",
-            "example": "modelDefault"
-        },
-        "author": {
-            "description": "Name of the author of the published version",
-            "type": "string",
-            "example": "Marcus Ottosson"
-        },
-        "loader": {
-            "description": "Name of loader plug-in used to produce this container",
-            "type": "string",
-            "example": "ModelLoader"
-        },
-        "families": {
-            "description": "Families associated with the this subset",
-            "type": "string",
-            "example": "mindbender.model"
-        },
-        "time": {
-            "description": "File-system safe, formatted time",
-            "type": "string",
-            "example": "20170329T131545Z"
-        },
-        "subset": {
-            "description": "Name of source subset",
-            "type": "string",
-            "example": "modelDefault"
-        },
-        "asset": {
-            "description": "Name of source asset",
-            "type": "string"  ,
-            "example": "Bruce"
-        },
-        "representation": {
-            "description": "Name of source representation",
-            "type": "string"  ,
-            "example": ".ma"
-        },
-        "version": {
-            "description": "Version number",
-            "type": "number",
-            "example": 12
-        },
-        "silo": {
-            "description": "Silo of parent asset",
-            "type": "string",
-            "example": "assets"
-        },
-        "path": {
-            "description": "Absolute path on disk",
-            "type": "string",
-            "example": "{root}/assets/Bruce/publish/rigDefault/v002"
-        },
-        "source": {
-            "description": "Absolute path to file from which this version was published",
-            "type": "string",
-            "example": "{root}/assets/Bruce/work/rigging/maya/scenes/rig_v001.ma"
-        }
-    }
-}
diff --git a/schema/container-2.0.json b/schema/container-2.0.json
deleted file mode 100644
index 1673ee5d1d..0000000000
--- a/schema/container-2.0.json
+++ /dev/null
@@ -1,59 +0,0 @@
-{
-    "$schema": "http://json-schema.org/draft-04/schema#",
-
-    "title": "openpype:container-2.0",
-    "description": "A loaded asset",
-
-    "type": "object",
-
-    "additionalProperties": true,
-
-    "required": [
-        "schema",
-        "id",
-        "objectName",
-        "name",
-        "namespace",
-        "loader",
-        "representation"
-    ],
-    "properties": {
-        "schema": {
-            "description": "Schema identifier for payload",
-            "type": "string",
-            "enum": ["openpype:container-2.0"],
-            "example": "openpype:container-2.0"
-        },
-          "id": {
-            "description": "Identifier for finding object in host",
-            "type": "string",
-            "enum": ["pyblish.avalon.container"],
-            "example": "pyblish.avalon.container"
-        },
-        "objectName": {
-            "description": "Name of internal object, such as the objectSet in Maya.",
-            "type": "string",
-            "example": "Bruce_:rigDefault_CON"
-        },
-        "loader": {
-            "description": "Name of loader plug-in used to produce this container",
-            "type": "string",
-            "example": "ModelLoader"
-        },
-        "name": {
-            "description": "Internal object name of container in application",
-            "type": "string",
-            "example": "modelDefault_01"
-        },
-        "namespace": {
-            "description": "Internal namespace of container in application",
-            "type": "string",
-            "example": "Bruce_"
-        },
-        "representation": {
-            "description": "Unique id of representation in database",
-            "type": "string",
-            "example": "59523f355f8c1b5f6c5e8348"
-        }
-    }
-}
diff --git a/schema/hero_version-1.0.json b/schema/hero_version-1.0.json
deleted file mode 100644
index b720dc2887..0000000000
--- a/schema/hero_version-1.0.json
+++ /dev/null
@@ -1,44 +0,0 @@
-{
-    "$schema": "http://json-schema.org/draft-04/schema#",
-
-    "title": "openpype:hero_version-1.0",
-    "description": "Hero version of asset",
-
-    "type": "object",
-
-    "additionalProperties": true,
-
-    "required": [
-        "version_id",
-        "schema",
-        "type",
-        "parent"
-    ],
-
-    "properties": {
-        "_id": {
-            "description": "Document's id (database will create it's if not entered)",
-            "example": "ObjectId(592c33475f8c1b064c4d1696)"
-        },
-        "version_id": {
-            "description": "The version ID from which it was created",
-            "example": "ObjectId(592c33475f8c1b064c4d1695)"
-        },
-        "schema": {
-            "description": "The schema associated with this document",
-            "type": "string",
-            "enum": ["openpype:hero_version-1.0"],
-            "example": "openpype:hero_version-1.0"
-        },
-        "type": {
-            "description": "The type of document",
-            "type": "string",
-            "enum": ["hero_version"],
-            "example": "hero_version"
-        },
-        "parent": {
-            "description": "Unique identifier to parent document",
-            "example": "ObjectId(592c33475f8c1b064c4d1697)"
-        }
-    }
-}
diff --git a/schema/inventory-1.0.json b/schema/inventory-1.0.json
deleted file mode 100644
index 2fe78794ab..0000000000
--- a/schema/inventory-1.0.json
+++ /dev/null
@@ -1,10 +0,0 @@
-{
-    "$schema": "http://json-schema.org/draft-04/schema#",
-
-    "title": "openpype:config-1.0",
-    "description": "A project configuration.",
-
-    "type": "object",
-
-    "additionalProperties": true
-}
diff --git a/schema/inventory-1.1.json b/schema/inventory-1.1.json
deleted file mode 100644
index b61a76b32a..0000000000
--- a/schema/inventory-1.1.json
+++ /dev/null
@@ -1,10 +0,0 @@
-{
-    "$schema": "http://json-schema.org/draft-04/schema#",
-
-    "title": "openpype:config-1.1",
-    "description": "A project configuration.",
-
-    "type": "object",
-
-    "additionalProperties": true
-}
diff --git a/schema/project-2.0.json b/schema/project-2.0.json
deleted file mode 100644
index 0ed5a55599..0000000000
--- a/schema/project-2.0.json
+++ /dev/null
@@ -1,86 +0,0 @@
-{
-    "$schema": "http://json-schema.org/draft-04/schema#",
-
-    "title": "openpype:project-2.0",
-    "description": "A unit of data",
-
-    "type": "object",
-
-    "additionalProperties": true,
-
-    "required": [
-        "schema",
-        "type",
-        "name",
-        "data",
-        "config"
-    ],
-
-    "properties": {
-        "schema": {
-            "description": "Schema identifier for payload",
-            "type": "string",
-            "enum": ["openpype:project-2.0"],
-            "example": "openpype:project-2.0"
-        },
-        "type": {
-            "description": "The type of document",
-            "type": "string",
-            "enum": ["project"],
-            "example": "project"
-        },
-        "parent": {
-            "description": "Unique identifier to parent document",
-            "example": "592c33475f8c1b064c4d1696"
-        },
-        "name": {
-            "description": "Name of directory",
-            "type": "string",
-            "pattern": "^[a-zA-Z0-9_.]*$",
-            "example": "hulk"
-        },
-        "data": {
-            "description": "Document metadata",
-            "type": "object",
-            "example": {
-                "fps": 24,
-                "width": 1920,
-                "height": 1080
-            }
-        },
-        "config": {
-            "type": "object",
-            "description": "Document metadata",
-            "example": {
-                "schema": "openpype:config-1.0",
-                "apps": [
-                    {
-                        "name": "maya2016",
-                        "label": "Autodesk Maya 2016"
-                    },
-                    {
-                        "name": "nuke10",
-                        "label": "The Foundry Nuke 10.0"
-                    }
-                ],
-                "tasks": [
-                    {"name": "model"},
-                    {"name": "render"},
-                    {"name": "animate"},
-                    {"name": "rig"},
-                    {"name": "lookdev"},
-                    {"name": "layout"}
-                ],
-                "template": {
-                    "work":
-                        "{root}/{project}/{silo}/{asset}/work/{task}/{app}",
-                    "publish":
-                        "{root}/{project}/{silo}/{asset}/publish/{subset}/v{version:0>3}/{subset}.{representation}"
-                }
-            },
-            "$ref": "config-1.0.json"
-        }
-    },
-
-    "definitions": {}
-}
diff --git a/schema/project-2.1.json b/schema/project-2.1.json
deleted file mode 100644
index 9413c9f691..0000000000
--- a/schema/project-2.1.json
+++ /dev/null
@@ -1,86 +0,0 @@
-{
-    "$schema": "http://json-schema.org/draft-04/schema#",
-
-    "title": "openpype:project-2.1",
-    "description": "A unit of data",
-
-    "type": "object",
-
-    "additionalProperties": true,
-
-    "required": [
-        "schema",
-        "type",
-        "name",
-        "data",
-        "config"
-    ],
-
-    "properties": {
-        "schema": {
-            "description": "Schema identifier for payload",
-            "type": "string",
-            "enum": ["openpype:project-2.1"],
-            "example": "openpype:project-2.1"
-        },
-        "type": {
-            "description": "The type of document",
-            "type": "string",
-            "enum": ["project"],
-            "example": "project"
-        },
-        "parent": {
-            "description": "Unique identifier to parent document",
-            "example": "592c33475f8c1b064c4d1696"
-        },
-        "name": {
-            "description": "Name of directory",
-            "type": "string",
-            "pattern": "^[a-zA-Z0-9_.]*$",
-            "example": "hulk"
-        },
-        "data": {
-            "description": "Document metadata",
-            "type": "object",
-            "example": {
-                "fps": 24,
-                "width": 1920,
-                "height": 1080
-            }
-        },
-        "config": {
-            "type": "object",
-            "description": "Document metadata",
-            "example": {
-                "schema": "openpype:config-1.1",
-                "apps": [
-                    {
-                        "name": "maya2016",
-                        "label": "Autodesk Maya 2016"
-                    },
-                    {
-                        "name": "nuke10",
-                        "label": "The Foundry Nuke 10.0"
-                    }
-                ],
-                "tasks": {
-                    "Model":   {"short_name": "mdl"},
-                    "Render":  {"short_name": "rnd"},
-                    "Animate": {"short_name": "anim"},
-                    "Rig":     {"short_name": "rig"},
-                    "Lookdev": {"short_name": "look"},
-                    "Layout":  {"short_name": "lay"}
-                },
-                "template": {
-                    "work":
-                        "{root}/{project}/{silo}/{asset}/work/{task}/{app}",
-                    "publish":
-                        "{root}/{project}/{silo}/{asset}/publish/{subset}/v{version:0>3}/{subset}.{representation}"
-                }
-            },
-            "$ref": "config-1.1.json"
-        }
-    },
-
-    "definitions": {}
-}
diff --git a/schema/project-3.0.json b/schema/project-3.0.json
deleted file mode 100644
index be23e10c93..0000000000
--- a/schema/project-3.0.json
+++ /dev/null
@@ -1,59 +0,0 @@
-{
-    "$schema": "http://json-schema.org/draft-04/schema#",
-
-    "title": "openpype:project-3.0",
-    "description": "A unit of data",
-
-    "type": "object",
-
-    "additionalProperties": true,
-
-    "required": [
-        "schema",
-        "type",
-        "name",
-        "data",
-        "config"
-    ],
-
-    "properties": {
-        "schema": {
-            "description": "Schema identifier for payload",
-            "type": "string",
-            "enum": ["openpype:project-3.0"],
-            "example": "openpype:project-3.0"
-        },
-        "type": {
-            "description": "The type of document",
-            "type": "string",
-            "enum": ["project"],
-            "example": "project"
-        },
-        "parent": {
-            "description": "Unique identifier to parent document",
-            "example": "592c33475f8c1b064c4d1696"
-        },
-        "name": {
-            "description": "Name of directory",
-            "type": "string",
-            "pattern": "^[a-zA-Z0-9_.]*$",
-            "example": "hulk"
-        },
-        "data": {
-            "description": "Document metadata",
-            "type": "object",
-            "example": {
-                "fps": 24,
-                "width": 1920,
-                "height": 1080
-            }
-        },
-        "config": {
-            "type": "object",
-            "description": "Document metadata",
-            "$ref": "config-2.0.json"
-        }
-    },
-
-    "definitions": {}
-}
diff --git a/schema/representation-1.0.json b/schema/representation-1.0.json
deleted file mode 100644
index 347c585f52..0000000000
--- a/schema/representation-1.0.json
+++ /dev/null
@@ -1,28 +0,0 @@
-{
-    "$schema": "http://json-schema.org/draft-04/schema#",
-
-    "title": "openpype:representation-1.0",
-    "description": "The inverse of an instance",
-
-    "type": "object",
-
-    "additionalProperties": true,
-
-    "required": [
-        "schema",
-        "format",
-        "path"
-    ],
-
-    "properties": {
-        "schema": {"type": "string"},
-        "format": {
-            "description": "File extension, including '.'",
-            "type": "string"
-        },
-        "path": {
-            "description": "Unformatted path to version.",
-            "type": "string"
-        }
-    }
-}
diff --git a/schema/representation-2.0.json b/schema/representation-2.0.json
deleted file mode 100644
index f47c16a10a..0000000000
--- a/schema/representation-2.0.json
+++ /dev/null
@@ -1,78 +0,0 @@
-{
-    "$schema": "http://json-schema.org/draft-04/schema#",
-
-    "title": "openpype:representation-2.0",
-    "description": "The inverse of an instance",
-
-    "type": "object",
-
-    "additionalProperties": true,
-
-    "required": [
-        "schema",
-        "type",
-        "parent",
-        "name",
-        "data"
-    ],
-
-    "properties": {
-        "schema": {
-            "description": "Schema identifier for payload",
-            "type": "string",
-            "enum": ["openpype:representation-2.0"],
-            "example": "openpype:representation-2.0"
-        },
-        "type": {
-            "description": "The type of document",
-            "type": "string",
-            "enum": ["representation"],
-            "example": "representation"
-        },
-        "parent": {
-            "description": "Unique identifier to parent document",
-            "example": "592c33475f8c1b064c4d1696"
-        },
-        "name": {
-            "description": "Name of representation",
-            "type": "string",
-            "pattern": "^[a-zA-Z0-9_.]*$",
-            "example": "abc"
-        },
-        "data": {
-            "description": "Document metadata",
-            "type": "object",
-            "example": {
-                "label": "Alembic"
-            }
-        },
-        "dependencies": {
-            "description": "Other representation that this representation depends on",
-            "type": "array",
-            "items": {"type": "string"},
-            "example": [
-                "592d547a5f8c1b388093c145"
-            ]
-        },
-        "context": {
-            "description": "Summary of the context to which this representation belong.",
-            "type": "object",
-            "properties": {
-                "project": {"type": "object"},
-                "asset": {"type": "string"},
-                "silo": {"type": ["string", "null"]},
-                "subset": {"type": "string"},
-                "version": {"type": "number"},
-                "representation": {"type": "string"}
-            },
-            "example": {
-                "project": "hulk",
-                "asset": "Bruce",
-                "silo": "assets",
-                "subset": "rigDefault",
-                "version": 12,
-                "representation": "ma"
-            }
-        }
-    }
-}
diff --git a/schema/session-1.0.json b/schema/session-1.0.json
deleted file mode 100644
index 5ced0a6f08..0000000000
--- a/schema/session-1.0.json
+++ /dev/null
@@ -1,143 +0,0 @@
-{
-    "$schema": "http://json-schema.org/draft-04/schema#",
-
-    "title": "openpype:session-1.0",
-    "description": "The Avalon environment",
-
-    "type": "object",
-
-    "additionalProperties": true,
-
-    "required": [
-        "AVALON_PROJECTS",
-        "AVALON_PROJECT",
-        "AVALON_ASSET",
-        "AVALON_SILO",
-        "AVALON_CONFIG"
-    ],
-
-    "properties": {
-        "AVALON_PROJECTS": {
-            "description": "Absolute path to root of project directories",
-            "type": "string",
-            "example": "/nas/projects"
-        },
-        "AVALON_PROJECT": {
-            "description": "Name of project",
-            "type": "string",
-            "pattern": "^\\w*$",
-            "example": "Hulk"
-        },
-        "AVALON_ASSET": {
-            "description": "Name of asset",
-            "type": "string",
-            "pattern": "^\\w*$",
-            "example": "Bruce"
-        },
-        "AVALON_SILO": {
-            "description": "Name of asset group or container",
-            "type": "string",
-            "pattern": "^\\w*$",
-            "example": "assets"
-        },
-        "AVALON_TASK": {
-            "description": "Name of task",
-            "type": "string",
-            "pattern": "^\\w*$",
-            "example": "modeling"
-        },
-        "AVALON_CONFIG": {
-            "description": "Name of Avalon configuration",
-            "type": "string",
-            "pattern": "^\\w*$",
-            "example": "polly"
-        },
-        "AVALON_APP": {
-            "description": "Name of application",
-            "type": "string",
-            "pattern": "^\\w*$",
-            "example": "maya2016"
-        },
-        "AVALON_MONGO": {
-            "description": "Address to the asset database",
-            "type": "string",
-            "pattern": "^mongodb://[\\w/@:.]*$",
-            "example": "mongodb://localhost:27017",
-            "default": "mongodb://localhost:27017"
-        },
-        "AVALON_DB": {
-            "description": "Name of database",
-            "type": "string",
-            "pattern": "^\\w*$",
-            "example": "avalon",
-            "default": "avalon"
-        },
-        "AVALON_LABEL": {
-            "description": "Nice name of Avalon, used in e.g. graphical user interfaces",
-            "type": "string",
-            "example": "Mindbender",
-            "default": "Avalon"
-        },
-        "AVALON_SENTRY": {
-            "description": "Address to Sentry",
-            "type": "string",
-            "pattern": "^http[\\w/@:.]*$",
-            "example": "https://5b872b280de742919b115bdc8da076a5:8d278266fe764361b8fa6024af004a9c@logs.mindbender.com/2",
-            "default": null
-        },
-        "AVALON_DEADLINE": {
-            "description": "Address to Deadline",
-            "type": "string",
-            "pattern": "^http[\\w/@:.]*$",
-            "example": "http://192.168.99.101",
-            "default": null
-        },
-        "AVALON_TIMEOUT": {
-            "description": "Wherever there is a need for a timeout, this is the default value.",
-            "type": "string",
-            "pattern": "^[0-9]*$",
-            "default": "1000",
-            "example": "1000"
-        },
-        "AVALON_UPLOAD": {
-            "description": "Boolean of whether to upload published material to central asset repository",
-            "type": "string",
-            "default": null,
-            "example": "True"
-        },
-        "AVALON_USERNAME": {
-            "description": "Generic username",
-            "type": "string",
-            "pattern": "^\\w*$",
-            "default": "avalon",
-            "example": "myself"
-        },
-        "AVALON_PASSWORD": {
-            "description": "Generic password",
-            "type": "string",
-            "pattern": "^\\w*$",
-            "default": "secret",
-            "example": "abc123"
-        },
-        "AVALON_INSTANCE_ID": {
-            "description": "Unique identifier for instances in a working file",
-            "type": "string",
-            "pattern": "^[\\w.]*$",
-            "default": "avalon.instance",
-            "example": "avalon.instance"
-        },
-        "AVALON_CONTAINER_ID": {
-            "description": "Unique identifier for a loaded representation in a working file",
-            "type": "string",
-            "pattern": "^[\\w.]*$",
-            "default": "avalon.container",
-            "example": "avalon.container"
-        },
-        "AVALON_DEBUG": {
-            "description": "Enable debugging mode. Some applications may use this for e.g. extended verbosity or mock plug-ins.",
-            "type": "string",
-            "default": null,
-            "example": "True"
-        }
-    }
-}
diff --git a/schema/session-2.0.json b/schema/session-2.0.json
deleted file mode 100644
index 0a4d51beb2..0000000000
--- a/schema/session-2.0.json
+++ /dev/null
@@ -1,134 +0,0 @@
-{
-    "$schema": "http://json-schema.org/draft-04/schema#",
-
-    "title": "openpype:session-2.0",
-    "description": "The Avalon environment",
-
-    "type": "object",
-
-    "additionalProperties": true,
-
-    "required": [
-        "AVALON_PROJECT",
-        "AVALON_ASSET",
-        "AVALON_CONFIG"
-    ],
-
-    "properties": {
-        "AVALON_PROJECTS": {
-            "description": "Absolute path to root of project directories",
-            "type": "string",
-            "example": "/nas/projects"
-        },
-        "AVALON_PROJECT": {
-            "description": "Name of project",
-            "type": "string",
-            "pattern": "^\\w*$",
-            "example": "Hulk"
-        },
-        "AVALON_ASSET": {
-            "description": "Name of asset",
-            "type": "string",
-            "pattern": "^\\w*$",
-            "example": "Bruce"
-        },
-        "AVALON_SILO": {
-            "description": "Name of asset group or container",
-            "type": "string",
-            "pattern": "^\\w*$",
-            "example": "assets"
-        },
-        "AVALON_TASK": {
-            "description": "Name of task",
-            "type": "string",
-            "pattern": "^\\w*$",
-            "example": "modeling"
-        },
-        "AVALON_CONFIG": {
-            "description": "Name of Avalon configuration",
-            "type": "string",
-            "pattern": "^\\w*$",
-            "example": "polly"
-        },
-        "AVALON_APP": {
-            "description": "Name of application",
-            "type": "string",
-            "pattern": "^\\w*$",
-            "example": "maya2016"
-        },
-        "AVALON_DB": {
-            "description": "Name of database",
-            "type": "string",
-            "pattern": "^\\w*$",
-            "example": "avalon",
-            "default": "avalon"
-        },
-        "AVALON_LABEL": {
-            "description": "Nice name of Avalon, used in e.g. graphical user interfaces",
-            "type": "string",
-            "example": "Mindbender",
-            "default": "Avalon"
-        },
-        "AVALON_SENTRY": {
-            "description": "Address to Sentry",
-            "type": "string",
-            "pattern": "^http[\\w/@:.]*$",
-            "example": "https://5b872b280de742919b115bdc8da076a5:8d278266fe764361b8fa6024af004a9c@logs.mindbender.com/2",
-            "default": null
-        },
-        "AVALON_DEADLINE": {
-            "description": "Address to Deadline",
-            "type": "string",
-            "pattern": "^http[\\w/@:.]*$",
-            "example": "http://192.168.99.101",
-            "default": null
-        },
-        "AVALON_TIMEOUT": {
-            "description": "Wherever there is a need for a timeout, this is the default value.",
-            "type": "string",
-            "pattern": "^[0-9]*$",
-            "default": "1000",
-            "example": "1000"
-        },
-        "AVALON_UPLOAD": {
-            "description": "Boolean of whether to upload published material to central asset repository",
-            "type": "string",
-            "default": null,
-            "example": "True"
-        },
-        "AVALON_USERNAME": {
-            "description": "Generic username",
-            "type": "string",
-            "pattern": "^\\w*$",
-            "default": "avalon",
-            "example": "myself"
-        },
-        "AVALON_PASSWORD": {
-            "description": "Generic password",
-            "type": "string",
-            "pattern": "^\\w*$",
-            "default": "secret",
-            "example": "abc123"
-        },
-        "AVALON_INSTANCE_ID": {
-            "description": "Unique identifier for instances in a working file",
-            "type": "string",
-            "pattern": "^[\\w.]*$",
-            "default": "avalon.instance",
-            "example": "avalon.instance"
-        },
-        "AVALON_CONTAINER_ID": {
-            "description": "Unique identifier for a loaded representation in a working file",
-            "type": "string",
-            "pattern": "^[\\w.]*$",
-            "default": "avalon.container",
-            "example": "avalon.container"
-        },
-        "AVALON_DEBUG": {
-            "description": "Enable debugging mode. Some applications may use this for e.g. extended verbosity or mock plug-ins.",
-            "type": "string",
-            "default": null,
-            "example": "True"
-        }
-    }
-}
diff --git a/schema/session-3.0.json b/schema/session-3.0.json
deleted file mode 100644
index 9f785939e4..0000000000
--- a/schema/session-3.0.json
+++ /dev/null
@@ -1,81 +0,0 @@
-{
-    "$schema": "http://json-schema.org/draft-04/schema#",
-
-    "title": "openpype:session-3.0",
-    "description": "The Avalon environment",
-
-    "type": "object",
-
-    "additionalProperties": true,
-
-    "required": [
-        "AVALON_PROJECT",
-        "AVALON_ASSET"
-    ],
-
-    "properties": {
-        "AVALON_PROJECTS": {
-            "description": "Absolute path to root of project directories",
-            "type": "string",
-            "example": "/nas/projects"
-        },
-        "AVALON_PROJECT": {
-            "description": "Name of project",
-            "type": "string",
-            "pattern": "^\\w*$",
-            "example": "Hulk"
-        },
-        "AVALON_ASSET": {
-            "description": "Name of asset",
-            "type": "string",
-            "pattern": "^\\w*$",
-            "example": "Bruce"
-        },
-        "AVALON_TASK": {
-            "description": "Name of task",
-            "type": "string",
-            "pattern": "^\\w*$",
-            "example": "modeling"
-        },
-        "AVALON_APP": {
-            "description": "Name of host",
-            "type": "string",
-            "pattern": "^\\w*$",
-            "example": "maya2016"
-        },
-        "AVALON_DB": {
-            "description": "Name of database",
-            "type": "string",
-            "pattern": "^\\w*$",
-            "example": "avalon",
-            "default": "avalon"
-        },
-        "AVALON_LABEL": {
-            "description": "Nice name of Avalon, used in e.g. graphical user interfaces",
-            "type": "string",
-            "example": "Mindbender",
-            "default": "Avalon"
-        },
-        "AVALON_TIMEOUT": {
-            "description": "Wherever there is a need for a timeout, this is the default value.",
-            "type": "string",
-            "pattern": "^[0-9]*$",
-            "default": "1000",
-            "example": "1000"
-        },
-        "AVALON_INSTANCE_ID": {
-            "description": "Unique identifier for instances in a working file",
-            "type": "string",
-            "pattern": "^[\\w.]*$",
-            "default": "avalon.instance",
-            "example": "avalon.instance"
-        },
-        "AVALON_CONTAINER_ID": {
-            "description": "Unique identifier for a loaded representation in a working file",
-            "type": "string",
-            "pattern": "^[\\w.]*$",
-            "default": "avalon.container",
-            "example": "avalon.container"
-        }
-    }
-}
diff --git a/schema/shaders-1.0.json b/schema/shaders-1.0.json
deleted file mode 100644
index 7102ba1861..0000000000
--- a/schema/shaders-1.0.json
+++ /dev/null
@@ -1,32 +0,0 @@
-{
-    "$schema": "http://json-schema.org/draft-04/schema#",
-
-    "title": "openpype:shaders-1.0",
-    "description": "Relationships between shaders and Avalon IDs",
-
-    "type": "object",
-
-    "additionalProperties": true,
-
-    "required": [
-        "schema",
-        "shader"
-    ],
-
-    "properties": {
-        "schema": {
-            "description": "Schema identifier for payload",
-            "type": "string"
-        },
-        "shader": {
-            "description": "Name of directory",
-            "type": "array",
-            "items": {
-                "type": "str",
-                "description": "Avalon ID and optional face indexes, e.g. 'f9520572-ac1d-11e6-b39e-3085a99791c9.f[5002:5185]'"
-            }
-        }
-    },
-
-    "definitions": {}
-}
diff --git a/schema/subset-1.0.json b/schema/subset-1.0.json
deleted file mode 100644
index a299a6d341..0000000000
--- a/schema/subset-1.0.json
+++ /dev/null
@@ -1,35 +0,0 @@
-{
-    "$schema": "http://json-schema.org/draft-04/schema#",
-
-    "title": "openpype:subset-1.0",
-    "description": "A container of instances",
-
-    "type": "object",
-
-    "additionalProperties": true,
-
-    "required": [
-        "schema",
-        "name",
-        "versions"
-    ],
-
-    "properties": {
-        "schema": {
-            "description": "Schema identifier for payload",
-            "type": "string"
-        },
-        "name": {
-            "description": "Name of directory",
-            "type": "string"
-        },
-        "versions": {
-            "type": "array",
-            "items": {
-                "$ref": "version.json"
-            }
-        }
-    },
-
-    "definitions": {}
-}
diff --git a/schema/subset-2.0.json b/schema/subset-2.0.json
deleted file mode 100644
index db256ec7fb..0000000000
--- a/schema/subset-2.0.json
+++ /dev/null
@@ -1,51 +0,0 @@
-{
-    "$schema": "http://json-schema.org/draft-04/schema#",
-
-    "title": "openpype:subset-2.0",
-    "description": "A container of instances",
-
-    "type": "object",
-
-    "additionalProperties": true,
-
-    "required": [
-        "schema",
-        "type",
-        "parent",
-        "name",
-        "data"
-    ],
-
-    "properties": {
-        "schema": {
-            "description": "The schema associated with this document",
-            "type": "string",
-            "enum": ["openpype:subset-2.0"],
-            "example": "openpype:subset-2.0"
-        },
-        "type": {
-            "description": "The type of document",
-            "type": "string",
-            "enum": ["subset"],
-            "example": "subset"
-        },
-        "parent": {
-            "description": "Unique identifier to parent document",
-            "example": "592c33475f8c1b064c4d1696"
-        },
-        "name": {
-            "description": "Name of directory",
-            "type": "string",
-            "pattern": "^[a-zA-Z0-9_.]*$",
-            "example": "shot01"
-        },
-        "data": {
-            "type": "object",
-            "description": "Document metadata",
-            "example": {
-                "frameStart": 1000,
-                "frameEnd": 1201
-            }
-        }
-    }
-}
diff --git a/schema/subset-3.0.json b/schema/subset-3.0.json
deleted file mode 100644
index 1a0db53c04..0000000000
--- a/schema/subset-3.0.json
+++ /dev/null
@@ -1,62 +0,0 @@
-{
-    "$schema": "http://json-schema.org/draft-04/schema#",
-
-    "title": "openpype:subset-3.0",
-    "description": "A container of instances",
-
-    "type": "object",
-
-    "additionalProperties": true,
-
-    "required": [
-        "schema",
-        "type",
-        "parent",
-        "name",
-        "data"
-    ],
-
-    "properties": {
-        "schema": {
-            "description": "The schema associated with this document",
-            "type": "string",
-            "enum": ["openpype:subset-3.0"],
-            "example": "openpype:subset-3.0"
-        },
-        "type": {
-            "description": "The type of document",
-            "type": "string",
-            "enum": ["subset"],
-            "example": "subset"
-        },
-        "parent": {
-            "description": "Unique identifier to parent document",
-            "example": "592c33475f8c1b064c4d1696"
-        },
-        "name": {
-            "description": "Name of directory",
-            "type": "string",
-            "pattern": "^[a-zA-Z0-9_.]*$",
-            "example": "shot01"
-        },
-        "data": {
-            "description": "Document metadata",
-            "type": "object",
-            "required": ["families"],
-            "properties": {
-                "families": {
-                    "type": "array",
-                    "items": {"type": "string"},
-                    "description": "One or more families associated with this subset"
-                }
-            },
-            "example": {
-                "families" : [
-                    "avalon.camera"
-                ],
-                "frameStart": 1000,
-                "frameEnd": 1201
-            }
-        }
-    }
-}
diff --git a/schema/thumbnail-1.0.json b/schema/thumbnail-1.0.json
deleted file mode 100644
index 5bdf78a4b1..0000000000
--- a/schema/thumbnail-1.0.json
+++ /dev/null
@@ -1,42 +0,0 @@
-{
-    "$schema": "http://json-schema.org/draft-04/schema#",
-
-    "title": "openpype:thumbnail-1.0",
-    "description": "Entity with thumbnail data",
-
-    "type": "object",
-
-    "additionalProperties": true,
-
-    "required": [
-        "schema",
-        "type",
-        "data"
-    ],
-
-    "properties": {
-        "schema": {
-            "description": "The schema associated with this document",
-            "type": "string",
-            "enum": ["openpype:thumbnail-1.0"],
-            "example": "openpype:thumbnail-1.0"
-        },
-        "type": {
-            "description": "The type of document",
-            "type": "string",
-            "enum": ["thumbnail"],
-            "example": "thumbnail"
-        },
-        "data": {
-            "description": "Thumbnail data",
-            "type": "object",
-            "example": {
-                "binary_data": "Binary({byte data of image})",
-                "template": "{thumbnail_root}/{project[name]}/{_id}{ext}}",
-                "template_data": {
-                    "ext": ".jpg"
-                }
-            }
-        }
-    }
-}
diff --git a/schema/version-1.0.json b/schema/version-1.0.json
deleted file mode 100644
index daa1997721..0000000000
--- a/schema/version-1.0.json
+++ /dev/null
@@ -1,50 +0,0 @@
-{
-    "$schema": "http://json-schema.org/draft-04/schema#",
-
-    "title": "openpype:version-1.0",
-    "description": "An individual version",
-
-    "type": "object",
-
-    "additionalProperties": true,
-
-    "required": [
-        "schema",
-        "version",
-        "path",
-        "time",
-        "author",
-        "source",
-        "representations"
-    ],
-
-    "properties": {
-        "schema": {"type": "string"},
-        "representations": {
-            "type": "array",
-            "items": {
-                "$ref": "representation.json"
-            }
-        },
-        "time": {
-            "description": "ISO formatted, file-system compatible time",
-            "type": "string"
-        },
-        "author": {
-            "description": "User logged on to the machine at time of publish",
-            "type": "string"
-        },
-        "version": {
-            "description": "Number of this version",
-            "type": "number"
-        },
-        "path": {
-            "description": "Unformatted path, e.g. '{root}/assets/Bruce/publish/lookdevDefault/v001",
-            "type": "string"
-        },
-        "source": {
-            "description": "Original file from which this version was made.",
-            "type": "string"
-        }
-    }
-}
diff --git a/schema/version-2.0.json b/schema/version-2.0.json
deleted file mode 100644
index 099e9be70a..0000000000
--- a/schema/version-2.0.json
+++ /dev/null
@@ -1,92 +0,0 @@
-{
-    "$schema": "http://json-schema.org/draft-04/schema#",
-
-    "title": "openpype:version-2.0",
-    "description": "An individual version",
-
-    "type": "object",
-
-    "additionalProperties": true,
-
-    "required": [
-        "schema",
-        "type",
-        "parent",
-        "name",
-        "data"
-    ],
-
-    "properties": {
-        "schema": {
-            "description": "The schema associated with this document",
-            "type": "string",
-            "enum": ["openpype:version-2.0"],
-            "example": "openpype:version-2.0"
-        },
-        "type": {
-            "description": "The type of document",
-            "type": "string",
-            "enum": ["version"],
-            "example": "version"
-        },
-        "parent": {
-            "description": "Unique identifier to parent document",
-            "example": "592c33475f8c1b064c4d1696"
-        },
-        "name": {
-            "description": "Number of version",
-            "type": "number",
-            "example": 12
-        },
-        "locations": {
-            "description": "Where on the planet this version can be found.",
-            "type": "array",
-            "items": {"type": "string"},
-            "example": ["data.avalon.com"]
-        },
-        "data": {
-            "description": "Document metadata",
-            "type": "object",
-            "required": ["families", "author", "source", "time"],
-            "properties": {
-                "time": {
-                    "description": "ISO formatted, file-system compatible time",
-                    "type": "string"
-                },
-                "timeFormat": {
-                    "description": "ISO format of time",
-                    "type": "string"
-                },
-                "author": {
-                    "description": "User logged on to the machine at time of publish",
-                    "type": "string"
-                },
-                "version": {
-                    "description": "Number of this version",
-                    "type": "number"
-                },
-                "path": {
-                    "description": "Unformatted path, e.g. '{root}/assets/Bruce/publish/lookdevDefault/v001",
-                    "type": "string"
-                },
-                "source": {
-                    "description": "Original file from which this version was made.",
-                    "type": "string"
-                },
-                "families": {
-                    "type": "array",
-                    "items": {"type": "string"},
-                    "description": "One or more families associated with this version"
-                }
-            },
-            "example": {
-                "source" : "{root}/f02_prod/assets/BubbleWitch/work/modeling/marcus/maya/scenes/model_v001.ma",
-                "author" : "marcus",
-                "families" : [
-                    "avalon.model"
-                ],
-                "time" : "20170510T090203Z"
-            }
-        }
-    }
-}
diff --git a/schema/version-3.0.json b/schema/version-3.0.json
deleted file mode 100644
index 3e07fc4499..0000000000
--- a/schema/version-3.0.json
+++ /dev/null
@@ -1,84 +0,0 @@
-{
-    "$schema": "http://json-schema.org/draft-04/schema#",
-
-    "title": "openpype:version-3.0",
-    "description": "An individual version",
-
-    "type": "object",
-
-    "additionalProperties": true,
-
-    "required": [
-        "schema",
-        "type",
-        "parent",
-        "name",
-        "data"
-    ],
-
-    "properties": {
-        "schema": {
-            "description": "The schema associated with this document",
-            "type": "string",
-            "enum": ["openpype:version-3.0"],
-            "example": "openpype:version-3.0"
-        },
-        "type": {
-            "description": "The type of document",
-            "type": "string",
-            "enum": ["version"],
-            "example": "version"
-        },
-        "parent": {
-            "description": "Unique identifier to parent document",
-            "example": "592c33475f8c1b064c4d1696"
-        },
-        "name": {
-            "description": "Number of version",
-            "type": "number",
-            "example": 12
-        },
-        "locations": {
-            "description": "Where on the planet this version can be found.",
-            "type": "array",
-            "items": {"type": "string"},
-            "example": ["data.avalon.com"]
-        },
-        "data": {
-            "description": "Document metadata",
-            "type": "object",
-            "required": ["author", "source", "time"],
-            "properties": {
-                "time": {
-                    "description": "ISO formatted, file-system compatible time",
-                    "type": "string"
-                },
-                "timeFormat": {
-                    "description": "ISO format of time",
-                    "type": "string"
-                },
-                "author": {
-                    "description": "User logged on to the machine at time of publish",
-                    "type": "string"
-                },
-                "version": {
-                    "description": "Number of this version",
-                    "type": "number"
-                },
-                "path": {
-                    "description": "Unformatted path, e.g. '{root}/assets/Bruce/publish/lookdevDefault/v001",
-                    "type": "string"
-                },
-                "source": {
-                    "description": "Original file from which this version was made.",
-                    "type": "string"
-                }
-            },
-            "example": {
-                "source" : "{root}/f02_prod/assets/BubbleWitch/work/modeling/marcus/maya/scenes/model_v001.ma",
-                "author" : "marcus",
-                "time" : "20170510T090203Z"
-            }
-        }
-    }
-}
diff --git a/schema/workfile-1.0.json b/schema/workfile-1.0.json
deleted file mode 100644
index 5f9600ef20..0000000000
--- a/schema/workfile-1.0.json
+++ /dev/null
@@ -1,52 +0,0 @@
-{
-    "$schema": "http://json-schema.org/draft-04/schema#",
-
-    "title": "openpype:workfile-1.0",
-    "description": "Workfile additional information.",
-
-    "type": "object",
-
-    "additionalProperties": true,
-
-    "required": [
-        "schema",
-        "type",
-        "filename",
-        "task_name",
-        "parent"
-    ],
-
-    "properties": {
-        "schema": {
-            "description": "Schema identifier for payload",
-            "type": "string",
-            "enum": ["openpype:workfile-1.0"],
-            "example": "openpype:workfile-1.0"
-        },
-        "type": {
-            "description": "The type of document",
-            "type": "string",
-            "enum": ["workfile"],
-            "example": "workfile"
-        },
-        "parent": {
-            "description": "Unique identifier to parent document",
-            "example": "592c33475f8c1b064c4d1696"
-        },
-        "filename": {
-            "description": "Workfile's filename",
-            "type": "string",
-            "example": "kuba_each_case_Alpaca_01_animation_v001.ma"
-        },
-        "task_name": {
-            "description": "Task name",
-            "type": "string",
-            "example": "animation"
-        },
-        "data": {
-            "description": "Document metadata",
-            "type": "object",
-            "example": {"key": "value"}
-        }
-    }
-}
diff --git a/setup.py b/setup.py
index 4b6f286730..6179de1d34 100644
--- a/setup.py
+++ b/setup.py
@@ -124,7 +124,6 @@ bin_includes = [
 include_files = [
     "igniter",
     "openpype",
-    "schema",
     "LICENSE",
     "README.md"
 ]

From 975d09d66868d76dad1eb356539389700eb35c99 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Wed, 30 Aug 2023 14:29:16 +0200
Subject: [PATCH 273/366] lower urllib3 to support older OpenSSL than 1.1.1

---
 poetry.lock    | 15 +++++++--------
 pyproject.toml |  1 +
 2 files changed, 8 insertions(+), 8 deletions(-)

diff --git a/poetry.lock b/poetry.lock
index 5621d39988..5e88f5b93c 100644
--- a/poetry.lock
+++ b/poetry.lock
@@ -3372,21 +3372,20 @@ files = [
 
 [[package]]
 name = "urllib3"
-version = "2.0.2"
+version = "1.26.16"
 description = "HTTP library with thread-safe connection pooling, file post, and more."
 category = "main"
 optional = false
-python-versions = ">=3.7"
+python-versions = ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*, !=3.5.*"
 files = [
-    {file = "urllib3-2.0.2-py3-none-any.whl", hash = "sha256:d055c2f9d38dc53c808f6fdc8eab7360b6fdbbde02340ed25cfbcd817c62469e"},
-    {file = "urllib3-2.0.2.tar.gz", hash = "sha256:61717a1095d7e155cdb737ac7bb2f4324a858a1e2e6466f6d03ff630ca68d3cc"},
+    {file = "urllib3-1.26.16-py2.py3-none-any.whl", hash = "sha256:8d36afa7616d8ab714608411b4a3b13e58f463aee519024578e062e141dce20f"},
+    {file = "urllib3-1.26.16.tar.gz", hash = "sha256:8f135f6502756bde6b2a9b28989df5fbe87c9970cecaa69041edcce7f0589b14"},
 ]
 
 [package.extras]
-brotli = ["brotli (>=1.0.9)", "brotlicffi (>=0.8.0)"]
-secure = ["certifi", "cryptography (>=1.9)", "idna (>=2.0.0)", "pyopenssl (>=17.1.0)", "urllib3-secure-extra"]
-socks = ["pysocks (>=1.5.6,!=1.5.7,<2.0)"]
-zstd = ["zstandard (>=0.18.0)"]
+brotli = ["brotli (>=1.0.9)", "brotlicffi (>=0.8.0)", "brotlipy (>=0.6.0)"]
+secure = ["certifi", "cryptography (>=1.3.4)", "idna (>=2.0.0)", "ipaddress", "pyOpenSSL (>=0.14)", "urllib3-secure-extra"]
+socks = ["PySocks (>=1.5.6,!=1.5.7,<2.0)"]
 
 [[package]]
 name = "virtualenv"
diff --git a/pyproject.toml b/pyproject.toml
index b394a895e3..e2d35f3c6d 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -56,6 +56,7 @@ QtPy = "^2.3.0"
 qtawesome = "0.7.3"
 speedcopy = "^2.1"
 six = "^1.15"
+urllib3 = "1.26.16"
 semver = "^2.13.0" # for version resolution
 wsrpc_aiohttp = "^3.1.1" # websocket server
 pywin32 = { version = "301", markers = "sys_platform == 'win32'" }

From b1796d6603c3ff74aaf9798e14f9b4e08e0c9c3a Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Mon, 4 Sep 2023 11:19:33 +0200
Subject: [PATCH 274/366] do not add schema to zip files

---
 igniter/bootstrap_repos.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/igniter/bootstrap_repos.py b/igniter/bootstrap_repos.py
index 408764e1a8..e7b440f812 100644
--- a/igniter/bootstrap_repos.py
+++ b/igniter/bootstrap_repos.py
@@ -589,7 +589,7 @@ class BootstrapRepos:
         self.registry = OpenPypeSettingsRegistry()
         self.zip_filter = [".pyc", "__pycache__"]
         self.openpype_filter = [
-            "openpype", "schema", "LICENSE"
+            "openpype", "LICENSE"
         ]
 
         # dummy progress reporter

From b4aa3b15dfbac86834fdf6dad796672634802363 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <jakub.trllo@gmail.com>
Date: Fri, 1 Sep 2023 17:31:44 +0200
Subject: [PATCH 275/366] do not override scale factor rounding policy if has
 defined value through env variable

---
 igniter/__init__.py | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/igniter/__init__.py b/igniter/__init__.py
index 16ffb940f6..085a825860 100644
--- a/igniter/__init__.py
+++ b/igniter/__init__.py
@@ -34,7 +34,11 @@ def _get_qt_app():
         if attr is not None:
             QtWidgets.QApplication.setAttribute(attr)
 
-    if hasattr(QtWidgets.QApplication, "setHighDpiScaleFactorRoundingPolicy"):
+    policy = os.getenv("QT_SCALE_FACTOR_ROUNDING_POLICY")
+    if (
+        hasattr(QtWidgets.QApplication, "setHighDpiScaleFactorRoundingPolicy")
+        and not policy
+    ):
         QtWidgets.QApplication.setHighDpiScaleFactorRoundingPolicy(
             QtCore.Qt.HighDpiScaleFactorRoundingPolicy.PassThrough
         )

From 3e9528b5e06e9de103f0b71f1ab1d063635083e3 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Tue, 25 Jul 2023 23:41:32 +0000
Subject: [PATCH 276/366] Bump certifi from 2023.5.7 to 2023.7.22

Bumps [certifi](https://github.com/certifi/python-certifi) from 2023.5.7 to 2023.7.22.
- [Commits](https://github.com/certifi/python-certifi/compare/2023.05.07...2023.07.22)

---
updated-dependencies:
- dependency-name: certifi
  dependency-type: indirect
...

Signed-off-by: dependabot[bot] <support@github.com>
---
 poetry.lock | 178 ++--------------------------------------------------
 1 file changed, 6 insertions(+), 172 deletions(-)

diff --git a/poetry.lock b/poetry.lock
index 5e88f5b93c..2b9fab4bc4 100644
--- a/poetry.lock
+++ b/poetry.lock
@@ -1,10 +1,9 @@
-# This file is automatically @generated by Poetry and should not be changed by hand.
+# This file is automatically @generated by Poetry 1.5.1 and should not be changed by hand.
 
 [[package]]
 name = "acre"
 version = "1.0.0"
 description = "Lightweight cross-platform environment management Python package that makes it trivial to launch applications in their own configurable working environment."
-category = "main"
 optional = false
 python-versions = ">=2.7"
 files = []
@@ -20,7 +19,6 @@ resolved_reference = "126f7a188cfe36718f707f42ebbc597e86aa86c3"
 name = "aiohttp"
 version = "3.8.4"
 description = "Async http client/server framework (asyncio)"
-category = "main"
 optional = false
 python-versions = ">=3.6"
 files = [
@@ -129,7 +127,6 @@ speedups = ["Brotli", "aiodns", "cchardet"]
 name = "aiohttp-json-rpc"
 version = "0.13.3"
 description = "Implementation JSON-RPC 2.0 server and client using aiohttp on top of websockets transport"
-category = "main"
 optional = false
 python-versions = ">=3.5"
 files = [
@@ -144,7 +141,6 @@ aiohttp = ">=3,<4"
 name = "aiohttp-middlewares"
 version = "2.2.0"
 description = "Collection of useful middlewares for aiohttp applications."
-category = "main"
 optional = false
 python-versions = ">=3.7,<4.0"
 files = [
@@ -161,7 +157,6 @@ yarl = ">=1.5.1,<2.0.0"
 name = "aiosignal"
 version = "1.3.1"
 description = "aiosignal: a list of registered asynchronous callbacks"
-category = "main"
 optional = false
 python-versions = ">=3.7"
 files = [
@@ -176,7 +171,6 @@ frozenlist = ">=1.1.0"
 name = "alabaster"
 version = "0.7.13"
 description = "A configurable sidebar-enabled Sphinx theme"
-category = "dev"
 optional = false
 python-versions = ">=3.6"
 files = [
@@ -188,7 +182,6 @@ files = [
 name = "ansicon"
 version = "1.89.0"
 description = "Python wrapper for loading Jason Hood's ANSICON"
-category = "main"
 optional = false
 python-versions = "*"
 files = [
@@ -200,7 +193,6 @@ files = [
 name = "appdirs"
 version = "1.4.4"
 description = "A small Python module for determining appropriate platform-specific dirs, e.g. a \"user data dir\"."
-category = "main"
 optional = false
 python-versions = ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*"
 files = []
@@ -216,7 +208,6 @@ resolved_reference = "8734277956c1df3b85385e6b308e954910533884"
 name = "arrow"
 version = "0.17.0"
 description = "Better dates & times for Python"
-category = "main"
 optional = false
 python-versions = ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*"
 files = [
@@ -231,7 +222,6 @@ python-dateutil = ">=2.7.0"
 name = "astroid"
 version = "2.15.5"
 description = "An abstract syntax tree for Python with inference support."
-category = "dev"
 optional = false
 python-versions = ">=3.7.2"
 files = [
@@ -248,7 +238,6 @@ wrapt = {version = ">=1.11,<2", markers = "python_version < \"3.11\""}
 name = "async-timeout"
 version = "4.0.2"
 description = "Timeout context manager for asyncio programs"
-category = "main"
 optional = false
 python-versions = ">=3.6"
 files = [
@@ -260,7 +249,6 @@ files = [
 name = "atomicwrites"
 version = "1.4.1"
 description = "Atomic file writes."
-category = "dev"
 optional = false
 python-versions = ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*"
 files = [
@@ -271,7 +259,6 @@ files = [
 name = "attrs"
 version = "23.1.0"
 description = "Classes Without Boilerplate"
-category = "main"
 optional = false
 python-versions = ">=3.7"
 files = [
@@ -290,7 +277,6 @@ tests-no-zope = ["cloudpickle", "hypothesis", "mypy (>=1.1.1)", "pympler", "pyte
 name = "autopep8"
 version = "2.0.2"
 description = "A tool that automatically formats Python code to conform to the PEP 8 style guide"
-category = "dev"
 optional = false
 python-versions = ">=3.6"
 files = [
@@ -306,7 +292,6 @@ tomli = {version = "*", markers = "python_version < \"3.11\""}
 name = "babel"
 version = "2.12.1"
 description = "Internationalization utilities"
-category = "dev"
 optional = false
 python-versions = ">=3.7"
 files = [
@@ -318,7 +303,6 @@ files = [
 name = "bcrypt"
 version = "4.0.1"
 description = "Modern password hashing for your software and your servers"
-category = "main"
 optional = false
 python-versions = ">=3.6"
 files = [
@@ -353,7 +337,6 @@ typecheck = ["mypy"]
 name = "bidict"
 version = "0.22.1"
 description = "The bidirectional mapping library for Python."
-category = "main"
 optional = false
 python-versions = ">=3.7"
 files = [
@@ -370,7 +353,6 @@ test = ["hypothesis", "pytest", "pytest-benchmark[histogram]", "pytest-cov", "py
 name = "blessed"
 version = "1.20.0"
 description = "Easy, practical library for making terminal apps, by providing an elegant, well-documented interface to Colors, Keyboard input, and screen Positioning capabilities."
-category = "main"
 optional = false
 python-versions = ">=2.7"
 files = [
@@ -387,7 +369,6 @@ wcwidth = ">=0.1.4"
 name = "cachetools"
 version = "5.3.1"
 description = "Extensible memoizing collections and decorators"
-category = "main"
 optional = false
 python-versions = ">=3.7"
 files = [
@@ -397,21 +378,19 @@ files = [
 
 [[package]]
 name = "certifi"
-version = "2023.5.7"
+version = "2023.7.22"
 description = "Python package for providing Mozilla's CA Bundle."
-category = "main"
 optional = false
 python-versions = ">=3.6"
 files = [
-    {file = "certifi-2023.5.7-py3-none-any.whl", hash = "sha256:c6c2e98f5c7869efca1f8916fed228dd91539f9f1b444c314c06eef02980c716"},
-    {file = "certifi-2023.5.7.tar.gz", hash = "sha256:0f0d56dc5a6ad56fd4ba36484d6cc34451e1c6548c61daad8c320169f91eddc7"},
+    {file = "certifi-2023.7.22-py3-none-any.whl", hash = "sha256:92d6037539857d8206b8f6ae472e8b77db8058fec5937a1ef3f54304089edbb9"},
+    {file = "certifi-2023.7.22.tar.gz", hash = "sha256:539cc1d13202e33ca466e88b2807e29f4c13049d6d87031a3c110744495cb082"},
 ]
 
 [[package]]
 name = "cffi"
 version = "1.15.1"
 description = "Foreign Function Interface for Python calling C code."
-category = "main"
 optional = false
 python-versions = "*"
 files = [
@@ -488,7 +467,6 @@ pycparser = "*"
 name = "cfgv"
 version = "3.3.1"
 description = "Validate configuration and produce human readable error messages."
-category = "dev"
 optional = false
 python-versions = ">=3.6.1"
 files = [
@@ -500,7 +478,6 @@ files = [
 name = "charset-normalizer"
 version = "3.1.0"
 description = "The Real First Universal Charset Detector. Open, modern and actively maintained alternative to Chardet."
-category = "main"
 optional = false
 python-versions = ">=3.7.0"
 files = [
@@ -585,7 +562,6 @@ files = [
 name = "click"
 version = "8.1.3"
 description = "Composable command line interface toolkit"
-category = "main"
 optional = false
 python-versions = ">=3.7"
 files = [
@@ -600,7 +576,6 @@ colorama = {version = "*", markers = "platform_system == \"Windows\""}
 name = "clique"
 version = "1.6.1"
 description = "Manage collections with common numerical component"
-category = "main"
 optional = false
 python-versions = ">=2.7, <4.0"
 files = [
@@ -617,7 +592,6 @@ test = ["pytest (>=2.3.5,<5)", "pytest-cov (>=2,<3)", "pytest-runner (>=2.7,<3)"
 name = "colorama"
 version = "0.4.6"
 description = "Cross-platform colored terminal text."
-category = "main"
 optional = false
 python-versions = "!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*,!=3.4.*,!=3.5.*,!=3.6.*,>=2.7"
 files = [
@@ -629,7 +603,6 @@ files = [
 name = "commonmark"
 version = "0.9.1"
 description = "Python parser for the CommonMark Markdown spec"
-category = "dev"
 optional = false
 python-versions = "*"
 files = [
@@ -644,7 +617,6 @@ test = ["flake8 (==3.7.8)", "hypothesis (==3.55.3)"]
 name = "coolname"
 version = "2.2.0"
 description = "Random name and slug generator"
-category = "main"
 optional = false
 python-versions = "*"
 files = [
@@ -656,7 +628,6 @@ files = [
 name = "coverage"
 version = "7.2.7"
 description = "Code coverage measurement for Python"
-category = "dev"
 optional = false
 python-versions = ">=3.7"
 files = [
@@ -732,7 +703,6 @@ toml = ["tomli"]
 name = "cryptography"
 version = "39.0.0"
 description = "cryptography is a package which provides cryptographic recipes and primitives to Python developers."
-category = "main"
 optional = false
 python-versions = ">=3.6"
 files = [
@@ -776,7 +746,6 @@ test = ["hypothesis (>=1.11.4,!=3.79.2)", "iso8601", "pretend", "pytest (>=6.2.0
 name = "cx-freeze"
 version = "6.12.0"
 description = "Create standalone executables from Python scripts"
-category = "dev"
 optional = false
 python-versions = ">=3.6"
 files = [
@@ -834,7 +803,6 @@ test = ["nose (==1.3.7)", "pygments (>=2.11.2)", "pytest (>=7.0.1)", "pytest-cov
 name = "cx-logging"
 version = "3.1.0"
 description = "Python and C interfaces for logging"
-category = "dev"
 optional = false
 python-versions = ">=3.7"
 files = [
@@ -865,7 +833,6 @@ files = [
 name = "dill"
 version = "0.3.6"
 description = "serialize all of python"
-category = "dev"
 optional = false
 python-versions = ">=3.7"
 files = [
@@ -880,7 +847,6 @@ graph = ["objgraph (>=1.7.2)"]
 name = "distlib"
 version = "0.3.6"
 description = "Distribution utilities"
-category = "dev"
 optional = false
 python-versions = "*"
 files = [
@@ -892,7 +858,6 @@ files = [
 name = "dnspython"
 version = "2.3.0"
 description = "DNS toolkit"
-category = "main"
 optional = false
 python-versions = ">=3.7,<4.0"
 files = [
@@ -913,7 +878,6 @@ wmi = ["wmi (>=1.5.1,<2.0.0)"]
 name = "docutils"
 version = "0.19"
 description = "Docutils -- Python Documentation Utilities"
-category = "dev"
 optional = false
 python-versions = ">=3.7"
 files = [
@@ -925,7 +889,6 @@ files = [
 name = "dropbox"
 version = "11.36.0"
 description = "Official Dropbox API Client"
-category = "main"
 optional = false
 python-versions = "*"
 files = [
@@ -943,7 +906,6 @@ stone = ">=2"
 name = "enlighten"
 version = "1.11.2"
 description = "Enlighten Progress Bar"
-category = "main"
 optional = false
 python-versions = "*"
 files = [
@@ -959,7 +921,6 @@ prefixed = ">=0.3.2"
 name = "evdev"
 version = "1.6.1"
 description = "Bindings to the Linux input handling subsystem"
-category = "main"
 optional = false
 python-versions = "*"
 files = [
@@ -970,7 +931,6 @@ files = [
 name = "filelock"
 version = "3.12.0"
 description = "A platform independent file lock."
-category = "dev"
 optional = false
 python-versions = ">=3.7"
 files = [
@@ -986,7 +946,6 @@ testing = ["covdefaults (>=2.3)", "coverage (>=7.2.3)", "diff-cover (>=7.5)", "p
 name = "flake8"
 version = "6.0.0"
 description = "the modular source code checker: pep8 pyflakes and co"
-category = "dev"
 optional = false
 python-versions = ">=3.8.1"
 files = [
@@ -1003,7 +962,6 @@ pyflakes = ">=3.0.0,<3.1.0"
 name = "frozenlist"
 version = "1.3.3"
 description = "A list-like structure which implements collections.abc.MutableSequence"
-category = "main"
 optional = false
 python-versions = ">=3.7"
 files = [
@@ -1087,7 +1045,6 @@ files = [
 name = "ftrack-python-api"
 version = "2.5.0"
 description = "Python API for ftrack."
-category = "main"
 optional = false
 python-versions = ">=2.7.9, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*, !=3.5.*"
 files = [
@@ -1110,7 +1067,6 @@ websocket-client = ">=0.40.0,<1"
 name = "future"
 version = "0.18.3"
 description = "Clean single-source support for Python 3 and 2"
-category = "main"
 optional = false
 python-versions = ">=2.6, !=3.0.*, !=3.1.*, !=3.2.*"
 files = [
@@ -1121,7 +1077,6 @@ files = [
 name = "gazu"
 version = "0.9.3"
 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.*, != 3.5.*, != 3.6.1, != 3.6.2"
 files = [
@@ -1141,7 +1096,6 @@ test = ["pytest", "pytest-cov", "requests-mock"]
 name = "gitdb"
 version = "4.0.10"
 description = "Git Object Database"
-category = "dev"
 optional = false
 python-versions = ">=3.7"
 files = [
@@ -1156,7 +1110,6 @@ smmap = ">=3.0.1,<6"
 name = "gitpython"
 version = "3.1.31"
 description = "GitPython is a Python library used to interact with Git repositories"
-category = "dev"
 optional = false
 python-versions = ">=3.7"
 files = [
@@ -1171,7 +1124,6 @@ gitdb = ">=4.0.1,<5"
 name = "google-api-core"
 version = "2.11.0"
 description = "Google API client core library"
-category = "main"
 optional = false
 python-versions = ">=3.7"
 files = [
@@ -1194,7 +1146,6 @@ grpcio-gcp = ["grpcio-gcp (>=0.2.2,<1.0dev)"]
 name = "google-api-python-client"
 version = "1.12.11"
 description = "Google API Client Library for Python"
-category = "main"
 optional = false
 python-versions = ">=2.7,!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*"
 files = [
@@ -1214,7 +1165,6 @@ uritemplate = ">=3.0.0,<4dev"
 name = "google-auth"
 version = "2.17.3"
 description = "Google Authentication Library"
-category = "main"
 optional = false
 python-versions = ">=2.7,!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*,!=3.4.*,!=3.5.*"
 files = [
@@ -1239,7 +1189,6 @@ requests = ["requests (>=2.20.0,<3.0.0dev)"]
 name = "google-auth-httplib2"
 version = "0.1.0"
 description = "Google Authentication Library: httplib2 transport"
-category = "main"
 optional = false
 python-versions = "*"
 files = [
@@ -1256,7 +1205,6 @@ six = "*"
 name = "googleapis-common-protos"
 version = "1.59.0"
 description = "Common protobufs used in Google APIs"
-category = "main"
 optional = false
 python-versions = ">=3.7"
 files = [
@@ -1274,7 +1222,6 @@ grpc = ["grpcio (>=1.44.0,<2.0.0dev)"]
 name = "httplib2"
 version = "0.22.0"
 description = "A comprehensive HTTP client library."
-category = "main"
 optional = false
 python-versions = ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*"
 files = [
@@ -1289,7 +1236,6 @@ pyparsing = {version = ">=2.4.2,<3.0.0 || >3.0.0,<3.0.1 || >3.0.1,<3.0.2 || >3.0
 name = "identify"
 version = "2.5.24"
 description = "File identification library for Python"
-category = "dev"
 optional = false
 python-versions = ">=3.7"
 files = [
@@ -1304,7 +1250,6 @@ license = ["ukkonen"]
 name = "idna"
 version = "3.4"
 description = "Internationalized Domain Names in Applications (IDNA)"
-category = "main"
 optional = false
 python-versions = ">=3.5"
 files = [
@@ -1316,7 +1261,6 @@ files = [
 name = "imagesize"
 version = "1.4.1"
 description = "Getting image size from png/jpeg/jpeg2000/gif file"
-category = "dev"
 optional = false
 python-versions = ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*"
 files = [
@@ -1328,7 +1272,6 @@ files = [
 name = "importlib-metadata"
 version = "6.6.0"
 description = "Read metadata from Python packages"
-category = "main"
 optional = false
 python-versions = ">=3.7"
 files = [
@@ -1348,7 +1291,6 @@ testing = ["flake8 (<5)", "flufl.flake8", "importlib-resources (>=1.3)", "packag
 name = "iniconfig"
 version = "2.0.0"
 description = "brain-dead simple config-ini parsing"
-category = "dev"
 optional = false
 python-versions = ">=3.7"
 files = [
@@ -1360,7 +1302,6 @@ files = [
 name = "isort"
 version = "5.12.0"
 description = "A Python utility / library to sort Python imports."
-category = "dev"
 optional = false
 python-versions = ">=3.8.0"
 files = [
@@ -1378,7 +1319,6 @@ requirements-deprecated-finder = ["pip-api", "pipreqs"]
 name = "jedi"
 version = "0.13.3"
 description = "An autocompletion tool for Python that can be used for text editors."
-category = "dev"
 optional = false
 python-versions = ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*"
 files = [
@@ -1396,7 +1336,6 @@ testing = ["colorama", "docopt", "pytest (>=3.1.0)"]
 name = "jeepney"
 version = "0.8.0"
 description = "Low-level, pure Python DBus protocol wrapper."
-category = "main"
 optional = false
 python-versions = ">=3.7"
 files = [
@@ -1412,7 +1351,6 @@ trio = ["async_generator", "trio"]
 name = "jinja2"
 version = "3.1.2"
 description = "A very fast and expressive template engine."
-category = "dev"
 optional = false
 python-versions = ">=3.7"
 files = [
@@ -1430,7 +1368,6 @@ i18n = ["Babel (>=2.7)"]
 name = "jinxed"
 version = "1.2.0"
 description = "Jinxed Terminal Library"
-category = "main"
 optional = false
 python-versions = "*"
 files = [
@@ -1445,7 +1382,6 @@ ansicon = {version = "*", markers = "platform_system == \"Windows\""}
 name = "jsonschema"
 version = "2.6.0"
 description = "An implementation of JSON Schema validation for Python"
-category = "main"
 optional = false
 python-versions = "*"
 files = [
@@ -1460,7 +1396,6 @@ format = ["rfc3987", "strict-rfc3339", "webcolors"]
 name = "keyring"
 version = "22.4.0"
 description = "Store and access your passwords safely."
-category = "main"
 optional = false
 python-versions = ">=3.6"
 files = [
@@ -1482,7 +1417,6 @@ testing = ["pytest (>=4.6)", "pytest-black (>=0.3.7)", "pytest-checkdocs (>=1.2.
 name = "lazy-object-proxy"
 version = "1.9.0"
 description = "A fast and thorough lazy object proxy."
-category = "dev"
 optional = false
 python-versions = ">=3.7"
 files = [
@@ -1528,7 +1462,6 @@ files = [
 name = "lief"
 version = "0.13.1"
 description = "Library to instrument executable formats"
-category = "dev"
 optional = false
 python-versions = ">=3.8"
 files = [
@@ -1561,7 +1494,6 @@ files = [
 name = "linkify-it-py"
 version = "2.0.2"
 description = "Links recognition library with FULL unicode support."
-category = "dev"
 optional = false
 python-versions = ">=3.7"
 files = [
@@ -1582,7 +1514,6 @@ test = ["coverage", "pytest", "pytest-cov"]
 name = "log4mongo"
 version = "1.7.0"
 description = "mongo database handler for python logging"
-category = "main"
 optional = false
 python-versions = "*"
 files = [
@@ -1596,7 +1527,6 @@ pymongo = "*"
 name = "m2r2"
 version = "0.3.3.post2"
 description = "Markdown and reStructuredText in a single file."
-category = "dev"
 optional = false
 python-versions = ">=3.7"
 files = [
@@ -1612,7 +1542,6 @@ mistune = "0.8.4"
 name = "markdown-it-py"
 version = "2.2.0"
 description = "Python port of markdown-it. Markdown parsing, done right!"
-category = "dev"
 optional = false
 python-versions = ">=3.7"
 files = [
@@ -1637,7 +1566,6 @@ testing = ["coverage", "pytest", "pytest-cov", "pytest-regressions"]
 name = "markupsafe"
 version = "2.0.1"
 description = "Safely add untrusted strings to HTML/XML markup."
-category = "dev"
 optional = false
 python-versions = ">=3.6"
 files = [
@@ -1716,7 +1644,6 @@ files = [
 name = "mccabe"
 version = "0.7.0"
 description = "McCabe checker, plugin for flake8"
-category = "dev"
 optional = false
 python-versions = ">=3.6"
 files = [
@@ -1728,7 +1655,6 @@ files = [
 name = "mdit-py-plugins"
 version = "0.3.5"
 description = "Collection of plugins for markdown-it-py"
-category = "dev"
 optional = false
 python-versions = ">=3.7"
 files = [
@@ -1748,7 +1674,6 @@ testing = ["coverage", "pytest", "pytest-cov", "pytest-regressions"]
 name = "mdurl"
 version = "0.1.2"
 description = "Markdown URL utilities"
-category = "dev"
 optional = false
 python-versions = ">=3.7"
 files = [
@@ -1760,7 +1685,6 @@ files = [
 name = "mistune"
 version = "0.8.4"
 description = "The fastest markdown parser in pure Python"
-category = "dev"
 optional = false
 python-versions = "*"
 files = [
@@ -1772,7 +1696,6 @@ files = [
 name = "multidict"
 version = "6.0.4"
 description = "multidict implementation"
-category = "main"
 optional = false
 python-versions = ">=3.7"
 files = [
@@ -1856,7 +1779,6 @@ files = [
 name = "myst-parser"
 version = "0.18.1"
 description = "An extended commonmark compliant parser, with bridges to docutils & sphinx."
-category = "dev"
 optional = false
 python-versions = ">=3.7"
 files = [
@@ -1883,7 +1805,6 @@ testing = ["beautifulsoup4", "coverage[toml]", "pytest (>=6,<7)", "pytest-cov",
 name = "nodeenv"
 version = "1.8.0"
 description = "Node.js virtual environment builder"
-category = "dev"
 optional = false
 python-versions = ">=2.7,!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*,!=3.4.*,!=3.5.*,!=3.6.*"
 files = [
@@ -1898,7 +1819,6 @@ setuptools = "*"
 name = "packaging"
 version = "23.1"
 description = "Core utilities for Python packages"
-category = "main"
 optional = false
 python-versions = ">=3.7"
 files = [
@@ -1910,7 +1830,6 @@ files = [
 name = "paramiko"
 version = "3.2.0"
 description = "SSH2 protocol library"
-category = "main"
 optional = false
 python-versions = ">=3.6"
 files = [
@@ -1932,7 +1851,6 @@ invoke = ["invoke (>=2.0)"]
 name = "parso"
 version = "0.8.3"
 description = "A Python Parser"
-category = "dev"
 optional = false
 python-versions = ">=3.6"
 files = [
@@ -1948,7 +1866,6 @@ testing = ["docopt", "pytest (<6.0.0)"]
 name = "patchelf"
 version = "0.17.2.1"
 description = "A small utility to modify the dynamic linker and RPATH of ELF executables."
-category = "dev"
 optional = false
 python-versions = "*"
 files = [
@@ -1968,7 +1885,6 @@ test = ["importlib-metadata", "pytest"]
 name = "pathlib2"
 version = "2.3.7.post1"
 description = "Object-oriented filesystem paths"
-category = "main"
 optional = false
 python-versions = "*"
 files = [
@@ -1983,7 +1899,6 @@ six = "*"
 name = "pillow"
 version = "9.5.0"
 description = "Python Imaging Library (Fork)"
-category = "main"
 optional = false
 python-versions = ">=3.7"
 files = [
@@ -2063,7 +1978,6 @@ tests = ["check-manifest", "coverage", "defusedxml", "markdown2", "olefile", "pa
 name = "platformdirs"
 version = "3.5.1"
 description = "A small Python package for determining appropriate platform-specific dirs, e.g. a \"user data dir\"."
-category = "dev"
 optional = false
 python-versions = ">=3.7"
 files = [
@@ -2079,7 +1993,6 @@ test = ["appdirs (==1.4.4)", "covdefaults (>=2.3)", "pytest (>=7.3.1)", "pytest-
 name = "pluggy"
 version = "1.0.0"
 description = "plugin and hook calling mechanisms for python"
-category = "dev"
 optional = false
 python-versions = ">=3.6"
 files = [
@@ -2095,7 +2008,6 @@ testing = ["pytest", "pytest-benchmark"]
 name = "ply"
 version = "3.11"
 description = "Python Lex & Yacc"
-category = "main"
 optional = false
 python-versions = "*"
 files = [
@@ -2107,7 +2019,6 @@ files = [
 name = "pockets"
 version = "0.9.1"
 description = "A collection of helpful Python tools!"
-category = "dev"
 optional = false
 python-versions = "*"
 files = [
@@ -2122,7 +2033,6 @@ six = ">=1.5.2"
 name = "pre-commit"
 version = "3.3.2"
 description = "A framework for managing and maintaining multi-language pre-commit hooks."
-category = "dev"
 optional = false
 python-versions = ">=3.8"
 files = [
@@ -2141,7 +2051,6 @@ virtualenv = ">=20.10.0"
 name = "prefixed"
 version = "0.7.0"
 description = "Prefixed alternative numeric library"
-category = "main"
 optional = false
 python-versions = "*"
 files = [
@@ -2153,7 +2062,6 @@ files = [
 name = "protobuf"
 version = "4.23.2"
 description = ""
-category = "main"
 optional = false
 python-versions = ">=3.7"
 files = [
@@ -2176,7 +2084,6 @@ files = [
 name = "py"
 version = "1.11.0"
 description = "library with cross-python path, ini-parsing, io, code, log facilities"
-category = "dev"
 optional = false
 python-versions = ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*"
 files = [
@@ -2188,7 +2095,6 @@ files = [
 name = "pyasn1"
 version = "0.5.0"
 description = "Pure-Python implementation of ASN.1 types and DER/BER/CER codecs (X.208)"
-category = "main"
 optional = false
 python-versions = "!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*,!=3.4.*,!=3.5.*,>=2.7"
 files = [
@@ -2200,7 +2106,6 @@ files = [
 name = "pyasn1-modules"
 version = "0.3.0"
 description = "A collection of ASN.1-based protocols modules"
-category = "main"
 optional = false
 python-versions = "!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*,!=3.4.*,!=3.5.*,>=2.7"
 files = [
@@ -2215,7 +2120,6 @@ pyasn1 = ">=0.4.6,<0.6.0"
 name = "pyblish-base"
 version = "1.8.11"
 description = "Plug-in driven automation framework for content"
-category = "main"
 optional = false
 python-versions = "*"
 files = [
@@ -2227,7 +2131,6 @@ files = [
 name = "pycodestyle"
 version = "2.10.0"
 description = "Python style guide checker"
-category = "dev"
 optional = false
 python-versions = ">=3.6"
 files = [
@@ -2239,7 +2142,6 @@ files = [
 name = "pycparser"
 version = "2.21"
 description = "C parser in Python"
-category = "main"
 optional = false
 python-versions = ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*"
 files = [
@@ -2251,7 +2153,6 @@ files = [
 name = "pydocstyle"
 version = "6.3.0"
 description = "Python docstring style checker"
-category = "dev"
 optional = false
 python-versions = ">=3.6"
 files = [
@@ -2269,7 +2170,6 @@ toml = ["tomli (>=1.2.3)"]
 name = "pyflakes"
 version = "3.0.1"
 description = "passive checker of Python programs"
-category = "dev"
 optional = false
 python-versions = ">=3.6"
 files = [
@@ -2281,7 +2181,6 @@ files = [
 name = "pygments"
 version = "2.15.1"
 description = "Pygments is a syntax highlighting package written in Python."
-category = "dev"
 optional = false
 python-versions = ">=3.7"
 files = [
@@ -2296,7 +2195,6 @@ plugins = ["importlib-metadata"]
 name = "pylint"
 version = "2.17.4"
 description = "python code static checker"
-category = "dev"
 optional = false
 python-versions = ">=3.7.2"
 files = [
@@ -2323,7 +2221,6 @@ testutils = ["gitpython (>3)"]
 name = "pymongo"
 version = "3.13.0"
 description = "Python driver for MongoDB <http://www.mongodb.org>"
-category = "main"
 optional = false
 python-versions = "*"
 files = [
@@ -2452,7 +2349,6 @@ zstd = ["zstandard"]
 name = "pynacl"
 version = "1.5.0"
 description = "Python binding to the Networking and Cryptography (NaCl) library"
-category = "main"
 optional = false
 python-versions = ">=3.6"
 files = [
@@ -2479,7 +2375,6 @@ tests = ["hypothesis (>=3.27.0)", "pytest (>=3.2.1,!=3.3.0)"]
 name = "pynput"
 version = "1.7.6"
 description = "Monitor and control user input devices"
-category = "main"
 optional = false
 python-versions = "*"
 files = [
@@ -2498,7 +2393,6 @@ six = "*"
 name = "pyobjc-core"
 version = "9.1.1"
 description = "Python<->ObjC Interoperability Module"
-category = "main"
 optional = false
 python-versions = ">=3.7"
 files = [
@@ -2515,7 +2409,6 @@ files = [
 name = "pyobjc-framework-applicationservices"
 version = "9.1.1"
 description = "Wrappers for the framework ApplicationServices on macOS"
-category = "main"
 optional = false
 python-versions = ">=3.7"
 files = [
@@ -2537,7 +2430,6 @@ pyobjc-framework-Quartz = ">=9.1.1"
 name = "pyobjc-framework-cocoa"
 version = "9.1.1"
 description = "Wrappers for the Cocoa frameworks on macOS"
-category = "main"
 optional = false
 python-versions = ">=3.7"
 files = [
@@ -2557,7 +2449,6 @@ pyobjc-core = ">=9.1.1"
 name = "pyobjc-framework-quartz"
 version = "9.1.1"
 description = "Wrappers for the Quartz frameworks on macOS"
-category = "main"
 optional = false
 python-versions = ">=3.7"
 files = [
@@ -2578,7 +2469,6 @@ pyobjc-framework-Cocoa = ">=9.1.1"
 name = "pyparsing"
 version = "2.4.7"
 description = "Python parsing module"
-category = "main"
 optional = false
 python-versions = ">=2.6, !=3.0.*, !=3.1.*, !=3.2.*"
 files = [
@@ -2590,7 +2480,6 @@ files = [
 name = "pysftp"
 version = "0.2.9"
 description = "A friendly face on SFTP"
-category = "main"
 optional = false
 python-versions = "*"
 files = [
@@ -2604,7 +2493,6 @@ paramiko = ">=1.17"
 name = "pytest"
 version = "6.2.5"
 description = "pytest: simple powerful testing with Python"
-category = "dev"
 optional = false
 python-versions = ">=3.6"
 files = [
@@ -2629,7 +2517,6 @@ testing = ["argcomplete", "hypothesis (>=3.56)", "mock", "nose", "requests", "xm
 name = "pytest-cov"
 version = "4.1.0"
 description = "Pytest plugin for measuring coverage."
-category = "dev"
 optional = false
 python-versions = ">=3.7"
 files = [
@@ -2648,7 +2535,6 @@ testing = ["fields", "hunter", "process-tests", "pytest-xdist", "six", "virtuale
 name = "pytest-print"
 version = "0.3.1"
 description = "pytest-print adds the printer fixture you can use to print messages to the user (directly to the pytest runner, not stdout)"
-category = "dev"
 optional = false
 python-versions = ">=3.7"
 files = [
@@ -2666,7 +2552,6 @@ test = ["coverage (>=5)"]
 name = "python-dateutil"
 version = "2.8.2"
 description = "Extensions to the standard Python datetime module"
-category = "main"
 optional = false
 python-versions = "!=3.0.*,!=3.1.*,!=3.2.*,>=2.7"
 files = [
@@ -2681,7 +2566,6 @@ six = ">=1.5"
 name = "python-engineio"
 version = "4.4.1"
 description = "Engine.IO server and client for Python"
-category = "main"
 optional = false
 python-versions = ">=3.6"
 files = [
@@ -2697,7 +2581,6 @@ client = ["requests (>=2.21.0)", "websocket-client (>=0.54.0)"]
 name = "python-socketio"
 version = "5.8.0"
 description = "Socket.IO server and client for Python"
-category = "main"
 optional = false
 python-versions = ">=3.6"
 files = [
@@ -2719,7 +2602,6 @@ client = ["requests (>=2.21.0)", "websocket-client (>=0.54.0)"]
 name = "python-xlib"
 version = "0.33"
 description = "Python X Library"
-category = "main"
 optional = false
 python-versions = "*"
 files = [
@@ -2734,7 +2616,6 @@ six = ">=1.10.0"
 name = "python3-xlib"
 version = "0.15"
 description = "Python3 X Library"
-category = "main"
 optional = false
 python-versions = "*"
 files = [
@@ -2745,7 +2626,6 @@ files = [
 name = "pywin32"
 version = "301"
 description = "Python for Window Extensions"
-category = "main"
 optional = false
 python-versions = "*"
 files = [
@@ -2765,7 +2645,6 @@ files = [
 name = "pywin32-ctypes"
 version = "0.2.0"
 description = ""
-category = "main"
 optional = false
 python-versions = "*"
 files = [
@@ -2777,7 +2656,6 @@ files = [
 name = "pyyaml"
 version = "6.0"
 description = "YAML parser and emitter for Python"
-category = "dev"
 optional = false
 python-versions = ">=3.6"
 files = [
@@ -2827,7 +2705,6 @@ files = [
 name = "qt-py"
 version = "1.3.8"
 description = "Python 2 & 3 compatibility wrapper around all Qt bindings - PySide, PySide2, PyQt4 and PyQt5."
-category = "main"
 optional = false
 python-versions = "*"
 files = [
@@ -2842,7 +2719,6 @@ types-PySide2 = "*"
 name = "qtawesome"
 version = "0.7.3"
 description = "FontAwesome icons in PyQt and PySide applications"
-category = "main"
 optional = false
 python-versions = "*"
 files = [
@@ -2858,7 +2734,6 @@ six = "*"
 name = "qtpy"
 version = "2.3.1"
 description = "Provides an abstraction layer on top of the various Qt bindings (PyQt5/6 and PySide2/6)."
-category = "main"
 optional = false
 python-versions = ">=3.7"
 files = [
@@ -2876,7 +2751,6 @@ test = ["pytest (>=6,!=7.0.0,!=7.0.1)", "pytest-cov (>=3.0.0)", "pytest-qt"]
 name = "recommonmark"
 version = "0.7.1"
 description = "A docutils-compatibility bridge to CommonMark, enabling you to write CommonMark inside of Docutils & Sphinx projects."
-category = "dev"
 optional = false
 python-versions = "*"
 files = [
@@ -2893,7 +2767,6 @@ sphinx = ">=1.3.1"
 name = "requests"
 version = "2.31.0"
 description = "Python HTTP for Humans."
-category = "main"
 optional = false
 python-versions = ">=3.7"
 files = [
@@ -2915,7 +2788,6 @@ use-chardet-on-py3 = ["chardet (>=3.0.2,<6)"]
 name = "revitron-sphinx-theme"
 version = "0.7.2"
 description = "Revitron theme for Sphinx"
-category = "dev"
 optional = false
 python-versions = "*"
 files = []
@@ -2937,7 +2809,6 @@ resolved_reference = "c0779c66365d9d258d93575ebaff7db9d3aee282"
 name = "rsa"
 version = "4.9"
 description = "Pure-Python RSA implementation"
-category = "main"
 optional = false
 python-versions = ">=3.6,<4"
 files = [
@@ -2952,7 +2823,6 @@ pyasn1 = ">=0.1.3"
 name = "secretstorage"
 version = "3.3.3"
 description = "Python bindings to FreeDesktop.org Secret Service API"
-category = "main"
 optional = false
 python-versions = ">=3.6"
 files = [
@@ -2968,7 +2838,6 @@ jeepney = ">=0.6"
 name = "semver"
 version = "2.13.0"
 description = "Python helper for Semantic Versioning (http://semver.org/)"
-category = "main"
 optional = false
 python-versions = ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*"
 files = [
@@ -2980,7 +2849,6 @@ files = [
 name = "setuptools"
 version = "65.7.0"
 description = "Easily download, build, install, upgrade, and uninstall Python packages"
-category = "dev"
 optional = false
 python-versions = ">=3.7"
 files = [
@@ -2997,7 +2865,6 @@ testing-integration = ["build[virtualenv]", "filelock (>=3.4.0)", "jaraco.envs (
 name = "shotgun-api3"
 version = "3.3.3"
 description = "Shotgun Python API"
-category = "main"
 optional = false
 python-versions = "*"
 files = []
@@ -3013,7 +2880,6 @@ resolved_reference = "b9f066c0edbea6e0733242e18f32f75489064840"
 name = "six"
 version = "1.16.0"
 description = "Python 2 and 3 compatibility utilities"
-category = "main"
 optional = false
 python-versions = ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*"
 files = [
@@ -3025,7 +2891,6 @@ files = [
 name = "slack-sdk"
 version = "3.21.3"
 description = "The Slack API Platform SDK for Python"
-category = "main"
 optional = false
 python-versions = ">=3.6.0"
 files = [
@@ -3041,7 +2906,6 @@ testing = ["Flask (>=1,<2)", "Flask-Sockets (>=0.2,<1)", "Jinja2 (==3.0.3)", "We
 name = "smmap"
 version = "5.0.0"
 description = "A pure Python implementation of a sliding window memory map manager"
-category = "dev"
 optional = false
 python-versions = ">=3.6"
 files = [
@@ -3053,7 +2917,6 @@ files = [
 name = "snowballstemmer"
 version = "2.2.0"
 description = "This package provides 29 stemmers for 28 languages generated from Snowball algorithms."
-category = "dev"
 optional = false
 python-versions = "*"
 files = [
@@ -3065,7 +2928,6 @@ files = [
 name = "speedcopy"
 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
 python-versions = "*"
 files = [
@@ -3077,7 +2939,6 @@ files = [
 name = "sphinx"
 version = "5.3.0"
 description = "Python documentation generator"
-category = "dev"
 optional = false
 python-versions = ">=3.6"
 files = [
@@ -3113,7 +2974,6 @@ test = ["cython", "html5lib", "pytest (>=4.6)", "typed_ast"]
 name = "sphinx-autoapi"
 version = "2.1.0"
 description = "Sphinx API documentation generator"
-category = "dev"
 optional = false
 python-versions = ">=3.7"
 files = [
@@ -3137,7 +2997,6 @@ go = ["sphinxcontrib-golangdomain"]
 name = "sphinxcontrib-applehelp"
 version = "1.0.4"
 description = "sphinxcontrib-applehelp is a Sphinx extension which outputs Apple help books"
-category = "dev"
 optional = false
 python-versions = ">=3.8"
 files = [
@@ -3153,7 +3012,6 @@ test = ["pytest"]
 name = "sphinxcontrib-devhelp"
 version = "1.0.2"
 description = "sphinxcontrib-devhelp is a sphinx extension which outputs Devhelp document."
-category = "dev"
 optional = false
 python-versions = ">=3.5"
 files = [
@@ -3169,7 +3027,6 @@ test = ["pytest"]
 name = "sphinxcontrib-htmlhelp"
 version = "2.0.1"
 description = "sphinxcontrib-htmlhelp is a sphinx extension which renders HTML help files"
-category = "dev"
 optional = false
 python-versions = ">=3.8"
 files = [
@@ -3185,7 +3042,6 @@ test = ["html5lib", "pytest"]
 name = "sphinxcontrib-jsmath"
 version = "1.0.1"
 description = "A sphinx extension which renders display math in HTML via JavaScript"
-category = "dev"
 optional = false
 python-versions = ">=3.5"
 files = [
@@ -3200,7 +3056,6 @@ test = ["flake8", "mypy", "pytest"]
 name = "sphinxcontrib-napoleon"
 version = "0.7"
 description = "Sphinx \"napoleon\" extension."
-category = "dev"
 optional = false
 python-versions = "*"
 files = [
@@ -3216,7 +3071,6 @@ six = ">=1.5.2"
 name = "sphinxcontrib-qthelp"
 version = "1.0.3"
 description = "sphinxcontrib-qthelp is a sphinx extension which outputs QtHelp document."
-category = "dev"
 optional = false
 python-versions = ">=3.5"
 files = [
@@ -3232,7 +3086,6 @@ test = ["pytest"]
 name = "sphinxcontrib-serializinghtml"
 version = "1.1.5"
 description = "sphinxcontrib-serializinghtml is a sphinx extension which outputs \"serialized\" HTML files (json and pickle)."
-category = "dev"
 optional = false
 python-versions = ">=3.5"
 files = [
@@ -3248,7 +3101,6 @@ test = ["pytest"]
 name = "stone"
 version = "3.3.1"
 description = "Stone is an interface description language (IDL) for APIs."
-category = "main"
 optional = false
 python-versions = "*"
 files = [
@@ -3265,7 +3117,6 @@ six = ">=1.12.0"
 name = "termcolor"
 version = "1.1.0"
 description = "ANSII Color formatting for output in terminal."
-category = "main"
 optional = false
 python-versions = "*"
 files = [
@@ -3276,7 +3127,6 @@ files = [
 name = "toml"
 version = "0.10.2"
 description = "Python Library for Tom's Obvious, Minimal Language"
-category = "dev"
 optional = false
 python-versions = ">=2.6, !=3.0.*, !=3.1.*, !=3.2.*"
 files = [
@@ -3288,7 +3138,6 @@ files = [
 name = "tomli"
 version = "2.0.1"
 description = "A lil' TOML parser"
-category = "dev"
 optional = false
 python-versions = ">=3.7"
 files = [
@@ -3300,7 +3149,6 @@ files = [
 name = "tomlkit"
 version = "0.11.8"
 description = "Style preserving TOML library"
-category = "dev"
 optional = false
 python-versions = ">=3.7"
 files = [
@@ -3312,7 +3160,6 @@ files = [
 name = "types-pyside2"
 version = "5.15.2.1.5"
 description = "The most accurate stubs for PySide2"
-category = "main"
 optional = false
 python-versions = "*"
 files = [
@@ -3323,7 +3170,6 @@ files = [
 name = "typing-extensions"
 version = "4.6.2"
 description = "Backported and Experimental Type Hints for Python 3.7+"
-category = "dev"
 optional = false
 python-versions = ">=3.7"
 files = [
@@ -3335,7 +3181,6 @@ files = [
 name = "uc-micro-py"
 version = "1.0.2"
 description = "Micro subset of unicode data files for linkify-it-py projects."
-category = "dev"
 optional = false
 python-versions = ">=3.7"
 files = [
@@ -3350,7 +3195,6 @@ test = ["coverage", "pytest", "pytest-cov"]
 name = "unidecode"
 version = "1.2.0"
 description = "ASCII transliterations of Unicode text"
-category = "main"
 optional = false
 python-versions = ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*"
 files = [
@@ -3362,7 +3206,6 @@ files = [
 name = "uritemplate"
 version = "3.0.1"
 description = "URI templates"
-category = "main"
 optional = false
 python-versions = ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*"
 files = [
@@ -3374,7 +3217,6 @@ files = [
 name = "urllib3"
 version = "1.26.16"
 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.*, !=3.5.*"
 files = [
@@ -3391,7 +3233,6 @@ socks = ["PySocks (>=1.5.6,!=1.5.7,<2.0)"]
 name = "virtualenv"
 version = "20.23.0"
 description = "Virtual Python Environment builder"
-category = "dev"
 optional = false
 python-versions = ">=3.7"
 files = [
@@ -3412,7 +3253,6 @@ test = ["covdefaults (>=2.3)", "coverage (>=7.2.3)", "coverage-enable-subprocess
 name = "wcwidth"
 version = "0.2.6"
 description = "Measures the displayed width of unicode strings in a terminal"
-category = "main"
 optional = false
 python-versions = "*"
 files = [
@@ -3424,7 +3264,6 @@ files = [
 name = "websocket-client"
 version = "0.59.0"
 description = "WebSocket client for Python with low level API options"
-category = "main"
 optional = false
 python-versions = ">=2.6, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*"
 files = [
@@ -3439,7 +3278,6 @@ six = "*"
 name = "wheel"
 version = "0.40.0"
 description = "A built-package format for Python"
-category = "dev"
 optional = false
 python-versions = ">=3.7"
 files = [
@@ -3454,7 +3292,6 @@ test = ["pytest (>=6.0.0)"]
 name = "wrapt"
 version = "1.15.0"
 description = "Module for decorators, wrappers and monkey patching."
-category = "dev"
 optional = false
 python-versions = "!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*,!=3.4.*,>=2.7"
 files = [
@@ -3539,7 +3376,6 @@ files = [
 name = "wsrpc-aiohttp"
 version = "3.2.0"
 description = "WSRPC is the RPC over WebSocket for aiohttp"
-category = "main"
 optional = false
 python-versions = ">3.5.*, <4"
 files = [
@@ -3560,7 +3396,6 @@ ujson = ["ujson"]
 name = "yarl"
 version = "1.9.2"
 description = "Yet another URL library"
-category = "main"
 optional = false
 python-versions = ">=3.7"
 files = [
@@ -3648,7 +3483,6 @@ multidict = ">=4.0"
 name = "zipp"
 version = "3.15.0"
 description = "Backport of pathlib-compatible object wrapper for zip files"
-category = "main"
 optional = false
 python-versions = ">=3.7"
 files = [
@@ -3665,5 +3499,5 @@ docs = []
 
 [metadata]
 lock-version = "2.0"
-python-versions = ">=3.9.1,<3.10"
-content-hash = "d2b8da22dcd11e0b03f19b9b79e51f205156c5ce75e41cc0225392e9afd8803b"
+python-versions = "~3.9"
+content-hash = "bc3e256094db6e33894840bb6a5adda4473d3736b852433ad8d5bd478c7e0c1c"

From 817ef16840467b55c0832d74696d5ba29ad20929 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <43494761+iLLiCiTiT@users.noreply.github.com>
Date: Mon, 18 Sep 2023 18:04:08 +0200
Subject: [PATCH 277/366] lower version of click to 7.1.2 to support older
 python versions (#5629)

---
 poetry.lock    | 11 ++++-------
 pyproject.toml |  2 +-
 2 files changed, 5 insertions(+), 8 deletions(-)

diff --git a/poetry.lock b/poetry.lock
index 2b9fab4bc4..d074a0c3d9 100644
--- a/poetry.lock
+++ b/poetry.lock
@@ -560,18 +560,15 @@ files = [
 
 [[package]]
 name = "click"
-version = "8.1.3"
+version = "7.1.2"
 description = "Composable command line interface toolkit"
 optional = false
-python-versions = ">=3.7"
+python-versions = ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*"
 files = [
-    {file = "click-8.1.3-py3-none-any.whl", hash = "sha256:bb4d8133cb15a609f44e8213d9b391b0809795062913b383c62be0ee95b1db48"},
-    {file = "click-8.1.3.tar.gz", hash = "sha256:7682dc8afb30297001674575ea00d1814d808d6a36af415a82bd481d37ba7b8e"},
+    {file = "click-7.1.2-py2.py3-none-any.whl", hash = "sha256:dacca89f4bfadd5de3d7489b7c8a566eee0d3676333fbb50030263894c38c0dc"},
+    {file = "click-7.1.2.tar.gz", hash = "sha256:d2b5255c7c6349bc1bd1e59e08cd12acbbd63ce649f2588755783aa94dfb6b1a"},
 ]
 
-[package.dependencies]
-colorama = {version = "*", markers = "platform_system == \"Windows\""}
-
 [[package]]
 name = "clique"
 version = "1.6.1"
diff --git a/pyproject.toml b/pyproject.toml
index e2d35f3c6d..68d31cf4ef 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -36,7 +36,7 @@ appdirs = { git = "https://github.com/ActiveState/appdirs.git", branch = "master
 blessed = "^1.17" # openpype terminal formatting
 coolname = "*"
 clique = "1.6.*"
-Click = "^8"
+Click = "7.1.2"
 dnspython = "^2.1.0"
 ftrack-python-api = "^2.3.3"
 arrow = "^0.17"

From 87d8ff66bbb90dd81a93266ba16cf56273d93613 Mon Sep 17 00:00:00 2001
From: Ynbot <bot@ynput.io>
Date: Tue, 19 Sep 2023 15:47:43 +0000
Subject: [PATCH 278/366] [Automated] Release

---
 CHANGELOG.md        | 122 ++++++++++++++++++++++++++++++++++++++++++++
 openpype/version.py |   2 +-
 pyproject.toml      |   2 +-
 3 files changed, 124 insertions(+), 2 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 935e7dbc4c..9001e9fec5 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,6 +1,128 @@
 # Changelog
 
 
+## [3.16.8](https://github.com/ynput/OpenPype/tree/3.16.8)
+
+
+[Full Changelog](https://github.com/ynput/OpenPype/compare/3.16.7...3.16.8)
+
+### **🚀 Enhancements**
+
+
+<details>
+<summary>Chore: Remove schema from OpenPype root <a href="https://github.com/ynput/OpenPype/pull/5355">#5355</a></summary>
+
+Remove unused schema directory in root of repository which was moved inside openpype/pipeline/schema.
+
+
+___
+
+</details>
+
+
+<details>
+<summary>Igniter: Allow custom Qt scale factor rounding policy <a href="https://github.com/ynput/OpenPype/pull/5554">#5554</a></summary>
+
+Do not force `PassThrough` rounding policy if different policy is defined via env variable.
+
+
+___
+
+</details>
+
+### **🐛 Bug fixes**
+
+
+<details>
+<summary>Chore: Lower urllib3 to support older OpenSSL <a href="https://github.com/ynput/OpenPype/pull/5538">#5538</a></summary>
+
+Lowered `urllib3` to `1.26.16` to support older OpenSSL.
+
+
+___
+
+</details>
+
+
+<details>
+<summary>Chore: Do not try to add schema to zip files <a href="https://github.com/ynput/OpenPype/pull/5557">#5557</a></summary>
+
+Do not add `schema` folder to zip file. This fixes issue cause by https://github.com/ynput/OpenPype/pull/5355 .
+
+
+___
+
+</details>
+
+
+<details>
+<summary>Chore: Lower click dependency version <a href="https://github.com/ynput/OpenPype/pull/5629">#5629</a></summary>
+
+Lower click version to support older versions of python.
+
+
+___
+
+</details>
+
+### **Merged pull requests**
+
+
+<details>
+<summary>Bump certifi from 2023.5.7 to 2023.7.22 <a href="https://github.com/ynput/OpenPype/pull/5351">#5351</a></summary>
+
+Bumps [certifi](https://github.com/certifi/python-certifi) from 2023.5.7 to 2023.7.22.
+<details>
+<summary>Commits</summary>
+<ul>
+<li><a href="https://github.com/certifi/python-certifi/commit/8fb96ed81f71e7097ed11bc4d9b19afd7ea5c909"><code>8fb96ed</code></a> 2023.07.22</li>
+<li><a href="https://github.com/certifi/python-certifi/commit/afe77220e0eaa722593fc5d294213ff5275d1b40"><code>afe7722</code></a> Bump actions/setup-python from 4.6.1 to 4.7.0 (<a href="https://redirect.github.com/certifi/python-certifi/issues/230">#230</a>)</li>
+<li><a href="https://github.com/certifi/python-certifi/commit/2038739ad56abec7aaddfa90ad2ce6b3ed7f5c7b"><code>2038739</code></a> Bump dessant/lock-threads from 3.0.0 to 4.0.1 (<a href="https://redirect.github.com/certifi/python-certifi/issues/229">#229</a>)</li>
+<li><a href="https://github.com/certifi/python-certifi/commit/44df761f4c09d19f32b3cc09208a739043a5e25b"><code>44df761</code></a> Hash pin Actions and enable dependabot (<a href="https://redirect.github.com/certifi/python-certifi/issues/228">#228</a>)</li>
+<li>See full diff in <a href="https://github.com/certifi/python-certifi/compare/2023.05.07...2023.07.22">compare view</a></li>
+</ul>
+</details>
+<br />
+
+
+[![Dependabot compatibility score](https://dependabot-badges.githubapp.com/badges/compatibility_score?dependency-name=certifi&package-manager=pip&previous-version=2023.5.7&new-version=2023.7.22)](https://docs.github.com/en/github/managing-security-vulnerabilities/about-dependabot-security-updates#about-compatibility-scores)
+
+You can trigger a rebase of this PR by commenting `@dependabot rebase`.
+
+[//]: # (dependabot-automerge-start)
+[//]: # (dependabot-automerge-end)
+
+---
+
+<details>
+<summary>Dependabot commands and options</summary>
+<br />
+
+You can trigger Dependabot actions by commenting on this PR:
+- `@dependabot rebase` will rebase this PR
+- `@dependabot recreate` will recreate this PR, overwriting any edits that have been made to it
+- `@dependabot merge` will merge this PR after your CI passes on it
+- `@dependabot squash and merge` will squash and merge this PR after your CI passes on it
+- `@dependabot cancel merge` will cancel a previously requested merge and block automerging
+- `@dependabot reopen` will reopen this PR if it is closed
+- `@dependabot close` will close this PR and stop Dependabot recreating it. You can achieve the same result by closing it manually
+- `@dependabot ignore this major version` will close this PR and stop Dependabot creating any more for this major version (unless you reopen the PR or upgrade to it yourself)
+- `@dependabot ignore this minor version` will close this PR and stop Dependabot creating any more for this minor version (unless you reopen the PR or upgrade to it yourself)
+- `@dependabot ignore this dependency` will close this PR and stop Dependabot creating any more for this dependency (unless you reopen the PR or upgrade to it yourself)
+You can disable automated security fix PRs for this repo from the [Security Alerts page](https://github.com/ynput/OpenPype/network/alerts).
+
+</details>
+
+> **Note**
+> Automatic rebases have been disabled on this pull request as it has been open for over 30 days.
+
+___
+
+</details>
+
+
+
+
 ## [3.16.7](https://github.com/ynput/OpenPype/tree/3.16.7)
 
 
diff --git a/openpype/version.py b/openpype/version.py
index c593f0f71f..0578bb8780 100644
--- a/openpype/version.py
+++ b/openpype/version.py
@@ -1,3 +1,3 @@
 # -*- coding: utf-8 -*-
 """Package declaring Pype version."""
-__version__ = "3.16.7"
+__version__ = "3.16.8"
diff --git a/pyproject.toml b/pyproject.toml
index b394a895e3..c5d5e87f49 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "OpenPype"
-version = "3.16.7" # OpenPype
+version = "3.16.8" # OpenPype
 description = "Open VFX and Animation pipeline with support."
 authors = ["OpenPype Team <info@openpype.io>"]
 license = "MIT License"

From 5bf4b826ac960103f121f094506100e993507bef Mon Sep 17 00:00:00 2001
From: Petr Dvorak <dvorak.peta@gmail.com>
Date: Tue, 19 Sep 2023 17:56:06 +0200
Subject: [PATCH 279/366] update release

---
 CHANGELOG.md        | 4 ++--
 openpype/version.py | 2 +-
 pyproject.toml      | 2 +-
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 9001e9fec5..4bcf66a210 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,10 +1,10 @@
 # Changelog
 
 
-## [3.16.8](https://github.com/ynput/OpenPype/tree/3.16.8)
+## [3.17.0](https://github.com/ynput/OpenPype/tree/3.17.0)
 
 
-[Full Changelog](https://github.com/ynput/OpenPype/compare/3.16.7...3.16.8)
+[Full Changelog](https://github.com/ynput/OpenPype/compare/3.16.7...3.17.0)
 
 ### **🚀 Enhancements**
 
diff --git a/openpype/version.py b/openpype/version.py
index 0578bb8780..281e756967 100644
--- a/openpype/version.py
+++ b/openpype/version.py
@@ -1,3 +1,3 @@
 # -*- coding: utf-8 -*-
 """Package declaring Pype version."""
-__version__ = "3.16.8"
+__version__ = "3.17.0"
diff --git a/pyproject.toml b/pyproject.toml
index 233cf73db8..d0b1ecf589 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "OpenPype"
-version = "3.16.8" # OpenPype
+version = "3.17.0" # OpenPype
 description = "Open VFX and Animation pipeline with support."
 authors = ["OpenPype Team <info@openpype.io>"]
 license = "MIT License"

From 77600e624c31697f515ac37d3d0834253d0951bd Mon Sep 17 00:00:00 2001
From: "github-actions[bot]" <github-actions[bot]@users.noreply.github.com>
Date: Tue, 19 Sep 2023 15:48:46 +0000
Subject: [PATCH 280/366] chore(): update bug report / version

---
 .github/ISSUE_TEMPLATE/bug_report.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/ISSUE_TEMPLATE/bug_report.yml b/.github/ISSUE_TEMPLATE/bug_report.yml
index 9159d3fe4a..be515983ca 100644
--- a/.github/ISSUE_TEMPLATE/bug_report.yml
+++ b/.github/ISSUE_TEMPLATE/bug_report.yml
@@ -35,6 +35,7 @@ body:
       label: Version
       description: What version are you running? Look to OpenPype Tray
       options:
+        - 3.16.8
         - 3.16.7
         - 3.16.7-nightly.2
         - 3.16.7-nightly.1
@@ -134,7 +135,6 @@ body:
         - 3.14.10-nightly.3
         - 3.14.10-nightly.2
         - 3.14.10-nightly.1
-        - 3.14.9
     validations:
       required: true
   - type: dropdown

From dc5c730cba6119342600dcbe6a5a13d6d1c4b569 Mon Sep 17 00:00:00 2001
From: "github-actions[bot]" <github-actions[bot]@users.noreply.github.com>
Date: Tue, 19 Sep 2023 16:01:55 +0000
Subject: [PATCH 281/366] chore(): update bug report / version

---
 .github/ISSUE_TEMPLATE/bug_report.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/ISSUE_TEMPLATE/bug_report.yml b/.github/ISSUE_TEMPLATE/bug_report.yml
index be515983ca..0762eb2f20 100644
--- a/.github/ISSUE_TEMPLATE/bug_report.yml
+++ b/.github/ISSUE_TEMPLATE/bug_report.yml
@@ -35,7 +35,7 @@ body:
       label: Version
       description: What version are you running? Look to OpenPype Tray
       options:
-        - 3.16.8
+        - 3.17.0
         - 3.16.7
         - 3.16.7-nightly.2
         - 3.16.7-nightly.1

From 7195479080639489b65a2715b3fba74414dc8815 Mon Sep 17 00:00:00 2001
From: Ynbot <bot@ynput.io>
Date: Wed, 20 Sep 2023 03:24:46 +0000
Subject: [PATCH 282/366] [Automated] Bump version

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

diff --git a/openpype/version.py b/openpype/version.py
index 281e756967..483b70436a 100644
--- a/openpype/version.py
+++ b/openpype/version.py
@@ -1,3 +1,3 @@
 # -*- coding: utf-8 -*-
 """Package declaring Pype version."""
-__version__ = "3.17.0"
+__version__ = "3.17.1-nightly.1"

From 41845651b2aaf701b3a7d27c0091a23948c3c2b9 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ond=C5=99ej=20Samohel?=
 <33513211+antirotor@users.noreply.github.com>
Date: Wed, 20 Sep 2023 14:38:35 +0200
Subject: [PATCH 283/366] Update setup.cfg

Co-authored-by: Jakub Trllo <43494761+iLLiCiTiT@users.noreply.github.com>
---
 setup.cfg | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/setup.cfg b/setup.cfg
index 216bae848f..ead9b25164 100644
--- a/setup.cfg
+++ b/setup.cfg
@@ -28,7 +28,7 @@ omit = /tests
 directory = ./coverage
 
 [tool:pytest]
-norecursedirs = repos/* openpype/modules/ftrack/*
+norecursedirs = openpype/modules/ftrack/*
 
 [isort]
 line_length = 79

From d91f54f2f74edac0a729513639f40ed2558e5ff5 Mon Sep 17 00:00:00 2001
From: Mustafa-Zarkash <mustafataherzaky@outlook.com>
Date: Wed, 20 Sep 2023 19:18:33 +0300
Subject: [PATCH 284/366] rename files and make validator optional

---
 ...e_unreal_staticmesh.py => create_staticmesh.py} | 14 +++++++-------
 .../plugins/publish/collect_staticmesh_type.py     |  2 +-
 .../publish/validate_unreal_staticmesh_naming.py   |  2 +-
 .../settings/defaults/project_settings/global.json |  3 +--
 .../defaults/project_settings/houdini.json         |  4 ++--
 .../schemas/schema_houdini_create.json             |  4 ++--
 server_addon/core/server/settings/tools.py         |  3 +--
 .../houdini/server/settings/publish_plugins.py     | 12 ++++++------
 8 files changed, 21 insertions(+), 23 deletions(-)
 rename openpype/hosts/houdini/plugins/create/{create_unreal_staticmesh.py => create_staticmesh.py} (91%)

diff --git a/openpype/hosts/houdini/plugins/create/create_unreal_staticmesh.py b/openpype/hosts/houdini/plugins/create/create_staticmesh.py
similarity index 91%
rename from openpype/hosts/houdini/plugins/create/create_unreal_staticmesh.py
rename to openpype/hosts/houdini/plugins/create/create_staticmesh.py
index 2f92def54a..ea0b36f03f 100644
--- a/openpype/hosts/houdini/plugins/create/create_unreal_staticmesh.py
+++ b/openpype/hosts/houdini/plugins/create/create_staticmesh.py
@@ -6,11 +6,11 @@ from openpype.lib import BoolDef, EnumDef
 import hou
 
 
-class CreateUnrealStaticMesh(plugin.HoudiniCreator):
-    """Unreal Static Meshes with collisions. """
+class CreateStaticMesh(plugin.HoudiniCreator):
+    """Static Meshes as FBX. """
 
-    identifier = "io.openpype.creators.houdini.unrealstaticmesh.fbx"
-    label = "Unreal - Static Mesh (FBX)"
+    identifier = "io.openpype.creators.houdini.staticmesh.fbx"
+    label = "Static Mesh (FBX)"
     family = "staticMesh"
     icon = "fa5s.cubes"
 
@@ -20,7 +20,7 @@ class CreateUnrealStaticMesh(plugin.HoudiniCreator):
 
         instance_data.update({"node_type": "filmboxfbx"})
 
-        instance = super(CreateUnrealStaticMesh, self).create(
+        instance = super(CreateStaticMesh, self).create(
             subset_name,
             instance_data,
             pre_create_data)
@@ -60,7 +60,7 @@ class CreateUnrealStaticMesh(plugin.HoudiniCreator):
     def get_pre_create_attr_defs(self):
         """Add settings for users. """
 
-        attrs = super(CreateUnrealStaticMesh, self).get_pre_create_attr_defs()
+        attrs = super(CreateStaticMesh, self).get_pre_create_attr_defs()
         createsubnetroot = BoolDef("createsubnetroot",
                                    tooltip="Create an extra root for the "
                                            "Export node when it's a "
@@ -93,7 +93,7 @@ class CreateUnrealStaticMesh(plugin.HoudiniCreator):
         The default subset name templates for Unreal include {asset} and thus
         we should pass that along as dynamic data.
         """
-        dynamic_data = super(CreateUnrealStaticMesh, self).get_dynamic_data(
+        dynamic_data = super(CreateStaticMesh, self).get_dynamic_data(
             variant, task_name, asset_doc, project_name, host_name, instance
         )
         dynamic_data["asset"] = asset_doc["name"]
diff --git a/openpype/hosts/houdini/plugins/publish/collect_staticmesh_type.py b/openpype/hosts/houdini/plugins/publish/collect_staticmesh_type.py
index 263d7c1001..db9efec7a1 100644
--- a/openpype/hosts/houdini/plugins/publish/collect_staticmesh_type.py
+++ b/openpype/hosts/houdini/plugins/publish/collect_staticmesh_type.py
@@ -15,6 +15,6 @@ class CollectStaticMeshType(pyblish.api.InstancePlugin):
 
     def process(self, instance):
 
-        if instance.data["creator_identifier"] == "io.openpype.creators.houdini.unrealstaticmesh.fbx":  # noqa: E501
+        if instance.data["creator_identifier"] == "io.openpype.creators.houdini.staticmesh.fbx":  # noqa: E501
             # Marking this instance as FBX triggers the FBX extractor.
             instance.data["families"] += ["fbx"]
diff --git a/openpype/hosts/houdini/plugins/publish/validate_unreal_staticmesh_naming.py b/openpype/hosts/houdini/plugins/publish/validate_unreal_staticmesh_naming.py
index 791db8198f..ae3c7e5602 100644
--- a/openpype/hosts/houdini/plugins/publish/validate_unreal_staticmesh_naming.py
+++ b/openpype/hosts/houdini/plugins/publish/validate_unreal_staticmesh_naming.py
@@ -42,7 +42,7 @@ class ValidateUnrealStaticMeshName(pyblish.api.InstancePlugin,
     def apply_settings(cls, project_settings, system_settings):
 
         settings = (
-            project_settings["houdini"]["create"]["CreateUnrealStaticMesh"]
+            project_settings["houdini"]["create"]["CreateStaticMesh"]
         )
         cls.collision_prefixes = settings["collision_prefixes"]
         cls.static_mesh_prefix = settings["static_mesh_prefix"]
diff --git a/openpype/settings/defaults/project_settings/global.json b/openpype/settings/defaults/project_settings/global.json
index 52ac745f6d..06a595d1c5 100644
--- a/openpype/settings/defaults/project_settings/global.json
+++ b/openpype/settings/defaults/project_settings/global.json
@@ -429,8 +429,7 @@
                         "staticMesh"
                     ],
                     "hosts": [
-                        "maya",
-                        "houdini"
+                        "maya"
                     ],
                     "task_types": [],
                     "tasks": [],
diff --git a/openpype/settings/defaults/project_settings/houdini.json b/openpype/settings/defaults/project_settings/houdini.json
index 6964db0013..5392fc34dd 100644
--- a/openpype/settings/defaults/project_settings/houdini.json
+++ b/openpype/settings/defaults/project_settings/houdini.json
@@ -19,7 +19,7 @@
             ],
             "ext": ".ass"
         },
-        "CreateUnrealStaticMesh": {
+        "CreateStaticMesh": {
             "enabled": true,
             "default_variants": [
                 "Main"
@@ -127,7 +127,7 @@
             "active": true
         },
         "ValidateUnrealStaticMeshName": {
-            "enabled": true,
+            "enabled": false,
             "optional": true,
             "active": true
         }
diff --git a/openpype/settings/entities/schemas/projects_schema/schemas/schema_houdini_create.json b/openpype/settings/entities/schemas/projects_schema/schemas/schema_houdini_create.json
index b19761df91..cd8c260124 100644
--- a/openpype/settings/entities/schemas/projects_schema/schemas/schema_houdini_create.json
+++ b/openpype/settings/entities/schemas/projects_schema/schemas/schema_houdini_create.json
@@ -42,8 +42,8 @@
         {
             "type": "dict",
             "collapsible": true,
-            "key": "CreateUnrealStaticMesh",
-            "label": "Create Unreal - Static Mesh",
+            "key": "CreateStaticMesh",
+            "label": "Create Static Mesh",
             "checkbox_key": "enabled",
             "children": [
                 {
diff --git a/server_addon/core/server/settings/tools.py b/server_addon/core/server/settings/tools.py
index 5dbe6ab215..7befc795e4 100644
--- a/server_addon/core/server/settings/tools.py
+++ b/server_addon/core/server/settings/tools.py
@@ -370,8 +370,7 @@ DEFAULT_TOOLS_VALUES = {
                     "staticMesh"
                 ],
                 "hosts": [
-                    "maya",
-                    "houdini"
+                    "maya"
                 ],
                 "task_types": [],
                 "tasks": [],
diff --git a/server_addon/houdini/server/settings/publish_plugins.py b/server_addon/houdini/server/settings/publish_plugins.py
index 6ceff028a5..58240b0205 100644
--- a/server_addon/houdini/server/settings/publish_plugins.py
+++ b/server_addon/houdini/server/settings/publish_plugins.py
@@ -21,7 +21,7 @@ class CreateArnoldAssModel(BaseSettingsModel):
     ext: str = Field(Title="Extension")
 
 
-class CreateUnrealStaticMeshModel(BaseSettingsModel):
+class CreateStaticMeshModel(BaseSettingsModel):
     enabled: bool = Field(title="Enabled")
     default_variants: list[str] = Field(
         default_factory=list,
@@ -39,9 +39,9 @@ class CreatePluginsModel(BaseSettingsModel):
         default_factory=CreateArnoldAssModel,
         title="Create Alembic Camera")
     # "-" is not compatible in the new model
-    CreateUnrealStaticMesh: CreateUnrealStaticMeshModel = Field(
-        default_factory=CreateUnrealStaticMeshModel,
-        title="Create Unreal_Static Mesh"
+    CreateStaticMesh: CreateStaticMeshModel = Field(
+        default_factory=CreateStaticMeshModel,
+        title="Create Static Mesh"
     )
     CreateAlembicCamera: CreatorModel = Field(
         default_factory=CreatorModel,
@@ -81,7 +81,7 @@ DEFAULT_HOUDINI_CREATE_SETTINGS = {
         "default_variants": ["Main"],
         "ext": ".ass"
     },
-    "CreateUnrealStaticMesh": {
+    "CreateStaticMesh": {
         "enabled": True,
         "default_variants": [
             "Main"
@@ -212,7 +212,7 @@ DEFAULT_HOUDINI_PUBLISH_SETTINGS = {
         "active": True
     },
     "ValidateUnrealStaticMeshName": {
-        "enabled": True,
+        "enabled": False,
         "optional": True,
         "active": True
     }

From 23e9f5e504c482bc13268d16190378142b5ca936 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <43494761+iLLiCiTiT@users.noreply.github.com>
Date: Thu, 21 Sep 2023 10:26:33 +0200
Subject: [PATCH 285/366] TVPaint: Fix review family extraction (#5637)

* mark review family representation for review

* implemented 'get_publish_instance_families' in publish lib

* use 'get_publish_instance_families' in tvpaint extract sequence
---
 .../plugins/publish/extract_sequence.py       |  8 +++++--
 openpype/pipeline/publish/__init__.py         |  2 ++
 openpype/pipeline/publish/lib.py              | 24 +++++++++++++++++++
 3 files changed, 32 insertions(+), 2 deletions(-)

diff --git a/openpype/hosts/tvpaint/plugins/publish/extract_sequence.py b/openpype/hosts/tvpaint/plugins/publish/extract_sequence.py
index a13a91de46..fd568b2826 100644
--- a/openpype/hosts/tvpaint/plugins/publish/extract_sequence.py
+++ b/openpype/hosts/tvpaint/plugins/publish/extract_sequence.py
@@ -6,7 +6,10 @@ from PIL import Image
 
 import pyblish.api
 
-from openpype.pipeline.publish import KnownPublishError
+from openpype.pipeline.publish import (
+    KnownPublishError,
+    get_publish_instance_families,
+)
 from openpype.hosts.tvpaint.api.lib import (
     execute_george,
     execute_george_through_file,
@@ -140,8 +143,9 @@ class ExtractSequence(pyblish.api.Extractor):
         )
 
         # Fill tags and new families from project settings
+        instance_families = get_publish_instance_families(instance)
         tags = []
-        if "review" in instance.data["families"]:
+        if "review" in instance_families:
             tags.append("review")
 
         # Sequence of one frame
diff --git a/openpype/pipeline/publish/__init__.py b/openpype/pipeline/publish/__init__.py
index 0c57915c05..3a82d6f565 100644
--- a/openpype/pipeline/publish/__init__.py
+++ b/openpype/pipeline/publish/__init__.py
@@ -40,6 +40,7 @@ from .lib import (
     apply_plugin_settings_automatically,
     get_plugin_settings,
     get_publish_instance_label,
+    get_publish_instance_families,
 )
 
 from .abstract_expected_files import ExpectedFiles
@@ -87,6 +88,7 @@ __all__ = (
     "apply_plugin_settings_automatically",
     "get_plugin_settings",
     "get_publish_instance_label",
+    "get_publish_instance_families",
 
     "ExpectedFiles",
 
diff --git a/openpype/pipeline/publish/lib.py b/openpype/pipeline/publish/lib.py
index 1ae6ea43b2..4d9443f635 100644
--- a/openpype/pipeline/publish/lib.py
+++ b/openpype/pipeline/publish/lib.py
@@ -1002,3 +1002,27 @@ def get_publish_instance_label(instance):
         or instance.data.get("name")
         or str(instance)
     )
+
+
+def get_publish_instance_families(instance):
+    """Get all families of the instance.
+
+    Look for families under 'family' and 'families' keys in instance data.
+    Value of 'family' is used as first family and then all other families
+    in random order.
+
+    Args:
+        pyblish.api.Instance: Instance to get families from.
+
+    Returns:
+        list[str]: List of families.
+    """
+
+    family = instance.data.get("family")
+    families = set(instance.data.get("families") or [])
+    output = []
+    if family:
+        output.append(family)
+        families.discard(family)
+    output.extend(families)
+    return output

From b8e054a50cac66c4e671da0261093be68db555b2 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Thu, 21 Sep 2023 17:01:07 +0200
Subject: [PATCH 286/366] renaming variable to make more sense

---
 openpype/pipeline/colorspace.py                 | 12 ++++++------
 tests/unit/openpype/pipeline/test_colorspace.py |  2 +-
 2 files changed, 7 insertions(+), 7 deletions(-)

diff --git a/openpype/pipeline/colorspace.py b/openpype/pipeline/colorspace.py
index ae16c13635..454c23a55e 100644
--- a/openpype/pipeline/colorspace.py
+++ b/openpype/pipeline/colorspace.py
@@ -24,7 +24,7 @@ log = Logger.get_logger(__name__)
 
 class CachedData:
     remapping = None
-    python3compatible = None
+    has_compatible_ocio_package  = None
     config_version_data = None
     ocio_config_colorspaces = {}
 
@@ -459,17 +459,17 @@ def _get_wrapped_with_subprocess(command_group, command, **kwargs):
 # TODO: this should be part of ocio_wrapper.py
 def compatibility_check():
     """Making sure PyOpenColorIO is importable"""
-    if CachedData.python3compatible is not None:
-        return CachedData.python3compatible
+    if CachedData.has_compatible_ocio_package  is not None:
+        return CachedData.has_compatible_ocio_package
 
     try:
         import PyOpenColorIO  # noqa: F401
-        CachedData.python3compatible = True
+        CachedData.has_compatible_ocio_package  = True
     except ImportError:
-        CachedData.python3compatible = False
+        CachedData.has_compatible_ocio_package  = False
 
     # compatible
-    return CachedData.python3compatible
+    return CachedData.has_compatible_ocio_package
 
 
 # TODO: this should be part of ocio_wrapper.py
diff --git a/tests/unit/openpype/pipeline/test_colorspace.py b/tests/unit/openpype/pipeline/test_colorspace.py
index 435ea709ab..493be786a3 100644
--- a/tests/unit/openpype/pipeline/test_colorspace.py
+++ b/tests/unit/openpype/pipeline/test_colorspace.py
@@ -227,7 +227,7 @@ class TestPipelineColorspace(TestPipeline):
         expected_hiero = "Gamma 2.2 Rec.709 - Texture"
 
         # switch to python 2 compatibility mode
-        colorspace.CachedData.python3compatible = False
+        colorspace.CachedData.has_compatible_ocio_package  = False
 
         nuke_colorspace = colorspace.get_colorspace_name_from_filepath(
             nuke_filepath,

From da7ffb84fba2041f7415537e5031485f5835f8e8 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Thu, 21 Sep 2023 17:10:27 +0200
Subject: [PATCH 287/366] improving regex patter for underscored pattern

---
 openpype/pipeline/colorspace.py | 14 ++++++--------
 1 file changed, 6 insertions(+), 8 deletions(-)

diff --git a/openpype/pipeline/colorspace.py b/openpype/pipeline/colorspace.py
index 454c23a55e..677656c02f 100644
--- a/openpype/pipeline/colorspace.py
+++ b/openpype/pipeline/colorspace.py
@@ -341,7 +341,7 @@ def parse_colorspace_from_filepath(
         pattern = "|".join(
             # Allow to match spaces also as underscores because the
             # integrator replaces spaces with underscores in filenames
-            re.escape(colorspace).replace(r"\ ", r"[_ ]") for colorspace in
+            re.escape(colorspace) for colorspace in
             # Sort by longest first so the regex matches longer matches
             # over smaller matches, e.g. matching 'Output - sRGB' over 'sRGB'
             sorted(colorspaces, key=len, reverse=True)
@@ -355,22 +355,20 @@ def parse_colorspace_from_filepath(
 
     colorspace_name = None
     colorspaces = colorspaces or get_ocio_config_colorspaces(config_path)
-    underscored_colorspaces = {
-        key.replace(" ", "_"): key for key in colorspaces
+    underscored_colorspaces = list({
+        key.replace(" ", "_") for key in colorspaces
         if " " in key
-    }
+    })
 
     # match colorspace from  filepath
-    regex_pattern = _get_colorspace_match_regex(colorspaces)
+    regex_pattern = _get_colorspace_match_regex(
+        colorspaces + underscored_colorspaces)
     match = regex_pattern.search(filepath)
     colorspace = match.group(0) if match else None
 
     if colorspace:
         colorspace_name = colorspace
 
-    if colorspace in underscored_colorspaces:
-        colorspace_name = underscored_colorspaces[colorspace]
-
     if not colorspace_name:
         log.info("No matching colorspace in config '{}' for path: '{}'".format(
             config_path, filepath

From 6e7cde73be7c3309deb78f10324d8779e354f5cc Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Thu, 21 Sep 2023 17:17:45 +0200
Subject: [PATCH 288/366] second part of previous commit

---
 openpype/pipeline/colorspace.py | 23 +++++++++++------------
 1 file changed, 11 insertions(+), 12 deletions(-)

diff --git a/openpype/pipeline/colorspace.py b/openpype/pipeline/colorspace.py
index 677656c02f..1bb4624537 100644
--- a/openpype/pipeline/colorspace.py
+++ b/openpype/pipeline/colorspace.py
@@ -353,29 +353,28 @@ def parse_colorspace_from_filepath(
             "Must provide `config_path` if `colorspaces` is not provided."
         )
 
-    colorspace_name = None
     colorspaces = colorspaces or get_ocio_config_colorspaces(config_path)
-    underscored_colorspaces = list({
-        key.replace(" ", "_") for key in colorspaces
+    underscored_colorspaces = {
+        key.replace(" ", "_"): key for key in colorspaces
         if " " in key
-    })
+    }
 
     # match colorspace from  filepath
     regex_pattern = _get_colorspace_match_regex(
-        colorspaces + underscored_colorspaces)
+        colorspaces + underscored_colorspaces.keys())
     match = regex_pattern.search(filepath)
     colorspace = match.group(0) if match else None
 
     if colorspace:
-        colorspace_name = colorspace
+        return colorspace
 
-    if not colorspace_name:
-        log.info("No matching colorspace in config '{}' for path: '{}'".format(
-            config_path, filepath
-        ))
-        return None
+    if colorspace in underscored_colorspaces:
+        return underscored_colorspaces[colorspace]
 
-    return colorspace_name
+    log.info("No matching colorspace in config '{}' for path: '{}'".format(
+        config_path, filepath
+    ))
+    return None
 
 
 def validate_imageio_colorspace_in_config(config_path, colorspace_name):

From d045b8322304dbcbf86e63d7c767561c5f7cd800 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Thu, 21 Sep 2023 17:20:57 +0200
Subject: [PATCH 289/366] reversing order for underscored first

---
 openpype/pipeline/colorspace.py | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/openpype/pipeline/colorspace.py b/openpype/pipeline/colorspace.py
index 1bb4624537..4ece96cfff 100644
--- a/openpype/pipeline/colorspace.py
+++ b/openpype/pipeline/colorspace.py
@@ -365,12 +365,12 @@ def parse_colorspace_from_filepath(
     match = regex_pattern.search(filepath)
     colorspace = match.group(0) if match else None
 
-    if colorspace:
-        return colorspace
-
     if colorspace in underscored_colorspaces:
         return underscored_colorspaces[colorspace]
 
+    if colorspace:
+        return colorspace
+
     log.info("No matching colorspace in config '{}' for path: '{}'".format(
         config_path, filepath
     ))

From 49cfebb1639389447d0e4973b0f1d42630beec7d Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Thu, 21 Sep 2023 17:23:34 +0200
Subject: [PATCH 290/366] log can be added as explicit arg

---
 openpype/pipeline/colorspace.py | 6 +-----
 1 file changed, 1 insertion(+), 5 deletions(-)

diff --git a/openpype/pipeline/colorspace.py b/openpype/pipeline/colorspace.py
index 4ece96cfff..a1e86dbd64 100644
--- a/openpype/pipeline/colorspace.py
+++ b/openpype/pipeline/colorspace.py
@@ -442,11 +442,7 @@ def _get_wrapped_with_subprocess(command_group, command, **kwargs):
 
         log.info("Executing: {}".format(" ".join(args)))
 
-        process_kwargs = {
-            "logger": log
-        }
-
-        run_openpype_process(*args, **process_kwargs)
+        run_openpype_process(*args, logger=log)
 
         # return all colorspaces
         with open(tmp_json_path, "r") as f_:

From aefbc7ef47e46ff91cd85df045801ad7ad6349bd Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Thu, 21 Sep 2023 17:24:36 +0200
Subject: [PATCH 291/366] removing extra space

---
 openpype/pipeline/colorspace.py                 | 8 ++++----
 tests/unit/openpype/pipeline/test_colorspace.py | 2 +-
 2 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/openpype/pipeline/colorspace.py b/openpype/pipeline/colorspace.py
index a1e86dbd64..0cc2f35a49 100644
--- a/openpype/pipeline/colorspace.py
+++ b/openpype/pipeline/colorspace.py
@@ -24,7 +24,7 @@ log = Logger.get_logger(__name__)
 
 class CachedData:
     remapping = None
-    has_compatible_ocio_package  = None
+    has_compatible_ocio_package = None
     config_version_data = None
     ocio_config_colorspaces = {}
 
@@ -452,14 +452,14 @@ def _get_wrapped_with_subprocess(command_group, command, **kwargs):
 # TODO: this should be part of ocio_wrapper.py
 def compatibility_check():
     """Making sure PyOpenColorIO is importable"""
-    if CachedData.has_compatible_ocio_package  is not None:
+    if CachedData.has_compatible_ocio_package is not None:
         return CachedData.has_compatible_ocio_package
 
     try:
         import PyOpenColorIO  # noqa: F401
-        CachedData.has_compatible_ocio_package  = True
+        CachedData.has_compatible_ocio_package = True
     except ImportError:
-        CachedData.has_compatible_ocio_package  = False
+        CachedData.has_compatible_ocio_package = False
 
     # compatible
     return CachedData.has_compatible_ocio_package
diff --git a/tests/unit/openpype/pipeline/test_colorspace.py b/tests/unit/openpype/pipeline/test_colorspace.py
index 493be786a3..85faa8ff5d 100644
--- a/tests/unit/openpype/pipeline/test_colorspace.py
+++ b/tests/unit/openpype/pipeline/test_colorspace.py
@@ -227,7 +227,7 @@ class TestPipelineColorspace(TestPipeline):
         expected_hiero = "Gamma 2.2 Rec.709 - Texture"
 
         # switch to python 2 compatibility mode
-        colorspace.CachedData.has_compatible_ocio_package  = False
+        colorspace.CachedData.has_compatible_ocio_package = False
 
         nuke_colorspace = colorspace.get_colorspace_name_from_filepath(
             nuke_filepath,

From 89d3a3ae228c8ed4f8a1e9b7e5e6cea2c6b65539 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Thu, 21 Sep 2023 17:28:27 +0200
Subject: [PATCH 292/366] caching per config path compatibility check

---
 openpype/pipeline/colorspace.py | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/openpype/pipeline/colorspace.py b/openpype/pipeline/colorspace.py
index 0cc2f35a49..446849b76e 100644
--- a/openpype/pipeline/colorspace.py
+++ b/openpype/pipeline/colorspace.py
@@ -25,7 +25,7 @@ log = Logger.get_logger(__name__)
 class CachedData:
     remapping = None
     has_compatible_ocio_package = None
-    config_version_data = None
+    config_version_data = {}
     ocio_config_colorspaces = {}
 
 
@@ -469,26 +469,26 @@ def compatibility_check():
 def compatibility_check_config_version(config_path, major=1, minor=None):
     """Making sure PyOpenColorIO config version is compatible"""
 
-    if not CachedData.config_version_data:
+    if not CachedData.config_version_data.get(config_path):
         if compatibility_check():
             # TODO: refactor this so it is not imported but part of this file
             from openpype.scripts.ocio_wrapper import _get_version_data
 
-            CachedData.config_version_data = _get_version_data(config_path)
+            CachedData.config_version_data[config_path] = _get_version_data(config_path)
 
         else:
             # python environment is not compatible with PyOpenColorIO
             # needs to be run in subprocess
-            CachedData.config_version_data = _get_wrapped_with_subprocess(
+            CachedData.config_version_data[config_path] = _get_wrapped_with_subprocess(
                 "config", "get_version", config_path=config_path
             )
 
     # check major version
-    if CachedData.config_version_data["major"] != major:
+    if CachedData.config_version_data[config_path]["major"] != major:
         return False
 
     # check minor version
-    if minor and CachedData.config_version_data["minor"] != minor:
+    if minor and CachedData.config_version_data[config_path]["minor"] != minor:
         return False
 
     # compatible

From 2f89cadd8a82fb1590a2bd064c24ddc27e42e893 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Thu, 21 Sep 2023 17:29:54 +0200
Subject: [PATCH 293/366] hound

---
 openpype/pipeline/colorspace.py | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

diff --git a/openpype/pipeline/colorspace.py b/openpype/pipeline/colorspace.py
index 446849b76e..2dd618a1f2 100644
--- a/openpype/pipeline/colorspace.py
+++ b/openpype/pipeline/colorspace.py
@@ -474,14 +474,16 @@ def compatibility_check_config_version(config_path, major=1, minor=None):
             # TODO: refactor this so it is not imported but part of this file
             from openpype.scripts.ocio_wrapper import _get_version_data
 
-            CachedData.config_version_data[config_path] = _get_version_data(config_path)
+            CachedData.config_version_data[config_path] = \
+                _get_version_data(config_path)
 
         else:
             # python environment is not compatible with PyOpenColorIO
             # needs to be run in subprocess
-            CachedData.config_version_data[config_path] = _get_wrapped_with_subprocess(
-                "config", "get_version", config_path=config_path
-            )
+            CachedData.config_version_data[config_path] = \
+                _get_wrapped_with_subprocess(
+                    "config", "get_version", config_path=config_path
+                )
 
     # check major version
     if CachedData.config_version_data[config_path]["major"] != major:

From da1d62f8931d38b2cae119e655575b67db69dba7 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Thu, 21 Sep 2023 17:31:21 +0200
Subject: [PATCH 294/366] hound

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

diff --git a/openpype/pipeline/colorspace.py b/openpype/pipeline/colorspace.py
index 2dd618a1f2..44cff34c67 100644
--- a/openpype/pipeline/colorspace.py
+++ b/openpype/pipeline/colorspace.py
@@ -483,7 +483,7 @@ def compatibility_check_config_version(config_path, major=1, minor=None):
             CachedData.config_version_data[config_path] = \
                 _get_wrapped_with_subprocess(
                     "config", "get_version", config_path=config_path
-                )
+            )
 
     # check major version
     if CachedData.config_version_data[config_path]["major"] != major:

From 174ef45b0b068ccfc9382a254af64ea0d4c5b009 Mon Sep 17 00:00:00 2001
From: Kayla Man <moonyuet2008@hotmail.com>
Date: Fri, 22 Sep 2023 15:07:58 +0800
Subject: [PATCH 295/366] jakub's comment on apply_settings and fix the bug of
 not being extracted the review

---
 openpype/hosts/nuke/api/plugin.py             | 11 ++-
 ...ov.py => extract_review_baking_streams.py} | 30 +++++++-
 .../nuke/server/settings/publish_plugins.py   | 71 +++++++++++++++++++
 server_addon/nuke/server/version.py           |  2 +-
 4 files changed, 109 insertions(+), 5 deletions(-)
 rename openpype/hosts/nuke/plugins/publish/{extract_review_data_mov.py => extract_review_baking_streams.py} (82%)

diff --git a/openpype/hosts/nuke/api/plugin.py b/openpype/hosts/nuke/api/plugin.py
index adbe43e481..a814615164 100644
--- a/openpype/hosts/nuke/api/plugin.py
+++ b/openpype/hosts/nuke/api/plugin.py
@@ -804,8 +804,13 @@ class ExporterReviewMov(ExporterReview):
         self.log.info("File info was set...")
 
         self.file = self.fhead + self.name + ".{}".format(self.ext)
-        if self.ext != VIDEO_EXTENSIONS:
-            self.file = os.path.basename(self.path_in)
+        if ".{}".format(self.ext) not in VIDEO_EXTENSIONS:
+            filename = os.path.basename(self.path_in)
+            self.file = filename
+            if ".{}".format(self.ext) not in self.file:
+                wrg_ext = filename.split(".")[-1]
+                self.file = filename.replace(wrg_ext, self.ext)
+
         self.path = os.path.join(
             self.staging_dir, self.file).replace("\\", "/")
 
@@ -926,7 +931,7 @@ class ExporterReviewMov(ExporterReview):
         self.log.debug("Path: {}".format(self.path))
         write_node["file"].setValue(str(self.path))
         write_node["file_type"].setValue(str(self.ext))
-
+        self.log.debug("{0}".format(self.ext))
         # Knobs `meta_codec` and `mov64_codec` are not available on centos.
         # TODO shouldn't this come from settings on outputs?
         try:
diff --git a/openpype/hosts/nuke/plugins/publish/extract_review_data_mov.py b/openpype/hosts/nuke/plugins/publish/extract_review_baking_streams.py
similarity index 82%
rename from openpype/hosts/nuke/plugins/publish/extract_review_data_mov.py
rename to openpype/hosts/nuke/plugins/publish/extract_review_baking_streams.py
index 1568a2de9b..59a3f659c9 100644
--- a/openpype/hosts/nuke/plugins/publish/extract_review_data_mov.py
+++ b/openpype/hosts/nuke/plugins/publish/extract_review_baking_streams.py
@@ -16,7 +16,7 @@ class ExtractReviewDataBakingStreams(publish.Extractor):
     """
 
     order = pyblish.api.ExtractorOrder + 0.01
-    label = "Extract Review Data Mov"
+    label = "Extract Review Data Baking Streams"
 
     families = ["review"]
     hosts = ["nuke"]
@@ -25,6 +25,34 @@ class ExtractReviewDataBakingStreams(publish.Extractor):
     viewer_lut_raw = None
     outputs = {}
 
+    @classmethod
+    def apply_settings(cls, project_settings):
+        """just in case there are some old presets
+        in deprecrated ExtractReviewDataMov Plugins
+        """
+        nuke_publish = project_settings["nuke"]["publish"]
+        deprecrated_review_settings = nuke_publish["ExtractReviewDataMov"]
+        current_review_settings = (
+            nuke_publish["ExtractReviewDataBakingStreams"]
+        )
+        if deprecrated_review_settings["viewer_lut_raw"] == (
+            current_review_settings["viewer_lut_raw"]
+        ):
+            cls.viewer_lut_raw = (
+                current_review_settings["viewer_lut_raw"]
+            )
+        else:
+            cls.viewer_lut_raw = (
+                deprecrated_review_settings["viewer_lut_raw"]
+            )
+
+        if deprecrated_review_settings["outputs"] == (
+            current_review_settings["outputs"]
+        ):
+            cls.outputs = current_review_settings["outputs"]
+        else:
+            cls.outputs = deprecrated_review_settings["outputs"]
+
     def process(self, instance):
         families = set(instance.data["families"])
 
diff --git a/server_addon/nuke/server/settings/publish_plugins.py b/server_addon/nuke/server/settings/publish_plugins.py
index 423448219d..6459dd7225 100644
--- a/server_addon/nuke/server/settings/publish_plugins.py
+++ b/server_addon/nuke/server/settings/publish_plugins.py
@@ -165,6 +165,18 @@ class BakingStreamModel(BaseSettingsModel):
         title="Custom tags", default_factory=list)
 
 
+class ExtractReviewDataMovModel(BaseSettingsModel):
+    """[deprecated] use Extract Review Data Baking
+    Streams instead.
+    """
+    enabled: bool = Field(title="Enabled")
+    viewer_lut_raw: bool = Field(title="Viewer lut raw")
+    outputs: list[BakingStreamModel] = Field(
+        default_factory=list,
+        title="Baking streams"
+    )
+
+
 class ExtractReviewBakingStreamsModel(BaseSettingsModel):
     enabled: bool = Field(title="Enabled")
     viewer_lut_raw: bool = Field(title="Viewer lut raw")
@@ -266,6 +278,10 @@ class PublishPuginsModel(BaseSettingsModel):
         title="Extract Review Data Lut",
         default_factory=ExtractReviewDataLutModel
     )
+    ExtractReviewDataMov: ExtractReviewDataMovModel = Field(
+        title="Extract Review Data Mov",
+        default_factory=ExtractReviewDataMovModel
+    )
     ExtractReviewDataBakingStreams: ExtractReviewBakingStreamsModel = Field(
         title="Extract Review Data Baking Streams",
         default_factory=ExtractReviewBakingStreamsModel
@@ -410,6 +426,61 @@ DEFAULT_PUBLISH_PLUGIN_SETTINGS = {
     "ExtractReviewDataLut": {
         "enabled": False
     },
+    "ExtractReviewDataMov": {
+        "enabled": True,
+        "viewer_lut_raw": False,
+        "outputs": [
+            {
+                "name": "baking",
+                "filter": {
+                    "task_types": [],
+                    "product_types": [],
+                    "product_names": []
+                },
+                "read_raw": False,
+                "viewer_process_override": "",
+                "bake_viewer_process": True,
+                "bake_viewer_input_process": True,
+                "reformat_nodes_config": {
+                    "enabled": False,
+                    "reposition_nodes": [
+                        {
+                            "node_class": "Reformat",
+                            "knobs": [
+                                {
+                                    "type": "text",
+                                    "name": "type",
+                                    "text": "to format"
+                                },
+                                {
+                                    "type": "text",
+                                    "name": "format",
+                                    "text": "HD_1080"
+                                },
+                                {
+                                    "type": "text",
+                                    "name": "filter",
+                                    "text": "Lanczos6"
+                                },
+                                {
+                                    "type": "bool",
+                                    "name": "black_outside",
+                                    "boolean": True
+                                },
+                                {
+                                    "type": "bool",
+                                    "name": "pbb",
+                                    "boolean": False
+                                }
+                            ]
+                        }
+                    ]
+                },
+                "extension": "mov",
+                "add_custom_tags": []
+            }
+        ]
+    },
     "ExtractReviewDataBakingStreams": {
         "enabled": True,
         "viewer_lut_raw": False,
diff --git a/server_addon/nuke/server/version.py b/server_addon/nuke/server/version.py
index b3f4756216..ae7362549b 100644
--- a/server_addon/nuke/server/version.py
+++ b/server_addon/nuke/server/version.py
@@ -1 +1 @@
-__version__ = "0.1.2"
+__version__ = "0.1.3"

From 3cf203e46580d88c842bd931177ebdb159690f89 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <43494761+iLLiCiTiT@users.noreply.github.com>
Date: Fri, 22 Sep 2023 10:48:31 +0200
Subject: [PATCH 296/366] AYON settings: Extract OIIO transcode settings
 (#5639)

* added name to ExtractOIIOTranscode output definition

* convert outputs of 'ExtractOIIOTranscode' to 'dict'
---
 openpype/settings/ayon_settings.py            | 23 ++++++++++++++++++-
 .../core/server/settings/publish_plugins.py   |  7 ++++++
 2 files changed, 29 insertions(+), 1 deletion(-)

diff --git a/openpype/settings/ayon_settings.py b/openpype/settings/ayon_settings.py
index 9a4f0607e0..3be8ac8ae5 100644
--- a/openpype/settings/ayon_settings.py
+++ b/openpype/settings/ayon_settings.py
@@ -1102,7 +1102,7 @@ def _convert_global_project_settings(ayon_settings, output, default_settings):
         "studio_name",
         "studio_code",
     ):
-        ayon_core.pop(key)
+        ayon_core.pop(key, None)
 
     # Publish conversion
     ayon_publish = ayon_core["publish"]
@@ -1140,6 +1140,27 @@ def _convert_global_project_settings(ayon_settings, output, default_settings):
 
         profile["outputs"] = new_outputs
 
+    # ExtractOIIOTranscode plugin
+    extract_oiio_transcode = ayon_publish["ExtractOIIOTranscode"]
+    extract_oiio_transcode_profiles = extract_oiio_transcode["profiles"]
+    for profile in extract_oiio_transcode_profiles:
+        new_outputs = {}
+        name_counter = {}
+        for output in profile["outputs"]:
+            if "name" in output:
+                name = output.pop("name")
+            else:
+                # Backwards compatibility for setting without 'name' in model
+                name = output["extension"]
+                if name in new_outputs:
+                    name_counter[name] += 1
+                    name = "{}_{}".format(name, name_counter[name])
+                else:
+                    name_counter[name] = 0
+
+            new_outputs[name] = output
+        profile["outputs"] = new_outputs
+
     # Extract Burnin plugin
     extract_burnin = ayon_publish["ExtractBurnin"]
     extract_burnin_options = extract_burnin["options"]
diff --git a/server_addon/core/server/settings/publish_plugins.py b/server_addon/core/server/settings/publish_plugins.py
index c012312579..69a759465e 100644
--- a/server_addon/core/server/settings/publish_plugins.py
+++ b/server_addon/core/server/settings/publish_plugins.py
@@ -116,6 +116,8 @@ class OIIOToolArgumentsModel(BaseSettingsModel):
 
 
 class ExtractOIIOTranscodeOutputModel(BaseSettingsModel):
+    _layout = "expanded"
+    name: str = Field("", title="Name")
     extension: str = Field("", title="Extension")
     transcoding_type: str = Field(
         "colorspace",
@@ -164,6 +166,11 @@ class ExtractOIIOTranscodeProfileModel(BaseSettingsModel):
         title="Output Definitions",
     )
 
+    @validator("outputs")
+    def validate_unique_outputs(cls, value):
+        ensure_unique_names(value)
+        return value
+
 
 class ExtractOIIOTranscodeModel(BaseSettingsModel):
     enabled: bool = Field(True)

From 87ed2f960daa97d4d94b73403c5076519bf6b20c Mon Sep 17 00:00:00 2001
From: Jakub Trllo <43494761+iLLiCiTiT@users.noreply.github.com>
Date: Fri, 22 Sep 2023 11:47:39 +0200
Subject: [PATCH 297/366] Launcher tool: Refactor launcher tool (for AYON)
 (#5612)

* added helper classes to utils

* implemented base of ayon utils

* initial commit for launcher tool

* use image for extender

* actions are shown and can be triggered

* fix actions on finished refresh

* refresh automatically

* fix re-refreshing of projects model

* added page slide animation

* updated abstrack classes

* change how icon is prepared

* fix actions sorting

* show messages like in launcher tool

* do not clear items on refresh

* stop refresh timer only on close event

* use Ynput/AYON for local settings json

* register default actions in launcher action module

* change register naming

* move 'SquareButton' to utils widgets

* removed duplicated method

* removed unused variable

* removed unused import

* don't use lambda

* swap default name for 'OpenPypeSettingsRegistry'

* Change support version
---
 openpype/lib/local_settings.py                |  14 +-
 openpype/modules/launcher_action.py           |  73 ++-
 openpype/pipeline/actions.py                  |   8 +-
 openpype/tools/ayon_launcher/abstract.py      | 297 ++++++++++
 openpype/tools/ayon_launcher/control.py       | 149 ++++++
 .../tools/ayon_launcher/models/__init__.py    |   8 +
 .../tools/ayon_launcher/models/actions.py     | 505 ++++++++++++++++++
 .../tools/ayon_launcher/models/selection.py   |  72 +++
 openpype/tools/ayon_launcher/ui/__init__.py   |   6 +
 .../tools/ayon_launcher/ui/actions_widget.py  | 453 ++++++++++++++++
 .../tools/ayon_launcher/ui/hierarchy_page.py  | 102 ++++
 .../tools/ayon_launcher/ui/projects_widget.py | 135 +++++
 .../ayon_launcher/ui/resources/__init__.py    |   7 +
 .../ayon_launcher/ui/resources/options.png    | Bin 0 -> 1772 bytes
 openpype/tools/ayon_launcher/ui/window.py     | 295 ++++++++++
 openpype/tools/ayon_utils/models/__init__.py  |  29 +
 openpype/tools/ayon_utils/models/cache.py     | 196 +++++++
 openpype/tools/ayon_utils/models/hierarchy.py | 340 ++++++++++++
 openpype/tools/ayon_utils/models/projects.py  | 145 +++++
 openpype/tools/ayon_utils/widgets/__init__.py |  37 ++
 .../ayon_utils/widgets/folders_widget.py      | 364 +++++++++++++
 .../ayon_utils/widgets/projects_widget.py     | 325 +++++++++++
 .../tools/ayon_utils/widgets/tasks_widget.py  | 436 +++++++++++++++
 openpype/tools/ayon_utils/widgets/utils.py    |  98 ++++
 openpype/tools/launcher/actions.py            |  44 +-
 openpype/tools/utils/__init__.py              |   9 +
 openpype/tools/utils/widgets.py               |  79 ++-
 27 files changed, 4158 insertions(+), 68 deletions(-)
 create mode 100644 openpype/tools/ayon_launcher/abstract.py
 create mode 100644 openpype/tools/ayon_launcher/control.py
 create mode 100644 openpype/tools/ayon_launcher/models/__init__.py
 create mode 100644 openpype/tools/ayon_launcher/models/actions.py
 create mode 100644 openpype/tools/ayon_launcher/models/selection.py
 create mode 100644 openpype/tools/ayon_launcher/ui/__init__.py
 create mode 100644 openpype/tools/ayon_launcher/ui/actions_widget.py
 create mode 100644 openpype/tools/ayon_launcher/ui/hierarchy_page.py
 create mode 100644 openpype/tools/ayon_launcher/ui/projects_widget.py
 create mode 100644 openpype/tools/ayon_launcher/ui/resources/__init__.py
 create mode 100644 openpype/tools/ayon_launcher/ui/resources/options.png
 create mode 100644 openpype/tools/ayon_launcher/ui/window.py
 create mode 100644 openpype/tools/ayon_utils/models/__init__.py
 create mode 100644 openpype/tools/ayon_utils/models/cache.py
 create mode 100644 openpype/tools/ayon_utils/models/hierarchy.py
 create mode 100644 openpype/tools/ayon_utils/models/projects.py
 create mode 100644 openpype/tools/ayon_utils/widgets/__init__.py
 create mode 100644 openpype/tools/ayon_utils/widgets/folders_widget.py
 create mode 100644 openpype/tools/ayon_utils/widgets/projects_widget.py
 create mode 100644 openpype/tools/ayon_utils/widgets/tasks_widget.py
 create mode 100644 openpype/tools/ayon_utils/widgets/utils.py

diff --git a/openpype/lib/local_settings.py b/openpype/lib/local_settings.py
index 3fb35a7e7b..dae6e074af 100644
--- a/openpype/lib/local_settings.py
+++ b/openpype/lib/local_settings.py
@@ -494,10 +494,18 @@ class OpenPypeSettingsRegistry(JSONSettingRegistry):
     """
 
     def __init__(self, name=None):
-        self.vendor = "pypeclub"
-        self.product = "openpype"
+        if AYON_SERVER_ENABLED:
+            vendor = "Ynput"
+            product = "AYON"
+            default_name = "AYON_settings"
+        else:
+            vendor = "pypeclub"
+            product = "openpype"
+            default_name = "openpype_settings"
+        self.vendor = vendor
+        self.product = product
         if not name:
-            name = "openpype_settings"
+            name = default_name
         path = appdirs.user_data_dir(self.product, self.vendor)
         super(OpenPypeSettingsRegistry, self).__init__(name, path)
 
diff --git a/openpype/modules/launcher_action.py b/openpype/modules/launcher_action.py
index c4331b6094..5e14f25f76 100644
--- a/openpype/modules/launcher_action.py
+++ b/openpype/modules/launcher_action.py
@@ -1,3 +1,6 @@
+import os
+
+from openpype import PLUGINS_DIR, AYON_SERVER_ENABLED
 from openpype.modules import (
     OpenPypeModule,
     ITrayAction,
@@ -13,36 +16,66 @@ class LauncherAction(OpenPypeModule, ITrayAction):
         self.enabled = True
 
         # Tray attributes
-        self.window = None
+        self._window = None
 
     def tray_init(self):
-        self.create_window()
+        self._create_window()
 
-        self.add_doubleclick_callback(self.show_launcher)
+        self.add_doubleclick_callback(self._show_launcher)
 
     def tray_start(self):
         return
 
     def connect_with_modules(self, enabled_modules):
         # Register actions
-        if self.tray_initialized:
-            from openpype.tools.launcher import actions
-            actions.register_config_actions()
-            actions_paths = self.manager.collect_plugin_paths()["actions"]
-            actions.register_actions_from_paths(actions_paths)
-            actions.register_environment_actions()
-
-    def create_window(self):
-        if self.window:
+        if not self.tray_initialized:
             return
-        from openpype.tools.launcher import LauncherWindow
-        self.window = LauncherWindow()
+
+        from openpype.pipeline.actions import register_launcher_action_path
+
+        actions_dir = os.path.join(PLUGINS_DIR, "actions")
+        if os.path.exists(actions_dir):
+            register_launcher_action_path(actions_dir)
+
+        actions_paths = self.manager.collect_plugin_paths()["actions"]
+        for path in actions_paths:
+            if path and os.path.exists(path):
+                register_launcher_action_path(actions_dir)
+
+        paths_str = os.environ.get("AVALON_ACTIONS") or ""
+        if paths_str:
+            self.log.warning(
+                "WARNING: 'AVALON_ACTIONS' is deprecated. Support of this"
+                " environment variable will be removed in future versions."
+                " Please consider using 'OpenPypeModule' to define custom"
+                " action paths. Planned version to drop the support"
+                " is 3.17.2 or 3.18.0 ."
+            )
+
+        for path in paths_str.split(os.pathsep):
+            if path and os.path.exists(path):
+                register_launcher_action_path(path)
 
     def on_action_trigger(self):
-        self.show_launcher()
+        """Implementation for ITrayAction interface.
 
-    def show_launcher(self):
-        if self.window:
-            self.window.show()
-            self.window.raise_()
-            self.window.activateWindow()
+        Show launcher tool on action trigger.
+        """
+
+        self._show_launcher()
+
+    def _create_window(self):
+        if self._window:
+            return
+        if AYON_SERVER_ENABLED:
+            from openpype.tools.ayon_launcher.ui import LauncherWindow
+        else:
+            from openpype.tools.launcher import LauncherWindow
+        self._window = LauncherWindow()
+
+    def _show_launcher(self):
+        if self._window is None:
+            return
+        self._window.show()
+        self._window.raise_()
+        self._window.activateWindow()
diff --git a/openpype/pipeline/actions.py b/openpype/pipeline/actions.py
index b488fe3e1f..feb1bd05d2 100644
--- a/openpype/pipeline/actions.py
+++ b/openpype/pipeline/actions.py
@@ -20,7 +20,13 @@ class LauncherAction(object):
     log.propagate = True
 
     def is_compatible(self, session):
-        """Return whether the class is compatible with the Session."""
+        """Return whether the class is compatible with the Session.
+
+        Args:
+            session (dict[str, Union[str, None]]): Session data with
+                AVALON_PROJECT, AVALON_ASSET and AVALON_TASK.
+        """
+
         return True
 
     def process(self, session, **kwargs):
diff --git a/openpype/tools/ayon_launcher/abstract.py b/openpype/tools/ayon_launcher/abstract.py
new file mode 100644
index 0000000000..00502fe930
--- /dev/null
+++ b/openpype/tools/ayon_launcher/abstract.py
@@ -0,0 +1,297 @@
+from abc import ABCMeta, abstractmethod
+
+import six
+
+
+@six.add_metaclass(ABCMeta)
+class AbstractLauncherCommon(object):
+    @abstractmethod
+    def register_event_callback(self, topic, callback):
+        """Register event callback.
+
+        Listen for events with given topic.
+
+        Args:
+            topic (str): Name of topic.
+            callback (Callable): Callback that will be called when event
+                is triggered.
+        """
+
+        pass
+
+
+class AbstractLauncherBackend(AbstractLauncherCommon):
+    @abstractmethod
+    def emit_event(self, topic, data=None, source=None):
+        """Emit event.
+
+        Args:
+            topic (str): Event topic used for callbacks filtering.
+            data (Optional[dict[str, Any]]): Event data.
+            source (Optional[str]): Event source.
+        """
+
+        pass
+
+    @abstractmethod
+    def get_project_settings(self, project_name):
+        """Project settings for current project.
+
+        Args:
+            project_name (Union[str, None]): Project name.
+
+        Returns:
+            dict[str, Any]: Project settings.
+        """
+
+        pass
+
+    @abstractmethod
+    def get_project_entity(self, project_name):
+        """Get project entity by name.
+
+        Args:
+            project_name (str): Project name.
+
+        Returns:
+            dict[str, Any]: Project entity data.
+        """
+
+        pass
+
+    @abstractmethod
+    def get_folder_entity(self, project_name, folder_id):
+        """Get folder entity by id.
+
+        Args:
+            project_name (str): Project name.
+            folder_id (str): Folder id.
+
+        Returns:
+            dict[str, Any]: Folder entity data.
+        """
+
+        pass
+
+    @abstractmethod
+    def get_task_entity(self, project_name, task_id):
+        """Get task entity by id.
+
+        Args:
+            project_name (str): Project name.
+            task_id (str): Task id.
+
+        Returns:
+            dict[str, Any]: Task entity data.
+        """
+
+        pass
+
+
+class AbstractLauncherFrontEnd(AbstractLauncherCommon):
+    # Entity items for UI
+    @abstractmethod
+    def get_project_items(self, sender=None):
+        """Project items for all projects.
+
+        This function may trigger events 'projects.refresh.started' and
+        'projects.refresh.finished' which will contain 'sender' value in data.
+        That may help to avoid re-refresh of project items in UI elements.
+
+        Args:
+            sender (str): Who requested folder items.
+
+        Returns:
+            list[ProjectItem]: Minimum possible information needed
+                for visualisation of folder hierarchy.
+        """
+
+        pass
+
+    @abstractmethod
+    def get_folder_items(self, project_name, sender=None):
+        """Folder items to visualize project hierarchy.
+
+        This function may trigger events 'folders.refresh.started' and
+        'folders.refresh.finished' which will contain 'sender' value in data.
+        That may help to avoid re-refresh of folder items in UI elements.
+
+        Args:
+            project_name (str): Project name.
+            sender (str): Who requested folder items.
+
+        Returns:
+            list[FolderItem]: Minimum possible information needed
+                for visualisation of folder hierarchy.
+        """
+
+        pass
+
+    @abstractmethod
+    def get_task_items(self, project_name, folder_id, sender=None):
+        """Task items.
+
+        This function may trigger events 'tasks.refresh.started' and
+        'tasks.refresh.finished' which will contain 'sender' value in data.
+        That may help to avoid re-refresh of task items in UI elements.
+
+        Args:
+            project_name (str): Project name.
+            folder_id (str): Folder ID for which are tasks requested.
+            sender (str): Who requested folder items.
+
+        Returns:
+            list[TaskItem]: Minimum possible information needed
+                for visualisation of tasks.
+        """
+
+        pass
+
+    @abstractmethod
+    def get_selected_project_name(self):
+        """Selected project name.
+
+        Returns:
+            Union[str, None]: Selected project name.
+        """
+
+        pass
+
+    @abstractmethod
+    def get_selected_folder_id(self):
+        """Selected folder id.
+
+        Returns:
+            Union[str, None]: Selected folder id.
+        """
+
+        pass
+
+    @abstractmethod
+    def get_selected_task_id(self):
+        """Selected task id.
+
+        Returns:
+            Union[str, None]: Selected task id.
+        """
+
+        pass
+
+    @abstractmethod
+    def get_selected_task_name(self):
+        """Selected task name.
+
+        Returns:
+            Union[str, None]: Selected task name.
+        """
+
+        pass
+
+    @abstractmethod
+    def get_selected_context(self):
+        """Get whole selected context.
+
+        Example:
+            {
+                "project_name": self.get_selected_project_name(),
+                "folder_id": self.get_selected_folder_id(),
+                "task_id": self.get_selected_task_id(),
+                "task_name": self.get_selected_task_name(),
+            }
+
+        Returns:
+            dict[str, Union[str, None]]: Selected context.
+        """
+
+        pass
+
+    @abstractmethod
+    def set_selected_project(self, project_name):
+        """Change selected folder.
+
+        Args:
+            project_name (Union[str, None]): Project nameor None if no project
+                is selected.
+        """
+
+        pass
+
+    @abstractmethod
+    def set_selected_folder(self, folder_id):
+        """Change selected folder.
+
+        Args:
+            folder_id (Union[str, None]): Folder id or None if no folder
+                is selected.
+        """
+
+        pass
+
+    @abstractmethod
+    def set_selected_task(self, task_id, task_name):
+        """Change selected task.
+
+        Args:
+            task_id (Union[str, None]): Task id or None if no task
+                is selected.
+            task_name (Union[str, None]): Task name or None if no task
+                is selected.
+        """
+
+        pass
+
+    # Actions
+    @abstractmethod
+    def get_action_items(self, project_name, folder_id, task_id):
+        """Get action items for given context.
+
+        Args:
+            project_name (Union[str, None]): Project name.
+            folder_id (Union[str, None]): Folder id.
+            task_id (Union[str, None]): Task id.
+
+        Returns:
+            list[ActionItem]: List of action items that should be shown
+                for given context.
+        """
+
+        pass
+
+    @abstractmethod
+    def trigger_action(self, project_name, folder_id, task_id, action_id):
+        """Trigger action on given context.
+
+        Args:
+            project_name (Union[str, None]): Project name.
+            folder_id (Union[str, None]): Folder id.
+            task_id (Union[str, None]): Task id.
+            action_id (str): Action identifier.
+        """
+
+        pass
+
+    @abstractmethod
+    def set_application_force_not_open_workfile(
+        self, project_name, folder_id, task_id, action_id, enabled
+    ):
+        """This is application action related to force not open last workfile.
+
+        Args:
+            project_name (Union[str, None]): Project name.
+            folder_id (Union[str, None]): Folder id.
+            task_id (Union[str, None]): Task id.
+            action_id (str): Action identifier.
+            enabled (bool): New value of force not open workfile.
+        """
+
+        pass
+
+    @abstractmethod
+    def refresh(self):
+        """Refresh everything, models, ui etc.
+
+        Triggers 'controller.refresh.started' event at the beginning and
+        'controller.refresh.finished' at the end.
+        """
+
+        pass
diff --git a/openpype/tools/ayon_launcher/control.py b/openpype/tools/ayon_launcher/control.py
new file mode 100644
index 0000000000..09e07893c3
--- /dev/null
+++ b/openpype/tools/ayon_launcher/control.py
@@ -0,0 +1,149 @@
+from openpype.lib import Logger
+from openpype.lib.events import QueuedEventSystem
+from openpype.settings import get_project_settings
+from openpype.tools.ayon_utils.models import ProjectsModel, HierarchyModel
+
+from .abstract import AbstractLauncherFrontEnd, AbstractLauncherBackend
+from .models import LauncherSelectionModel, ActionsModel
+
+
+class BaseLauncherController(
+    AbstractLauncherFrontEnd, AbstractLauncherBackend
+):
+    def __init__(self):
+        self._project_settings = {}
+        self._event_system = None
+        self._log = None
+
+        self._selection_model = LauncherSelectionModel(self)
+        self._projects_model = ProjectsModel(self)
+        self._hierarchy_model = HierarchyModel(self)
+        self._actions_model = ActionsModel(self)
+
+    @property
+    def log(self):
+        if self._log is None:
+            self._log = Logger.get_logger(self.__class__.__name__)
+        return self._log
+
+    @property
+    def event_system(self):
+        """Inner event system for workfiles tool controller.
+
+        Is used for communication with UI. Event system is created on demand.
+
+        Returns:
+            QueuedEventSystem: Event system which can trigger callbacks
+                for topics.
+        """
+
+        if self._event_system is None:
+            self._event_system = QueuedEventSystem()
+        return self._event_system
+
+    # ---------------------------------
+    # Implementation of abstract methods
+    # ---------------------------------
+    # Events system
+    def emit_event(self, topic, data=None, source=None):
+        """Use implemented event system to trigger event."""
+
+        if data is None:
+            data = {}
+        self.event_system.emit(topic, data, source)
+
+    def register_event_callback(self, topic, callback):
+        self.event_system.add_callback(topic, callback)
+
+    # Entity items for UI
+    def get_project_items(self, sender=None):
+        return self._projects_model.get_project_items(sender)
+
+    def get_folder_items(self, project_name, sender=None):
+        return self._hierarchy_model.get_folder_items(project_name, sender)
+
+    def get_task_items(self, project_name, folder_id, sender=None):
+        return self._hierarchy_model.get_task_items(
+            project_name, folder_id, sender)
+
+    # Project settings for applications actions
+    def get_project_settings(self, project_name):
+        if project_name in self._project_settings:
+            return self._project_settings[project_name]
+        settings = get_project_settings(project_name)
+        self._project_settings[project_name] = settings
+        return settings
+
+    # Entity for backend
+    def get_project_entity(self, project_name):
+        return self._projects_model.get_project_entity(project_name)
+
+    def get_folder_entity(self, project_name, folder_id):
+        return self._hierarchy_model.get_folder_entity(
+            project_name, folder_id)
+
+    def get_task_entity(self, project_name, task_id):
+        return self._hierarchy_model.get_task_entity(project_name, task_id)
+
+    # Selection methods
+    def get_selected_project_name(self):
+        return self._selection_model.get_selected_project_name()
+
+    def set_selected_project(self, project_name):
+        self._selection_model.set_selected_project(project_name)
+
+    def get_selected_folder_id(self):
+        return self._selection_model.get_selected_folder_id()
+
+    def set_selected_folder(self, folder_id):
+        self._selection_model.set_selected_folder(folder_id)
+
+    def get_selected_task_id(self):
+        return self._selection_model.get_selected_task_id()
+
+    def get_selected_task_name(self):
+        return self._selection_model.get_selected_task_name()
+
+    def set_selected_task(self, task_id, task_name):
+        self._selection_model.set_selected_task(task_id, task_name)
+
+    def get_selected_context(self):
+        return {
+            "project_name": self.get_selected_project_name(),
+            "folder_id": self.get_selected_folder_id(),
+            "task_id": self.get_selected_task_id(),
+            "task_name": self.get_selected_task_name(),
+        }
+
+    # Actions
+    def get_action_items(self, project_name, folder_id, task_id):
+        return self._actions_model.get_action_items(
+            project_name, folder_id, task_id)
+
+    def set_application_force_not_open_workfile(
+        self, project_name, folder_id, task_id, action_id, enabled
+    ):
+        self._actions_model.set_application_force_not_open_workfile(
+            project_name, folder_id, task_id, action_id, enabled
+        )
+
+    def trigger_action(self, project_name, folder_id, task_id, identifier):
+        self._actions_model.trigger_action(
+            project_name, folder_id, task_id, identifier)
+
+    # General methods
+    def refresh(self):
+        self._emit_event("controller.refresh.started")
+
+        self._project_settings = {}
+
+        self._projects_model.reset()
+        self._hierarchy_model.reset()
+
+        self._actions_model.refresh()
+        self._projects_model.refresh()
+
+        self._emit_event("controller.refresh.finished")
+
+    def _emit_event(self, topic, data=None):
+        self.emit_event(topic, data, "controller")
diff --git a/openpype/tools/ayon_launcher/models/__init__.py b/openpype/tools/ayon_launcher/models/__init__.py
new file mode 100644
index 0000000000..1bc60c85f0
--- /dev/null
+++ b/openpype/tools/ayon_launcher/models/__init__.py
@@ -0,0 +1,8 @@
+from .actions import ActionsModel
+from .selection import LauncherSelectionModel
+
+
+__all__ = (
+    "ActionsModel",
+    "LauncherSelectionModel",
+)
diff --git a/openpype/tools/ayon_launcher/models/actions.py b/openpype/tools/ayon_launcher/models/actions.py
new file mode 100644
index 0000000000..24fea44db2
--- /dev/null
+++ b/openpype/tools/ayon_launcher/models/actions.py
@@ -0,0 +1,505 @@
+import os
+
+from openpype import resources
+from openpype.lib import Logger, OpenPypeSettingsRegistry
+from openpype.pipeline.actions import (
+    discover_launcher_actions,
+    LauncherAction,
+)
+
+
+# class Action:
+#     def __init__(self, label, icon=None, identifier=None):
+#         self._label = label
+#         self._icon = icon
+#         self._callbacks = []
+#         self._identifier = identifier or uuid.uuid4().hex
+#         self._checked = True
+#         self._checkable = False
+#
+#     def set_checked(self, checked):
+#         self._checked = checked
+#
+#     def set_checkable(self, checkable):
+#         self._checkable = checkable
+#
+#     def set_label(self, label):
+#         self._label = label
+#
+#     def add_callback(self, callback):
+#         self._callbacks = callback
+#
+#
+# class Menu:
+#     def __init__(self, label, icon=None):
+#         self.label = label
+#         self.icon = icon
+#         self._actions = []
+#
+#     def add_action(self, action):
+#         self._actions.append(action)
+
+
+class ApplicationAction(LauncherAction):
+    """Action to launch an application.
+
+    Application action based on 'ApplicationManager' system.
+
+    Handling of applications in launcher is not ideal and should be completely
+    redone from scratch. This is just a temporary solution to keep backwards
+    compatibility with OpenPype launcher.
+
+    Todos:
+        Move handling of errors to frontend.
+    """
+
+    # Application object
+    application = None
+    # Action attributes
+    name = None
+    label = None
+    label_variant = None
+    group = None
+    icon = None
+    color = None
+    order = 0
+    data = {}
+    project_settings = {}
+    project_entities = {}
+
+    _log = None
+    required_session_keys = (
+        "AVALON_PROJECT",
+        "AVALON_ASSET",
+        "AVALON_TASK"
+    )
+
+    @property
+    def log(self):
+        if self._log is None:
+            self._log = Logger.get_logger(self.__class__.__name__)
+        return self._log
+
+    def is_compatible(self, session):
+        for key in self.required_session_keys:
+            if not session.get(key):
+                return False
+
+        project_name = session["AVALON_PROJECT"]
+        project_entity = self.project_entities[project_name]
+        apps = project_entity["attrib"].get("applications")
+        if not apps or self.application.full_name not in apps:
+            return False
+
+        project_settings = self.project_settings[project_name]
+        only_available = project_settings["applications"]["only_available"]
+        if only_available and not self.application.find_executable():
+            return False
+        return True
+
+    def _show_message_box(self, title, message, details=None):
+        from qtpy import QtWidgets, QtGui
+        from openpype import style
+
+        dialog = QtWidgets.QMessageBox()
+        icon = QtGui.QIcon(resources.get_openpype_icon_filepath())
+        dialog.setWindowIcon(icon)
+        dialog.setStyleSheet(style.load_stylesheet())
+        dialog.setWindowTitle(title)
+        dialog.setText(message)
+        if details:
+            dialog.setDetailedText(details)
+        dialog.exec_()
+
+    def process(self, session, **kwargs):
+        """Process the full Application action"""
+
+        from openpype.lib import (
+            ApplictionExecutableNotFound,
+            ApplicationLaunchFailed,
+        )
+
+        project_name = session["AVALON_PROJECT"]
+        asset_name = session["AVALON_ASSET"]
+        task_name = session["AVALON_TASK"]
+        try:
+            self.application.launch(
+                project_name=project_name,
+                asset_name=asset_name,
+                task_name=task_name,
+                **self.data
+            )
+
+        except ApplictionExecutableNotFound as exc:
+            details = exc.details
+            msg = exc.msg
+            log_msg = str(msg)
+            if details:
+                log_msg += "\n" + details
+            self.log.warning(log_msg)
+            self._show_message_box(
+                "Application executable not found", msg, details
+            )
+
+        except ApplicationLaunchFailed as exc:
+            msg = str(exc)
+            self.log.warning(msg, exc_info=True)
+            self._show_message_box("Application launch failed", msg)
+
+
+class ActionItem:
+    """Item representing single action to trigger.
+
+    Todos:
+        Get rid of application specific logic.
+
+    Args:
+        identifier (str): Unique identifier of action item.
+        label (str): Action label.
+        variant_label (Union[str, None]): Variant label, full label is
+            concatenated with space. Actions are grouped under single
+            action if it has same 'label' and have set 'variant_label'.
+        icon (dict[str, str]): Icon definition.
+        order (int): Action ordering.
+        is_application (bool): Is action application action.
+        force_not_open_workfile (bool): Force not open workfile. Application
+            related.
+        full_label (Optional[str]): Full label, if not set it is generated
+            from 'label' and 'variant_label'.
+    """
+
+    def __init__(
+        self,
+        identifier,
+        label,
+        variant_label,
+        icon,
+        order,
+        is_application,
+        force_not_open_workfile,
+        full_label=None
+    ):
+        self.identifier = identifier
+        self.label = label
+        self.variant_label = variant_label
+        self.icon = icon
+        self.order = order
+        self.is_application = is_application
+        self.force_not_open_workfile = force_not_open_workfile
+        self._full_label = full_label
+
+    def copy(self):
+        return self.from_data(self.to_data())
+
+    @property
+    def full_label(self):
+        if self._full_label is None:
+            if self.variant_label:
+                self._full_label = " ".join([self.label, self.variant_label])
+            else:
+                self._full_label = self.label
+        return self._full_label
+
+    def to_data(self):
+        return {
+            "identifier": self.identifier,
+            "label": self.label,
+            "variant_label": self.variant_label,
+            "icon": self.icon,
+            "order": self.order,
+            "is_application": self.is_application,
+            "force_not_open_workfile": self.force_not_open_workfile,
+            "full_label": self._full_label,
+        }
+
+    @classmethod
+    def from_data(cls, data):
+        return cls(**data)
+
+
+def get_action_icon(action):
+    """Get action icon info.
+
+    Args:
+        action (LacunherAction): Action instance.
+
+    Returns:
+        dict[str, str]: Icon info.
+    """
+
+    icon = action.icon
+    if not icon:
+        return {
+            "type": "awesome-font",
+            "name": "fa.cube",
+            "color": "white"
+        }
+
+    if isinstance(icon, dict):
+        return icon
+
+    icon_path = resources.get_resource(icon)
+    if not os.path.exists(icon_path):
+        try:
+            icon_path = icon.format(resources.RESOURCES_DIR)
+        except Exception:
+            pass
+
+    if os.path.exists(icon_path):
+        return {
+            "type": "path",
+            "path": icon_path,
+        }
+
+    return {
+        "type": "awesome-font",
+        "name": icon,
+        "color": action.color or "white"
+    }
+
+
+class ActionsModel:
+    """Actions model.
+
+    Args:
+        controller (AbstractLauncherBackend): Controller instance.
+    """
+
+    _not_open_workfile_reg_key = "force_not_open_workfile"
+
+    def __init__(self, controller):
+        self._controller = controller
+
+        self._log = None
+
+        self._discovered_actions = None
+        self._actions = None
+        self._action_items = {}
+
+        self._launcher_tool_reg = OpenPypeSettingsRegistry("launcher_tool")
+
+    @property
+    def log(self):
+        if self._log is None:
+            self._log = Logger.get_logger(self.__class__.__name__)
+        return self._log
+
+    def refresh(self):
+        self._discovered_actions = None
+        self._actions = None
+        self._action_items = {}
+
+        self._controller.emit_event("actions.refresh.started")
+        self._get_action_objects()
+        self._controller.emit_event("actions.refresh.finished")
+
+    def get_action_items(self, project_name, folder_id, task_id):
+        """Get actions for project.
+
+        Args:
+            project_name (Union[str, None]): Project name.
+            folder_id (Union[str, None]): Folder id.
+            task_id (Union[str, None]): Task id.
+
+        Returns:
+            list[ActionItem]: List of actions.
+        """
+
+        not_open_workfile_actions = self._get_no_last_workfile_for_context(
+            project_name, folder_id, task_id)
+        session = self._prepare_session(project_name, folder_id, task_id)
+        output = []
+        action_items = self._get_action_items(project_name)
+        for identifier, action in self._get_action_objects().items():
+            if not action.is_compatible(session):
+                continue
+
+            action_item = action_items[identifier]
+            # Handling of 'force_not_open_workfile' for applications
+            if action_item.is_application:
+                action_item = action_item.copy()
+                action_item.force_not_open_workfile = (
+                    not_open_workfile_actions.get(identifier, False)
+                )
+
+            output.append(action_item)
+        return output
+
+    def set_application_force_not_open_workfile(
+        self, project_name, folder_id, task_id, action_id, enabled
+    ):
+        no_workfile_reg_data = self._get_no_last_workfile_reg_data()
+        project_data = no_workfile_reg_data.setdefault(project_name, {})
+        folder_data = project_data.setdefault(folder_id, {})
+        task_data = folder_data.setdefault(task_id, {})
+        task_data[action_id] = enabled
+        self._launcher_tool_reg.set_item(
+            self._not_open_workfile_reg_key, no_workfile_reg_data
+        )
+
+    def trigger_action(self, project_name, folder_id, task_id, identifier):
+        session = self._prepare_session(project_name, folder_id, task_id)
+        failed = False
+        error_message = None
+        action_label = identifier
+        action_items = self._get_action_items(project_name)
+        try:
+            action = self._actions[identifier]
+            action_item = action_items[identifier]
+            action_label = action_item.full_label
+            self._controller.emit_event(
+                "action.trigger.started",
+                {
+                    "identifier": identifier,
+                    "full_label": action_label,
+                }
+            )
+            if isinstance(action, ApplicationAction):
+                per_action = self._get_no_last_workfile_for_context(
+                    project_name, folder_id, task_id
+                )
+                force_not_open_workfile = per_action.get(identifier, False)
+                action.data["start_last_workfile"] = force_not_open_workfile
+            action.process(session)
+        except Exception as exc:
+            self.log.warning("Action trigger failed.", exc_info=True)
+            failed = True
+            error_message = str(exc)
+
+        self._controller.emit_event(
+            "action.trigger.finished",
+            {
+                "identifier": identifier,
+                "failed": failed,
+                "error_message": error_message,
+                "full_label": action_label,
+            }
+        )
+
+    def _get_no_last_workfile_reg_data(self):
+        try:
+            no_workfile_reg_data = self._launcher_tool_reg.get_item(
+                self._not_open_workfile_reg_key)
+        except ValueError:
+            no_workfile_reg_data = {}
+            self._launcher_tool_reg.set_item(
+                self._not_open_workfile_reg_key, no_workfile_reg_data)
+        return no_workfile_reg_data
+
+    def _get_no_last_workfile_for_context(
+        self, project_name, folder_id, task_id
+    ):
+        not_open_workfile_reg_data = self._get_no_last_workfile_reg_data()
+        return (
+            not_open_workfile_reg_data
+            .get(project_name, {})
+            .get(folder_id, {})
+            .get(task_id, {})
+        )
+
+    def _prepare_session(self, project_name, folder_id, task_id):
+        folder_name = None
+        if folder_id:
+            folder = self._controller.get_folder_entity(
+                project_name, folder_id)
+            if folder:
+                folder_name = folder["name"]
+
+        task_name = None
+        if task_id:
+            task = self._controller.get_task_entity(project_name, task_id)
+            if task:
+                task_name = task["name"]
+
+        return {
+            "AVALON_PROJECT": project_name,
+            "AVALON_ASSET": folder_name,
+            "AVALON_TASK": task_name,
+        }
+
+    def _get_discovered_action_classes(self):
+        if self._discovered_actions is None:
+            self._discovered_actions = (
+                discover_launcher_actions()
+                + self._get_applications_action_classes()
+            )
+        return self._discovered_actions
+
+    def _get_action_objects(self):
+        if self._actions is None:
+            actions = {}
+            for cls in self._get_discovered_action_classes():
+                obj = cls()
+                identifier = getattr(obj, "identifier", None)
+                if identifier is None:
+                    identifier = cls.__name__
+                actions[identifier] = obj
+            self._actions = actions
+        return self._actions
+
+    def _get_action_items(self, project_name):
+        action_items = self._action_items.get(project_name)
+        if action_items is not None:
+            return action_items
+
+        project_entity = None
+        if project_name:
+            project_entity = self._controller.get_project_entity(project_name)
+        project_settings = self._controller.get_project_settings(project_name)
+
+        action_items = {}
+        for identifier, action in self._get_action_objects().items():
+            is_application = isinstance(action, ApplicationAction)
+            if is_application:
+                action.project_entities[project_name] = project_entity
+                action.project_settings[project_name] = project_settings
+            label = action.label or identifier
+            variant_label = getattr(action, "label_variant", None)
+            icon = get_action_icon(action)
+            item = ActionItem(
+                identifier,
+                label,
+                variant_label,
+                icon,
+                action.order,
+                is_application,
+                False
+            )
+            action_items[identifier] = item
+        self._action_items[project_name] = action_items
+        return action_items
+
+    def _get_applications_action_classes(self):
+        from openpype.lib.applications import (
+            CUSTOM_LAUNCH_APP_GROUPS,
+            ApplicationManager,
+        )
+
+        actions = []
+
+        manager = ApplicationManager()
+        for full_name, application in manager.applications.items():
+            if (
+                application.group.name in CUSTOM_LAUNCH_APP_GROUPS
+                or not application.enabled
+            ):
+                continue
+
+            action = type(
+                "app_{}".format(full_name),
+                (ApplicationAction,),
+                {
+                    "identifier": "application.{}".format(full_name),
+                    "application": application,
+                    "name": application.name,
+                    "label": application.group.label,
+                    "label_variant": application.label,
+                    "group": None,
+                    "icon": application.icon,
+                    "color": getattr(application, "color", None),
+                    "order": getattr(application, "order", None) or 0,
+                    "data": {}
+                }
+            )
+            actions.append(action)
+        return actions
diff --git a/openpype/tools/ayon_launcher/models/selection.py b/openpype/tools/ayon_launcher/models/selection.py
new file mode 100644
index 0000000000..b156d2084c
--- /dev/null
+++ b/openpype/tools/ayon_launcher/models/selection.py
@@ -0,0 +1,72 @@
+class LauncherSelectionModel(object):
+    """Model handling selection changes.
+
+    Triggering events:
+    - "selection.project.changed"
+    - "selection.folder.changed"
+    - "selection.task.changed"
+    """
+
+    event_source = "launcher.selection.model"
+
+    def __init__(self, controller):
+        self._controller = controller
+
+        self._project_name = None
+        self._folder_id = None
+        self._task_name = None
+        self._task_id = None
+
+    def get_selected_project_name(self):
+        return self._project_name
+
+    def set_selected_project(self, project_name):
+        if project_name == self._project_name:
+            return
+
+        self._project_name = project_name
+        self._controller.emit_event(
+            "selection.project.changed",
+            {"project_name": project_name},
+            self.event_source
+        )
+
+    def get_selected_folder_id(self):
+        return self._folder_id
+
+    def set_selected_folder(self, folder_id):
+        if folder_id == self._folder_id:
+            return
+
+        self._folder_id = folder_id
+        self._controller.emit_event(
+            "selection.folder.changed",
+            {
+                "project_name": self._project_name,
+                "folder_id": folder_id,
+            },
+            self.event_source
+        )
+
+    def get_selected_task_name(self):
+        return self._task_name
+
+    def get_selected_task_id(self):
+        return self._task_id
+
+    def set_selected_task(self, task_id, task_name):
+        if task_id == self._task_id:
+            return
+
+        self._task_name = task_name
+        self._task_id = task_id
+        self._controller.emit_event(
+            "selection.task.changed",
+            {
+                "project_name": self._project_name,
+                "folder_id": self._folder_id,
+                "task_name": task_name,
+                "task_id": task_id,
+            },
+            self.event_source
+        )
diff --git a/openpype/tools/ayon_launcher/ui/__init__.py b/openpype/tools/ayon_launcher/ui/__init__.py
new file mode 100644
index 0000000000..da30c84656
--- /dev/null
+++ b/openpype/tools/ayon_launcher/ui/__init__.py
@@ -0,0 +1,6 @@
+from .window import LauncherWindow
+
+
+__all__ = (
+    "LauncherWindow",
+)
diff --git a/openpype/tools/ayon_launcher/ui/actions_widget.py b/openpype/tools/ayon_launcher/ui/actions_widget.py
new file mode 100644
index 0000000000..d04f8f8d24
--- /dev/null
+++ b/openpype/tools/ayon_launcher/ui/actions_widget.py
@@ -0,0 +1,453 @@
+import time
+import collections
+
+from qtpy import QtWidgets, QtCore, QtGui
+
+from openpype.tools.flickcharm import FlickCharm
+from openpype.tools.ayon_utils.widgets import get_qt_icon
+
+from .resources import get_options_image_path
+
+ANIMATION_LEN = 7
+
+ACTION_ID_ROLE = QtCore.Qt.UserRole + 1
+ACTION_IS_APPLICATION_ROLE = QtCore.Qt.UserRole + 2
+ACTION_IS_GROUP_ROLE = QtCore.Qt.UserRole + 3
+ACTION_SORT_ROLE = QtCore.Qt.UserRole + 4
+ANIMATION_START_ROLE = QtCore.Qt.UserRole + 5
+ANIMATION_STATE_ROLE = QtCore.Qt.UserRole + 6
+FORCE_NOT_OPEN_WORKFILE_ROLE = QtCore.Qt.UserRole + 7
+
+
+class ActionsQtModel(QtGui.QStandardItemModel):
+    """Qt model for actions.
+
+    Args:
+        controller (AbstractLauncherFrontEnd): Controller instance.
+    """
+
+    refreshed = QtCore.Signal()
+
+    def __init__(self, controller):
+        super(ActionsQtModel, self).__init__()
+
+        controller.register_event_callback(
+            "controller.refresh.finished",
+            self._on_controller_refresh_finished,
+        )
+        controller.register_event_callback(
+            "selection.project.changed",
+            self._on_selection_project_changed,
+        )
+        controller.register_event_callback(
+            "selection.folder.changed",
+            self._on_selection_folder_changed,
+        )
+        controller.register_event_callback(
+            "selection.task.changed",
+            self._on_selection_task_changed,
+        )
+
+        self._controller = controller
+
+        self._items_by_id = {}
+        self._groups_by_id = {}
+
+        self._selected_project_name = None
+        self._selected_folder_id = None
+        self._selected_task_id = None
+
+    def get_selected_project_name(self):
+        return self._selected_project_name
+
+    def get_selected_folder_id(self):
+        return self._selected_folder_id
+
+    def get_selected_task_id(self):
+        return self._selected_task_id
+
+    def get_group_items(self, action_id):
+        return self._groups_by_id[action_id]
+
+    def get_item_by_id(self, action_id):
+        return self._items_by_id.get(action_id)
+
+    def _clear_items(self):
+        self._items_by_id = {}
+        self._groups_by_id = {}
+        root = self.invisibleRootItem()
+        root.removeRows(0, root.rowCount())
+
+    def refresh(self):
+        items = self._controller.get_action_items(
+            self._selected_project_name,
+            self._selected_folder_id,
+            self._selected_task_id,
+        )
+        if not items:
+            self._clear_items()
+            self.refreshed.emit()
+            return
+
+        root_item = self.invisibleRootItem()
+
+        all_action_items_info = []
+        items_by_label = collections.defaultdict(list)
+        for item in items:
+            if not item.variant_label:
+                all_action_items_info.append((item, False))
+            else:
+                items_by_label[item.label].append(item)
+
+        groups_by_id = {}
+        for action_items in items_by_label.values():
+            first_item = next(iter(action_items))
+            all_action_items_info.append((first_item, len(action_items) > 1))
+            groups_by_id[first_item.identifier] = action_items
+
+        new_items = []
+        items_by_id = {}
+        for action_item_info in all_action_items_info:
+            action_item, is_group = action_item_info
+            icon = get_qt_icon(action_item.icon)
+            if is_group:
+                label = action_item.label
+            else:
+                label = action_item.full_label
+
+            item = self._items_by_id.get(action_item.identifier)
+            if item is None:
+                item = QtGui.QStandardItem()
+                item.setData(action_item.identifier, ACTION_ID_ROLE)
+                new_items.append(item)
+
+            item.setFlags(QtCore.Qt.ItemIsEnabled)
+            item.setData(label, QtCore.Qt.DisplayRole)
+            item.setData(icon, QtCore.Qt.DecorationRole)
+            item.setData(is_group, ACTION_IS_GROUP_ROLE)
+            item.setData(action_item.order, ACTION_SORT_ROLE)
+            item.setData(
+                action_item.is_application, ACTION_IS_APPLICATION_ROLE)
+            item.setData(
+                action_item.force_not_open_workfile,
+                FORCE_NOT_OPEN_WORKFILE_ROLE)
+            items_by_id[action_item.identifier] = item
+
+        if new_items:
+            root_item.appendRows(new_items)
+
+        to_remove = set(self._items_by_id.keys()) - set(items_by_id.keys())
+        for identifier in to_remove:
+            item = self._items_by_id.pop(identifier)
+            root_item.removeRow(item.row())
+
+        self._groups_by_id = groups_by_id
+        self._items_by_id = items_by_id
+        self.refreshed.emit()
+
+    def _on_controller_refresh_finished(self):
+        context = self._controller.get_selected_context()
+        self._selected_project_name = context["project_name"]
+        self._selected_folder_id = context["folder_id"]
+        self._selected_task_id = context["task_id"]
+        self.refresh()
+
+    def _on_selection_project_changed(self, event):
+        self._selected_project_name = event["project_name"]
+        self._selected_folder_id = None
+        self._selected_task_id = None
+        self.refresh()
+
+    def _on_selection_folder_changed(self, event):
+        self._selected_project_name = event["project_name"]
+        self._selected_folder_id = event["folder_id"]
+        self._selected_task_id = None
+        self.refresh()
+
+    def _on_selection_task_changed(self, event):
+        self._selected_project_name = event["project_name"]
+        self._selected_folder_id = event["folder_id"]
+        self._selected_task_id = event["task_id"]
+        self.refresh()
+
+
+class ActionDelegate(QtWidgets.QStyledItemDelegate):
+    _cached_extender = {}
+
+    def __init__(self, *args, **kwargs):
+        super(ActionDelegate, self).__init__(*args, **kwargs)
+        self._anim_start_color = QtGui.QColor(178, 255, 246)
+        self._anim_end_color = QtGui.QColor(5, 44, 50)
+
+    def _draw_animation(self, painter, option, index):
+        grid_size = option.widget.gridSize()
+        x_offset = int(
+            (grid_size.width() / 2)
+            - (option.rect.width() / 2)
+        )
+        item_x = option.rect.x() - x_offset
+        rect_offset = grid_size.width() / 20
+        size = grid_size.width() - (rect_offset * 2)
+        anim_rect = QtCore.QRect(
+            item_x + rect_offset,
+            option.rect.y() + rect_offset,
+            size,
+            size
+        )
+
+        painter.save()
+
+        painter.setBrush(QtCore.Qt.transparent)
+
+        gradient = QtGui.QConicalGradient()
+        gradient.setCenter(QtCore.QPointF(anim_rect.center()))
+        gradient.setColorAt(0, self._anim_start_color)
+        gradient.setColorAt(1, self._anim_end_color)
+
+        time_diff = time.time() - index.data(ANIMATION_START_ROLE)
+
+        # Repeat 4 times
+        part_anim = 2.5
+        part_time = time_diff % part_anim
+        offset = (part_time / part_anim) * 360
+        angle = (offset + 90) % 360
+
+        gradient.setAngle(-angle)
+
+        pen = QtGui.QPen(QtGui.QBrush(gradient), rect_offset)
+        pen.setCapStyle(QtCore.Qt.RoundCap)
+        painter.setPen(pen)
+        painter.drawArc(
+            anim_rect,
+            -16 * (angle + 10),
+            -16 * offset
+        )
+
+        painter.restore()
+
+    @classmethod
+    def _get_extender_pixmap(cls, size):
+        pix = cls._cached_extender.get(size)
+        if pix is not None:
+            return pix
+        pix = QtGui.QPixmap(get_options_image_path()).scaled(
+            size, size,
+            QtCore.Qt.KeepAspectRatio,
+            QtCore.Qt.SmoothTransformation
+        )
+        cls._cached_extender[size] = pix
+        return pix
+
+    def paint(self, painter, option, index):
+        painter.setRenderHints(
+            QtGui.QPainter.Antialiasing
+            | QtGui.QPainter.SmoothPixmapTransform
+        )
+
+        if index.data(ANIMATION_STATE_ROLE):
+            self._draw_animation(painter, option, index)
+
+        super(ActionDelegate, self).paint(painter, option, index)
+
+        if index.data(FORCE_NOT_OPEN_WORKFILE_ROLE):
+            rect = QtCore.QRectF(
+                option.rect.x(), option.rect.height(), 5, 5)
+            painter.setPen(QtCore.Qt.NoPen)
+            painter.setBrush(QtGui.QColor(200, 0, 0))
+            painter.drawEllipse(rect)
+
+        if not index.data(ACTION_IS_GROUP_ROLE):
+            return
+
+        grid_size = option.widget.gridSize()
+        x_offset = int(
+            (grid_size.width() / 2)
+            - (option.rect.width() / 2)
+        )
+        item_x = option.rect.x() - x_offset
+
+        tenth_size = int(grid_size.width() / 10)
+        extender_size = int(tenth_size * 2.4)
+
+        extender_x = item_x + tenth_size
+        extender_y = option.rect.y() + tenth_size
+
+        pix = self._get_extender_pixmap(extender_size)
+        painter.drawPixmap(extender_x, extender_y, pix)
+
+
+class ActionsWidget(QtWidgets.QWidget):
+    def __init__(self, controller, parent):
+        super(ActionsWidget, self).__init__(parent)
+
+        self._controller = controller
+
+        view = QtWidgets.QListView(self)
+        view.setProperty("mode", "icon")
+        view.setObjectName("IconView")
+        view.setViewMode(QtWidgets.QListView.IconMode)
+        view.setResizeMode(QtWidgets.QListView.Adjust)
+        view.setSelectionMode(QtWidgets.QListView.NoSelection)
+        view.setContextMenuPolicy(QtCore.Qt.CustomContextMenu)
+        view.setEditTriggers(QtWidgets.QAbstractItemView.NoEditTriggers)
+        view.setWrapping(True)
+        view.setGridSize(QtCore.QSize(70, 75))
+        view.setIconSize(QtCore.QSize(30, 30))
+        view.setSpacing(0)
+        view.setWordWrap(True)
+
+        # Make view flickable
+        flick = FlickCharm(parent=view)
+        flick.activateOn(view)
+
+        model = ActionsQtModel(controller)
+
+        proxy_model = QtCore.QSortFilterProxyModel()
+        proxy_model.setSortCaseSensitivity(QtCore.Qt.CaseInsensitive)
+        proxy_model.setSortRole(ACTION_SORT_ROLE)
+
+        proxy_model.setSourceModel(model)
+        view.setModel(proxy_model)
+
+        delegate = ActionDelegate(self)
+        view.setItemDelegate(delegate)
+
+        layout = QtWidgets.QHBoxLayout(self)
+        layout.setContentsMargins(0, 0, 0, 0)
+        layout.addWidget(view)
+
+        animation_timer = QtCore.QTimer()
+        animation_timer.setInterval(40)
+        animation_timer.timeout.connect(self._on_animation)
+
+        view.clicked.connect(self._on_clicked)
+        view.customContextMenuRequested.connect(self._on_context_menu)
+        model.refreshed.connect(self._on_model_refresh)
+
+        self._animated_items = set()
+        self._animation_timer = animation_timer
+
+        self._context_menu = None
+
+        self._flick = flick
+        self._view = view
+        self._model = model
+        self._proxy_model = proxy_model
+
+        self._set_row_height(1)
+
+    def _set_row_height(self, rows):
+        self.setMinimumHeight(rows * 75)
+
+    def _on_model_refresh(self):
+        self._proxy_model.sort(0)
+
+    def _on_animation(self):
+        time_now = time.time()
+        for action_id in tuple(self._animated_items):
+            item = self._model.get_item_by_id(action_id)
+            if item is None:
+                self._animated_items.discard(action_id)
+                continue
+
+            start_time = item.data(ANIMATION_START_ROLE)
+            if start_time is None or (time_now - start_time) > ANIMATION_LEN:
+                item.setData(0, ANIMATION_STATE_ROLE)
+                self._animated_items.discard(action_id)
+
+        if not self._animated_items:
+            self._animation_timer.stop()
+
+        self.update()
+
+    def _start_animation(self, index):
+        # Offset refresh timout
+        model_index = self._proxy_model.mapToSource(index)
+        if not model_index.isValid():
+            return
+        action_id = model_index.data(ACTION_ID_ROLE)
+        self._model.setData(model_index, time.time(), ANIMATION_START_ROLE)
+        self._model.setData(model_index, 1, ANIMATION_STATE_ROLE)
+        self._animated_items.add(action_id)
+        self._animation_timer.start()
+
+    def _on_context_menu(self, point):
+        """Creates menu to force skip opening last workfile."""
+        index = self._view.indexAt(point)
+        if not index.isValid():
+            return
+
+        if not index.data(ACTION_IS_APPLICATION_ROLE):
+            return
+
+        menu = QtWidgets.QMenu(self._view)
+        checkbox = QtWidgets.QCheckBox(
+            "Skip opening last workfile.", menu)
+        if index.data(FORCE_NOT_OPEN_WORKFILE_ROLE):
+            checkbox.setChecked(True)
+
+        action_id = index.data(ACTION_ID_ROLE)
+        checkbox.stateChanged.connect(
+            lambda: self._on_checkbox_changed(
+                action_id, checkbox.isChecked()
+            )
+        )
+        action = QtWidgets.QWidgetAction(menu)
+        action.setDefaultWidget(checkbox)
+
+        menu.addAction(action)
+
+        self._context_menu = menu
+        global_point = self.mapToGlobal(point)
+        menu.exec_(global_point)
+        self._context_menu = None
+
+    def _on_checkbox_changed(self, action_id, is_checked):
+        if self._context_menu is not None:
+            self._context_menu.close()
+
+        project_name = self._model.get_selected_project_name()
+        folder_id = self._model.get_selected_folder_id()
+        task_id = self._model.get_selected_task_id()
+        self._controller.set_application_force_not_open_workfile(
+            project_name, folder_id, task_id, action_id, is_checked)
+        self._model.refresh()
+
+    def _on_clicked(self, index):
+        if not index or not index.isValid():
+            return
+
+        is_group = index.data(ACTION_IS_GROUP_ROLE)
+        action_id = index.data(ACTION_ID_ROLE)
+
+        project_name = self._model.get_selected_project_name()
+        folder_id = self._model.get_selected_folder_id()
+        task_id = self._model.get_selected_task_id()
+
+        if not is_group:
+            self._controller.trigger_action(
+                project_name, folder_id, task_id, action_id
+            )
+            self._start_animation(index)
+            return
+
+        action_items = self._model.get_group_items(action_id)
+
+        menu = QtWidgets.QMenu(self)
+        actions_mapping = {}
+
+        for action_item in action_items:
+            menu_action = QtWidgets.QAction(action_item.full_label)
+            menu.addAction(menu_action)
+            actions_mapping[menu_action] = action_item
+
+        result = menu.exec_(QtGui.QCursor.pos())
+        if not result:
+            return
+
+        action_item = actions_mapping[result]
+
+        self._controller.trigger_action(
+            project_name, folder_id, task_id, action_item.identifier
+        )
+        self._start_animation(index)
diff --git a/openpype/tools/ayon_launcher/ui/hierarchy_page.py b/openpype/tools/ayon_launcher/ui/hierarchy_page.py
new file mode 100644
index 0000000000..5047cdc692
--- /dev/null
+++ b/openpype/tools/ayon_launcher/ui/hierarchy_page.py
@@ -0,0 +1,102 @@
+import qtawesome
+from qtpy import QtWidgets, QtCore
+
+from openpype.tools.utils import (
+    PlaceholderLineEdit,
+    SquareButton,
+    RefreshButton,
+)
+from openpype.tools.ayon_utils.widgets import (
+    ProjectsCombobox,
+    FoldersWidget,
+    TasksWidget,
+)
+
+
+class HierarchyPage(QtWidgets.QWidget):
+    def __init__(self, controller, parent):
+        super(HierarchyPage, self).__init__(parent)
+
+        # Header
+        header_widget = QtWidgets.QWidget(self)
+
+        btn_back_icon = qtawesome.icon("fa.angle-left", color="white")
+        btn_back = SquareButton(header_widget)
+        btn_back.setIcon(btn_back_icon)
+
+        projects_combobox = ProjectsCombobox(controller, header_widget)
+
+        refresh_btn = RefreshButton(header_widget)
+
+        header_layout = QtWidgets.QHBoxLayout(header_widget)
+        header_layout.setContentsMargins(0, 0, 0, 0)
+        header_layout.addWidget(btn_back, 0)
+        header_layout.addWidget(projects_combobox, 1)
+        header_layout.addWidget(refresh_btn, 0)
+
+        # Body - Folders + Tasks selection
+        content_body = QtWidgets.QSplitter(self)
+        content_body.setContentsMargins(0, 0, 0, 0)
+        content_body.setSizePolicy(
+            QtWidgets.QSizePolicy.Expanding,
+            QtWidgets.QSizePolicy.Expanding
+        )
+        content_body.setOrientation(QtCore.Qt.Horizontal)
+
+        # - Folders widget with filter
+        folders_wrapper = QtWidgets.QWidget(content_body)
+
+        folders_filter_text = PlaceholderLineEdit(folders_wrapper)
+        folders_filter_text.setPlaceholderText("Filter folders...")
+
+        folders_widget = FoldersWidget(controller, folders_wrapper)
+
+        folders_wrapper_layout = QtWidgets.QVBoxLayout(folders_wrapper)
+        folders_wrapper_layout.setContentsMargins(0, 0, 0, 0)
+        folders_wrapper_layout.addWidget(folders_filter_text, 0)
+        folders_wrapper_layout.addWidget(folders_widget, 1)
+
+        # - Tasks widget
+        tasks_widget = TasksWidget(controller, content_body)
+
+        content_body.addWidget(folders_wrapper)
+        content_body.addWidget(tasks_widget)
+        content_body.setStretchFactor(0, 100)
+        content_body.setStretchFactor(1, 65)
+
+        main_layout = QtWidgets.QVBoxLayout(self)
+        main_layout.setContentsMargins(0, 0, 0, 0)
+        main_layout.addWidget(header_widget, 0)
+        main_layout.addWidget(content_body, 1)
+
+        btn_back.clicked.connect(self._on_back_clicked)
+        refresh_btn.clicked.connect(self._on_refreh_clicked)
+        folders_filter_text.textChanged.connect(self._on_filter_text_changed)
+
+        self._is_visible = False
+        self._controller = controller
+
+        self._btn_back = btn_back
+        self._projects_combobox = projects_combobox
+        self._folders_widget = folders_widget
+        self._tasks_widget = tasks_widget
+
+        # Post init
+        projects_combobox.set_listen_to_selection_change(self._is_visible)
+
+    def set_page_visible(self, visible, project_name=None):
+        if self._is_visible == visible:
+            return
+        self._is_visible = visible
+        self._projects_combobox.set_listen_to_selection_change(visible)
+        if visible and project_name:
+            self._projects_combobox.set_selection(project_name)
+
+    def _on_back_clicked(self):
+        self._controller.set_selected_project(None)
+
+    def _on_refreh_clicked(self):
+        self._controller.refresh()
+
+    def _on_filter_text_changed(self, text):
+        self._folders_widget.set_name_filer(text)
diff --git a/openpype/tools/ayon_launcher/ui/projects_widget.py b/openpype/tools/ayon_launcher/ui/projects_widget.py
new file mode 100644
index 0000000000..baa399d0ed
--- /dev/null
+++ b/openpype/tools/ayon_launcher/ui/projects_widget.py
@@ -0,0 +1,135 @@
+from qtpy import QtWidgets, QtCore
+
+from openpype.tools.flickcharm import FlickCharm
+from openpype.tools.utils import PlaceholderLineEdit, RefreshButton
+from openpype.tools.ayon_utils.widgets import (
+    ProjectsModel,
+    ProjectSortFilterProxy,
+)
+from openpype.tools.ayon_utils.models import PROJECTS_MODEL_SENDER
+
+
+class ProjectIconView(QtWidgets.QListView):
+    """Styled ListView that allows to toggle between icon and list mode.
+
+    Toggling between the two modes is done by Right Mouse Click.
+    """
+
+    IconMode = 0
+    ListMode = 1
+
+    def __init__(self, parent=None, mode=ListMode):
+        super(ProjectIconView, self).__init__(parent=parent)
+
+        # Workaround for scrolling being super slow or fast when
+        # toggling between the two visual modes
+        self.setVerticalScrollMode(QtWidgets.QAbstractItemView.ScrollPerPixel)
+        self.setObjectName("IconView")
+
+        self._mode = None
+        self.set_mode(mode)
+
+    def set_mode(self, mode):
+        if mode == self._mode:
+            return
+
+        self._mode = mode
+
+        if mode == self.IconMode:
+            self.setViewMode(QtWidgets.QListView.IconMode)
+            self.setResizeMode(QtWidgets.QListView.Adjust)
+            self.setWrapping(True)
+            self.setWordWrap(True)
+            self.setGridSize(QtCore.QSize(151, 90))
+            self.setIconSize(QtCore.QSize(50, 50))
+            self.setSpacing(0)
+            self.setAlternatingRowColors(False)
+
+            self.setProperty("mode", "icon")
+            self.style().polish(self)
+
+            self.verticalScrollBar().setSingleStep(30)
+
+        elif self.ListMode:
+            self.setProperty("mode", "list")
+            self.style().polish(self)
+
+            self.setViewMode(QtWidgets.QListView.ListMode)
+            self.setResizeMode(QtWidgets.QListView.Adjust)
+            self.setWrapping(False)
+            self.setWordWrap(False)
+            self.setIconSize(QtCore.QSize(20, 20))
+            self.setGridSize(QtCore.QSize(100, 25))
+            self.setSpacing(0)
+            self.setAlternatingRowColors(False)
+
+            self.verticalScrollBar().setSingleStep(34)
+
+    def mousePressEvent(self, event):
+        if event.button() == QtCore.Qt.RightButton:
+            self.set_mode(int(not self._mode))
+        return super(ProjectIconView, self).mousePressEvent(event)
+
+
+class ProjectsWidget(QtWidgets.QWidget):
+    """Projects Page"""
+    def __init__(self, controller, parent=None):
+        super(ProjectsWidget, self).__init__(parent=parent)
+
+        header_widget = QtWidgets.QWidget(self)
+
+        projects_filter_text = PlaceholderLineEdit(header_widget)
+        projects_filter_text.setPlaceholderText("Filter projects...")
+
+        refresh_btn = RefreshButton(header_widget)
+
+        header_layout = QtWidgets.QHBoxLayout(header_widget)
+        header_layout.setContentsMargins(0, 0, 0, 0)
+        header_layout.addWidget(projects_filter_text, 1)
+        header_layout.addWidget(refresh_btn, 0)
+
+        projects_view = ProjectIconView(parent=self)
+        projects_view.setSelectionMode(QtWidgets.QListView.NoSelection)
+        flick = FlickCharm(parent=self)
+        flick.activateOn(projects_view)
+        projects_model = ProjectsModel(controller)
+        projects_proxy_model = ProjectSortFilterProxy()
+        projects_proxy_model.setSourceModel(projects_model)
+
+        projects_view.setModel(projects_proxy_model)
+
+        main_layout = QtWidgets.QVBoxLayout(self)
+        main_layout.setContentsMargins(0, 0, 0, 0)
+        main_layout.addWidget(header_widget, 0)
+        main_layout.addWidget(projects_view, 1)
+
+        projects_view.clicked.connect(self._on_view_clicked)
+        projects_filter_text.textChanged.connect(
+            self._on_project_filter_change)
+        refresh_btn.clicked.connect(self._on_refresh_clicked)
+
+        controller.register_event_callback(
+            "projects.refresh.finished",
+            self._on_projects_refresh_finished
+        )
+
+        self._controller = controller
+
+        self._projects_view = projects_view
+        self._projects_model = projects_model
+        self._projects_proxy_model = projects_proxy_model
+
+    def _on_view_clicked(self, index):
+        if index.isValid():
+            project_name = index.data(QtCore.Qt.DisplayRole)
+            self._controller.set_selected_project(project_name)
+
+    def _on_project_filter_change(self, text):
+        self._projects_proxy_model.setFilterFixedString(text)
+
+    def _on_refresh_clicked(self):
+        self._controller.refresh()
+
+    def _on_projects_refresh_finished(self, event):
+        if event["sender"] != PROJECTS_MODEL_SENDER:
+            self._projects_model.refresh()
diff --git a/openpype/tools/ayon_launcher/ui/resources/__init__.py b/openpype/tools/ayon_launcher/ui/resources/__init__.py
new file mode 100644
index 0000000000..27c59af2ba
--- /dev/null
+++ b/openpype/tools/ayon_launcher/ui/resources/__init__.py
@@ -0,0 +1,7 @@
+import os
+
+RESOURCES_DIR = os.path.dirname(os.path.abspath(__file__))
+
+
+def get_options_image_path():
+    return os.path.join(RESOURCES_DIR, "options.png")
diff --git a/openpype/tools/ayon_launcher/ui/resources/options.png b/openpype/tools/ayon_launcher/ui/resources/options.png
new file mode 100644
index 0000000000000000000000000000000000000000..a9617d0d1914634835f388c01479c672a8c8ffd7
GIT binary patch
literal 1772
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
JsYfT|{STHtHTD1i

literal 0
HcmV?d00001

diff --git a/openpype/tools/ayon_launcher/ui/window.py b/openpype/tools/ayon_launcher/ui/window.py
new file mode 100644
index 0000000000..139da42a2e
--- /dev/null
+++ b/openpype/tools/ayon_launcher/ui/window.py
@@ -0,0 +1,295 @@
+from qtpy import QtWidgets, QtCore, QtGui
+
+from openpype import style
+from openpype import resources
+
+from openpype.tools.ayon_launcher.control import BaseLauncherController
+
+from .projects_widget import ProjectsWidget
+from .hierarchy_page import HierarchyPage
+from .actions_widget import ActionsWidget
+
+
+class LauncherWindow(QtWidgets.QWidget):
+    """Launcher interface"""
+    message_interval = 5000
+    refresh_interval = 10000
+    page_side_anim_interval = 250
+
+    def __init__(self, controller=None, parent=None):
+        super(LauncherWindow, self).__init__(parent)
+
+        if controller is None:
+            controller = BaseLauncherController()
+
+        icon = QtGui.QIcon(resources.get_openpype_icon_filepath())
+        self.setWindowIcon(icon)
+        self.setWindowTitle("Launcher")
+        self.setFocusPolicy(QtCore.Qt.StrongFocus)
+        self.setAttribute(QtCore.Qt.WA_DeleteOnClose, False)
+
+        self.setStyleSheet(style.load_stylesheet())
+
+        # Allow minimize
+        self.setWindowFlags(
+            QtCore.Qt.Window
+            | QtCore.Qt.CustomizeWindowHint
+            | QtCore.Qt.WindowTitleHint
+            | QtCore.Qt.WindowMinimizeButtonHint
+            | QtCore.Qt.WindowCloseButtonHint
+        )
+
+        self._controller = controller
+
+        # Main content - Pages & Actions
+        content_body = QtWidgets.QSplitter(self)
+
+        # Pages
+        pages_widget = QtWidgets.QWidget(content_body)
+
+        # - First page - Projects
+        projects_page = ProjectsWidget(controller, pages_widget)
+
+        # - Second page - Hierarchy (folders & tasks)
+        hierarchy_page = HierarchyPage(controller, pages_widget)
+
+        pages_layout = QtWidgets.QHBoxLayout(pages_widget)
+        pages_layout.setContentsMargins(0, 0, 0, 0)
+        pages_layout.addWidget(projects_page, 1)
+        pages_layout.addWidget(hierarchy_page, 1)
+
+        # Actions
+        actions_widget = ActionsWidget(controller, content_body)
+
+        # Vertically split Pages and Actions
+        content_body.setContentsMargins(0, 0, 0, 0)
+        content_body.setSizePolicy(
+            QtWidgets.QSizePolicy.Expanding,
+            QtWidgets.QSizePolicy.Expanding
+        )
+        content_body.setOrientation(QtCore.Qt.Vertical)
+        content_body.addWidget(pages_widget)
+        content_body.addWidget(actions_widget)
+
+        # Set useful default sizes and set stretch
+        # for the pages so that is the only one that
+        # stretches on UI resize.
+        content_body.setStretchFactor(0, 10)
+        content_body.setSizes([580, 160])
+
+        # Footer
+        footer_widget = QtWidgets.QWidget(self)
+
+        # - Message label
+        message_label = QtWidgets.QLabel(footer_widget)
+
+        # action_history = ActionHistory(footer_widget)
+        # action_history.setStatusTip("Show Action History")
+
+        footer_layout = QtWidgets.QHBoxLayout(footer_widget)
+        footer_layout.setContentsMargins(0, 0, 0, 0)
+        footer_layout.addWidget(message_label, 1)
+        # footer_layout.addWidget(action_history, 0)
+
+        layout = QtWidgets.QVBoxLayout(self)
+        layout.addWidget(content_body, 1)
+        layout.addWidget(footer_widget, 0)
+
+        message_timer = QtCore.QTimer()
+        message_timer.setInterval(self.message_interval)
+        message_timer.setSingleShot(True)
+
+        refresh_timer = QtCore.QTimer()
+        refresh_timer.setInterval(self.refresh_interval)
+
+        page_slide_anim = QtCore.QVariantAnimation(self)
+        page_slide_anim.setDuration(self.page_side_anim_interval)
+        page_slide_anim.setStartValue(0.0)
+        page_slide_anim.setEndValue(1.0)
+        page_slide_anim.setEasingCurve(QtCore.QEasingCurve.OutQuad)
+
+        message_timer.timeout.connect(self._on_message_timeout)
+        refresh_timer.timeout.connect(self._on_refresh_timeout)
+        page_slide_anim.valueChanged.connect(
+            self._on_page_slide_value_changed)
+        page_slide_anim.finished.connect(self._on_page_slide_finished)
+
+        controller.register_event_callback(
+            "selection.project.changed",
+            self._on_project_selection_change,
+        )
+        controller.register_event_callback(
+            "action.trigger.started",
+            self._on_action_trigger_started,
+        )
+        controller.register_event_callback(
+            "action.trigger.finished",
+            self._on_action_trigger_finished,
+        )
+
+        self._controller = controller
+
+        self._is_on_projects_page = True
+        self._window_is_active = False
+        self._refresh_on_activate = False
+
+        self._pages_widget = pages_widget
+        self._pages_layout = pages_layout
+        self._projects_page = projects_page
+        self._hierarchy_page = hierarchy_page
+        self._actions_widget = actions_widget
+
+        self._message_label = message_label
+        # self._action_history = action_history
+
+        self._message_timer = message_timer
+        self._refresh_timer = refresh_timer
+        self._page_slide_anim = page_slide_anim
+
+        hierarchy_page.setVisible(not self._is_on_projects_page)
+        self.resize(520, 740)
+
+    def showEvent(self, event):
+        super(LauncherWindow, self).showEvent(event)
+        self._window_is_active = True
+        if not self._refresh_timer.isActive():
+            self._refresh_timer.start()
+        self._controller.refresh()
+
+    def closeEvent(self, event):
+        super(LauncherWindow, self).closeEvent(event)
+        self._window_is_active = False
+        self._refresh_timer.stop()
+
+    def changeEvent(self, event):
+        if event.type() in (
+            QtCore.QEvent.Type.WindowStateChange,
+            QtCore.QEvent.ActivationChange,
+        ):
+            is_active = self.isActiveWindow() and not self.isMinimized()
+            self._window_is_active = is_active
+            if is_active and self._refresh_on_activate:
+                self._refresh_on_activate = False
+                self._on_refresh_timeout()
+                self._refresh_timer.start()
+
+        super(LauncherWindow, self).changeEvent(event)
+
+    def _on_refresh_timeout(self):
+        # Stop timer if widget is not visible
+        if self._window_is_active:
+            self._controller.refresh()
+        else:
+            self._refresh_on_activate = True
+
+    def _echo(self, message):
+        self._message_label.setText(str(message))
+        self._message_timer.start()
+
+    def _on_message_timeout(self):
+        self._message_label.setText("")
+
+    def _on_project_selection_change(self, event):
+        project_name = event["project_name"]
+        if not project_name:
+            self._go_to_projects_page()
+
+        elif self._is_on_projects_page:
+            self._go_to_hierarchy_page(project_name)
+
+    def _on_action_trigger_started(self, event):
+        self._echo("Running action: {}".format(event["full_label"]))
+
+    def _on_action_trigger_finished(self, event):
+        if not event["failed"]:
+            return
+        self._echo("Failed: {}".format(event["error_message"]))
+
+    def _is_page_slide_anim_running(self):
+        return (
+            self._page_slide_anim.state() == QtCore.QAbstractAnimation.Running
+        )
+
+    def _go_to_projects_page(self):
+        if self._is_on_projects_page:
+            return
+        self._is_on_projects_page = True
+        self._hierarchy_page.set_page_visible(False)
+
+        self._start_page_slide_animation()
+
+    def _go_to_hierarchy_page(self, project_name):
+        if not self._is_on_projects_page:
+            return
+        self._is_on_projects_page = False
+        self._hierarchy_page.set_page_visible(True, project_name)
+
+        self._start_page_slide_animation()
+
+    def _start_page_slide_animation(self):
+        if self._is_on_projects_page:
+            direction = QtCore.QAbstractAnimation.Backward
+        else:
+            direction = QtCore.QAbstractAnimation.Forward
+        self._page_slide_anim.setDirection(direction)
+        if self._is_page_slide_anim_running():
+            return
+
+        layout_spacing = self._pages_layout.spacing()
+        if self._is_on_projects_page:
+            hierarchy_geo = self._hierarchy_page.geometry()
+            projects_geo = QtCore.QRect(hierarchy_geo)
+            projects_geo.moveRight(
+                hierarchy_geo.left() - (layout_spacing + 1))
+
+            self._projects_page.setVisible(True)
+
+        else:
+            projects_geo = self._projects_page.geometry()
+            hierarchy_geo = QtCore.QRect(projects_geo)
+            hierarchy_geo.moveLeft(projects_geo.right() + layout_spacing)
+            self._hierarchy_page.setVisible(True)
+
+        while self._pages_layout.count():
+            self._pages_layout.takeAt(0)
+
+        self._projects_page.setGeometry(projects_geo)
+        self._hierarchy_page.setGeometry(hierarchy_geo)
+
+        self._page_slide_anim.start()
+
+    def _on_page_slide_value_changed(self, value):
+        layout_spacing = self._pages_layout.spacing()
+        content_width = self._pages_widget.width() - layout_spacing
+        content_height = self._pages_widget.height()
+
+        # Visible widths of other widgets
+        hierarchy_width = int(content_width * value)
+
+        hierarchy_geo = QtCore.QRect(
+            content_width - hierarchy_width, 0, content_width, content_height
+        )
+        projects_geo = QtCore.QRect(hierarchy_geo)
+        projects_geo.moveRight(hierarchy_geo.left() - (layout_spacing + 1))
+
+        self._projects_page.setGeometry(projects_geo)
+        self._hierarchy_page.setGeometry(hierarchy_geo)
+
+    def _on_page_slide_finished(self):
+        self._pages_layout.addWidget(self._projects_page, 1)
+        self._pages_layout.addWidget(self._hierarchy_page, 1)
+        self._projects_page.setVisible(self._is_on_projects_page)
+        self._hierarchy_page.setVisible(not self._is_on_projects_page)
+
+    # def _on_history_action(self, history_data):
+    #     action, session = history_data
+    #     app = QtWidgets.QApplication.instance()
+    #     modifiers = app.keyboardModifiers()
+    #
+    #     is_control_down = QtCore.Qt.ControlModifier & modifiers
+    #     if is_control_down:
+    #         # Revert to that "session" location
+    #         self.set_session(session)
+    #     else:
+    #         # User is holding control, rerun the action
+    #         self.run_action(action, session=session)
diff --git a/openpype/tools/ayon_utils/models/__init__.py b/openpype/tools/ayon_utils/models/__init__.py
new file mode 100644
index 0000000000..1434282c5b
--- /dev/null
+++ b/openpype/tools/ayon_utils/models/__init__.py
@@ -0,0 +1,29 @@
+"""Backend models that can be used in controllers."""
+
+from .cache import CacheItem, NestedCacheItem
+from .projects import (
+    ProjectItem,
+    ProjectsModel,
+    PROJECTS_MODEL_SENDER,
+)
+from .hierarchy import (
+    FolderItem,
+    TaskItem,
+    HierarchyModel,
+    HIERARCHY_MODEL_SENDER,
+)
+
+
+__all__ = (
+    "CacheItem",
+    "NestedCacheItem",
+
+    "ProjectItem",
+    "ProjectsModel",
+    "PROJECTS_MODEL_SENDER",
+
+    "FolderItem",
+    "TaskItem",
+    "HierarchyModel",
+    "HIERARCHY_MODEL_SENDER",
+)
diff --git a/openpype/tools/ayon_utils/models/cache.py b/openpype/tools/ayon_utils/models/cache.py
new file mode 100644
index 0000000000..44b97e930d
--- /dev/null
+++ b/openpype/tools/ayon_utils/models/cache.py
@@ -0,0 +1,196 @@
+import time
+import collections
+
+InitInfo = collections.namedtuple(
+    "InitInfo",
+    ["default_factory", "lifetime"]
+)
+
+
+def _default_factory_func():
+    return None
+
+
+class CacheItem:
+    """Simple cache item with lifetime and default value.
+
+    Args:
+        default_factory (Optional[callable]): Function that returns default
+            value used on init and on reset.
+        lifetime (Optional[int]): Lifetime of the cache data in seconds.
+    """
+
+    def __init__(self, default_factory=None, lifetime=None):
+        if lifetime is None:
+            lifetime = 120
+        self._lifetime = lifetime
+        self._last_update = None
+        if default_factory is None:
+            default_factory = _default_factory_func
+        self._default_factory = default_factory
+        self._data = default_factory()
+
+    @property
+    def is_valid(self):
+        """Is cache valid to use.
+
+        Return:
+            bool: True if cache is valid, False otherwise.
+        """
+
+        if self._last_update is None:
+            return False
+
+        return (time.time() - self._last_update) < self._lifetime
+
+    def set_lifetime(self, lifetime):
+        """Change lifetime of cache item.
+
+        Args:
+            lifetime (int): Lifetime of the cache data in seconds.
+        """
+
+        self._lifetime = lifetime
+
+    def set_invalid(self):
+        """Set cache as invalid."""
+
+        self._last_update = None
+
+    def reset(self):
+        """Set cache as invalid and reset data."""
+
+        self._last_update = None
+        self._data = self._default_factory()
+
+    def get_data(self):
+        """Receive cached data.
+
+        Returns:
+            Any: Any data that are cached.
+        """
+
+        return self._data
+
+    def update_data(self, data):
+        self._data = data
+        self._last_update = time.time()
+
+
+class NestedCacheItem:
+    """Helper for cached items stored in nested structure.
+
+    Example:
+        >>> cache = NestedCacheItem(levels=2)
+        >>> cache["a"]["b"].is_valid
+        False
+        >>> cache["a"]["b"].get_data()
+        None
+        >>> cache["a"]["b"] = 1
+        >>> cache["a"]["b"].is_valid
+        True
+        >>> cache["a"]["b"].get_data()
+        1
+        >>> cache.reset()
+        >>> cache["a"]["b"].is_valid
+        False
+
+    Args:
+        levels (int): Number of nested levels where read cache is stored.
+        default_factory (Optional[callable]): Function that returns default
+            value used on init and on reset.
+        lifetime (Optional[int]): Lifetime of the cache data in seconds.
+        _init_info (Optional[InitInfo]): Private argument. Init info for
+            nested cache where created from parent item.
+    """
+
+    def __init__(
+        self, levels=1, default_factory=None, lifetime=None, _init_info=None
+    ):
+        if levels < 1:
+            raise ValueError("Nested levels must be greater than 0")
+        self._data_by_key = {}
+        if _init_info is None:
+            _init_info = InitInfo(default_factory, lifetime)
+        self._init_info = _init_info
+        self._levels = levels
+
+    def __getitem__(self, key):
+        """Get cached data.
+
+        Args:
+            key (str): Key of the cache item.
+
+        Returns:
+            Union[NestedCacheItem, CacheItem]: Cache item.
+        """
+
+        cache = self._data_by_key.get(key)
+        if cache is None:
+            if self._levels > 1:
+                cache = NestedCacheItem(
+                    levels=self._levels - 1,
+                    _init_info=self._init_info
+                )
+            else:
+                cache = CacheItem(
+                    self._init_info.default_factory,
+                    self._init_info.lifetime
+                )
+            self._data_by_key[key] = cache
+        return cache
+
+    def __setitem__(self, key, value):
+        """Update cached data.
+
+        Args:
+            key (str): Key of the cache item.
+            value (Any): Any data that are cached.
+        """
+
+        if self._levels > 1:
+            raise AttributeError((
+                "{} does not support '__setitem__'. Lower nested level by {}"
+            ).format(self.__class__.__name__, self._levels - 1))
+        cache = self[key]
+        cache.update_data(value)
+
+    def get(self, key):
+        """Get cached data.
+
+        Args:
+            key (str): Key of the cache item.
+
+        Returns:
+            Union[NestedCacheItem, CacheItem]: Cache item.
+        """
+
+        return self[key]
+
+    def reset(self):
+        """Reset cache."""
+
+        self._data_by_key = {}
+
+    def set_lifetime(self, lifetime):
+        """Change lifetime of all children cache items.
+
+        Args:
+            lifetime (int): Lifetime of the cache data in seconds.
+        """
+
+        self._init_info.lifetime = lifetime
+        for cache in self._data_by_key.values():
+            cache.set_lifetime(lifetime)
+
+    @property
+    def is_valid(self):
+        """Raise reasonable error when called on wront level.
+
+        Raises:
+            AttributeError: If called on nested cache item.
+        """
+
+        raise AttributeError((
+            "{} does not support 'is_valid'. Lower nested level by '{}'"
+        ).format(self.__class__.__name__, self._levels))
diff --git a/openpype/tools/ayon_utils/models/hierarchy.py b/openpype/tools/ayon_utils/models/hierarchy.py
new file mode 100644
index 0000000000..8e01c557c5
--- /dev/null
+++ b/openpype/tools/ayon_utils/models/hierarchy.py
@@ -0,0 +1,340 @@
+import collections
+import contextlib
+from abc import ABCMeta, abstractmethod
+
+import ayon_api
+import six
+
+from openpype.style import get_default_entity_icon_color
+
+from .cache import NestedCacheItem
+
+HIERARCHY_MODEL_SENDER = "hierarchy.model"
+
+
+@six.add_metaclass(ABCMeta)
+class AbstractHierarchyController:
+    @abstractmethod
+    def emit_event(self, topic, data, source):
+        pass
+
+
+class FolderItem:
+    """Item representing folder entity on a server.
+
+    Folder can be a child of another folder or a project.
+
+    Args:
+        entity_id (str): Folder id.
+        parent_id (Union[str, None]): Parent folder id. If 'None' then project
+            is parent.
+        name (str): Name of folder.
+        label (str): Folder label.
+        icon_name (str): Name of icon from font awesome.
+        icon_color (str): Hex color string that will be used for icon.
+    """
+
+    def __init__(
+        self, entity_id, parent_id, name, label, icon
+    ):
+        self.entity_id = entity_id
+        self.parent_id = parent_id
+        self.name = name
+        if not icon:
+            icon = {
+                "type": "awesome-font",
+                "name": "fa.folder",
+                "color": get_default_entity_icon_color()
+            }
+        self.icon = icon
+        self.label = label or name
+
+    def to_data(self):
+        """Converts folder item to data.
+
+        Returns:
+            dict[str, Any]: Folder item data.
+        """
+
+        return {
+            "entity_id": self.entity_id,
+            "parent_id": self.parent_id,
+            "name": self.name,
+            "label": self.label,
+            "icon": self.icon,
+        }
+
+    @classmethod
+    def from_data(cls, data):
+        """Re-creates folder item from data.
+
+        Args:
+            data (dict[str, Any]): Folder item data.
+
+        Returns:
+            FolderItem: Folder item.
+        """
+
+        return cls(**data)
+
+
+class TaskItem:
+    """Task item representing task entity on a server.
+
+    Task is child of a folder.
+
+    Task item has label that is used for display in UI. The label is by
+        default using task name and type.
+
+    Args:
+        task_id (str): Task id.
+        name (str): Name of task.
+        task_type (str): Type of task.
+        parent_id (str): Parent folder id.
+        icon_name (str): Name of icon from font awesome.
+        icon_color (str): Hex color string that will be used for icon.
+    """
+
+    def __init__(
+        self, task_id, name, task_type, parent_id, icon
+    ):
+        self.task_id = task_id
+        self.name = name
+        self.task_type = task_type
+        self.parent_id = parent_id
+        if icon is None:
+            icon = {
+                "type": "awesome-font",
+                "name": "fa.male",
+                "color": get_default_entity_icon_color()
+            }
+        self.icon = icon
+
+        self._label = None
+
+    @property
+    def id(self):
+        """Alias for task_id.
+
+        Returns:
+            str: Task id.
+        """
+
+        return self.task_id
+
+    @property
+    def label(self):
+        """Label of task item for UI.
+
+        Returns:
+            str: Label of task item.
+        """
+
+        if self._label is None:
+            self._label = "{} ({})".format(self.name, self.task_type)
+        return self._label
+
+    def to_data(self):
+        """Converts task item to data.
+
+        Returns:
+            dict[str, Any]: Task item data.
+        """
+
+        return {
+            "task_id": self.task_id,
+            "name": self.name,
+            "parent_id": self.parent_id,
+            "task_type": self.task_type,
+            "icon": self.icon,
+        }
+
+    @classmethod
+    def from_data(cls, data):
+        """Re-create task item from data.
+
+        Args:
+            data (dict[str, Any]): Task item data.
+
+        Returns:
+            TaskItem: Task item.
+        """
+
+        return cls(**data)
+
+
+def _get_task_items_from_tasks(tasks):
+    """
+
+    Returns:
+        TaskItem: Task item.
+    """
+
+    output = []
+    for task in tasks:
+        folder_id = task["folderId"]
+        output.append(TaskItem(
+            task["id"],
+            task["name"],
+            task["type"],
+            folder_id,
+            None
+        ))
+    return output
+
+
+def _get_folder_item_from_hierarchy_item(item):
+    return FolderItem(
+        item["id"],
+        item["parentId"],
+        item["name"],
+        item["label"],
+        None
+    )
+
+
+class HierarchyModel(object):
+    """Model for project hierarchy items.
+
+    Hierarchy items are folders and tasks. Folders can have as parent another
+    folder or project. Tasks can have as parent only folder.
+    """
+
+    def __init__(self, controller):
+        self._folders_items = NestedCacheItem(levels=1, default_factory=dict)
+        self._folders_by_id = NestedCacheItem(levels=2, default_factory=dict)
+
+        self._task_items = NestedCacheItem(levels=2, default_factory=dict)
+        self._tasks_by_id = NestedCacheItem(levels=2, default_factory=dict)
+
+        self._folders_refreshing = set()
+        self._tasks_refreshing = set()
+        self._controller = controller
+
+    def reset(self):
+        self._folders_items.reset()
+        self._folders_by_id.reset()
+
+        self._task_items.reset()
+        self._tasks_by_id.reset()
+
+    def refresh_project(self, project_name):
+        self._refresh_folders_cache(project_name)
+
+    def get_folder_items(self, project_name, sender):
+        if not self._folders_items[project_name].is_valid:
+            self._refresh_folders_cache(project_name, sender)
+        return self._folders_items[project_name].get_data()
+
+    def get_task_items(self, project_name, folder_id, sender):
+        if not project_name or not folder_id:
+            return []
+
+        task_cache = self._task_items[project_name][folder_id]
+        if not task_cache.is_valid:
+            self._refresh_tasks_cache(project_name, folder_id, sender)
+        return task_cache.get_data()
+
+    def get_folder_entity(self, project_name, folder_id):
+        cache = self._folders_by_id[project_name][folder_id]
+        if not cache.is_valid:
+            entity = None
+            if folder_id:
+                entity = ayon_api.get_folder_by_id(project_name, folder_id)
+            cache.update_data(entity)
+        return cache.get_data()
+
+    def get_task_entity(self, project_name, task_id):
+        cache = self._tasks_by_id[project_name][task_id]
+        if not cache.is_valid:
+            entity = None
+            if task_id:
+                entity = ayon_api.get_task_by_id(project_name, task_id)
+            cache.update_data(entity)
+        return cache.get_data()
+
+    @contextlib.contextmanager
+    def _folder_refresh_event_manager(self, project_name, sender):
+        self._folders_refreshing.add(project_name)
+        self._controller.emit_event(
+            "folders.refresh.started",
+            {"project_name": project_name, "sender": sender},
+            HIERARCHY_MODEL_SENDER
+        )
+        try:
+            yield
+
+        finally:
+            self._controller.emit_event(
+                "folders.refresh.finished",
+                {"project_name": project_name, "sender": sender},
+                HIERARCHY_MODEL_SENDER
+            )
+            self._folders_refreshing.remove(project_name)
+
+    @contextlib.contextmanager
+    def _task_refresh_event_manager(
+        self, project_name, folder_id, sender
+    ):
+        self._tasks_refreshing.add(folder_id)
+        self._controller.emit_event(
+            "tasks.refresh.started",
+            {
+                "project_name": project_name,
+                "folder_id": folder_id,
+                "sender": sender,
+            },
+            HIERARCHY_MODEL_SENDER
+        )
+        try:
+            yield
+
+        finally:
+            self._controller.emit_event(
+                "tasks.refresh.finished",
+                {
+                    "project_name": project_name,
+                    "folder_id": folder_id,
+                    "sender": sender,
+                },
+                HIERARCHY_MODEL_SENDER
+            )
+            self._tasks_refreshing.discard(folder_id)
+
+    def _refresh_folders_cache(self, project_name, sender=None):
+        if project_name in self._folders_refreshing:
+            return
+
+        with self._folder_refresh_event_manager(project_name, sender):
+            folder_items = self._query_folders(project_name)
+            self._folders_items[project_name].update_data(folder_items)
+
+    def _query_folders(self, project_name):
+        hierarchy = ayon_api.get_folders_hierarchy(project_name)
+
+        folder_items = {}
+        hierachy_queue = collections.deque(hierarchy["hierarchy"])
+        while hierachy_queue:
+            item = hierachy_queue.popleft()
+            folder_item = _get_folder_item_from_hierarchy_item(item)
+            folder_items[folder_item.entity_id] = folder_item
+            hierachy_queue.extend(item["children"] or [])
+        return folder_items
+
+    def _refresh_tasks_cache(self, project_name, folder_id, sender=None):
+        if folder_id in self._tasks_refreshing:
+            return
+
+        with self._task_refresh_event_manager(
+            project_name, folder_id, sender
+        ):
+            task_items = self._query_tasks(project_name, folder_id)
+            self._task_items[project_name][folder_id] = task_items
+
+    def _query_tasks(self, project_name, folder_id):
+        tasks = list(ayon_api.get_tasks(
+            project_name,
+            folder_ids=[folder_id],
+            fields={"id", "name", "label", "folderId", "type"}
+        ))
+        return _get_task_items_from_tasks(tasks)
diff --git a/openpype/tools/ayon_utils/models/projects.py b/openpype/tools/ayon_utils/models/projects.py
new file mode 100644
index 0000000000..ae3eeecea4
--- /dev/null
+++ b/openpype/tools/ayon_utils/models/projects.py
@@ -0,0 +1,145 @@
+import contextlib
+from abc import ABCMeta, abstractmethod
+
+import ayon_api
+import six
+
+from openpype.style import get_default_entity_icon_color
+
+from .cache import CacheItem
+
+PROJECTS_MODEL_SENDER = "projects.model"
+
+
+@six.add_metaclass(ABCMeta)
+class AbstractHierarchyController:
+    @abstractmethod
+    def emit_event(self, topic, data, source):
+        pass
+
+
+class ProjectItem:
+    """Item representing folder entity on a server.
+
+    Folder can be a child of another folder or a project.
+
+    Args:
+        name (str): Project name.
+        active (Union[str, None]): Parent folder id. If 'None' then project
+            is parent.
+    """
+
+    def __init__(self, name, active, icon=None):
+        self.name = name
+        self.active = active
+        if icon is None:
+            icon = {
+                "type": "awesome-font",
+                "name": "fa.map",
+                "color": get_default_entity_icon_color(),
+            }
+        self.icon = icon
+
+    def to_data(self):
+        """Converts folder item to data.
+
+        Returns:
+            dict[str, Any]: Folder item data.
+        """
+
+        return {
+            "name": self.name,
+            "active": self.active,
+            "icon": self.icon,
+        }
+
+    @classmethod
+    def from_data(cls, data):
+        """Re-creates folder item from data.
+
+        Args:
+            data (dict[str, Any]): Folder item data.
+
+        Returns:
+            FolderItem: Folder item.
+        """
+
+        return cls(**data)
+
+
+def _get_project_items_from_entitiy(projects):
+    """
+
+    Args:
+        projects (list[dict[str, Any]]): List of projects.
+
+    Returns:
+        ProjectItem: Project item.
+    """
+
+    return [
+        ProjectItem(project["name"], project["active"])
+        for project in projects
+    ]
+
+
+class ProjectsModel(object):
+    def __init__(self, controller):
+        self._projects_cache = CacheItem(default_factory=dict)
+        self._project_items_by_name = {}
+        self._projects_by_name = {}
+
+        self._is_refreshing = False
+        self._controller = controller
+
+    def reset(self):
+        self._projects_cache.reset()
+        self._project_items_by_name = {}
+        self._projects_by_name = {}
+
+    def refresh(self):
+        self._refresh_projects_cache()
+
+    def get_project_items(self, sender):
+        if not self._projects_cache.is_valid:
+            self._refresh_projects_cache(sender)
+        return self._projects_cache.get_data()
+
+    def get_project_entity(self, project_name):
+        if project_name not in self._projects_by_name:
+            entity = None
+            if project_name:
+                entity = ayon_api.get_project(project_name)
+            self._projects_by_name[project_name] = entity
+        return self._projects_by_name[project_name]
+
+    @contextlib.contextmanager
+    def _project_refresh_event_manager(self, sender):
+        self._is_refreshing = True
+        self._controller.emit_event(
+            "projects.refresh.started",
+            {"sender": sender},
+            PROJECTS_MODEL_SENDER
+        )
+        try:
+            yield
+
+        finally:
+            self._controller.emit_event(
+                "projects.refresh.finished",
+                {"sender": sender},
+                PROJECTS_MODEL_SENDER
+            )
+            self._is_refreshing = False
+
+    def _refresh_projects_cache(self, sender=None):
+        if self._is_refreshing:
+            return
+
+        with self._project_refresh_event_manager(sender):
+            project_items = self._query_projects()
+            self._projects_cache.update_data(project_items)
+
+    def _query_projects(self):
+        projects = ayon_api.get_projects(fields=["name", "active"])
+        return _get_project_items_from_entitiy(projects)
diff --git a/openpype/tools/ayon_utils/widgets/__init__.py b/openpype/tools/ayon_utils/widgets/__init__.py
new file mode 100644
index 0000000000..59aef98faf
--- /dev/null
+++ b/openpype/tools/ayon_utils/widgets/__init__.py
@@ -0,0 +1,37 @@
+from .projects_widget import (
+    # ProjectsWidget,
+    ProjectsCombobox,
+    ProjectsModel,
+    ProjectSortFilterProxy,
+)
+
+from .folders_widget import (
+    FoldersWidget,
+    FoldersModel,
+)
+
+from .tasks_widget import (
+    TasksWidget,
+    TasksModel,
+)
+from .utils import (
+    get_qt_icon,
+    RefreshThread,
+)
+
+
+__all__ = (
+    # "ProjectsWidget",
+    "ProjectsCombobox",
+    "ProjectsModel",
+    "ProjectSortFilterProxy",
+
+    "FoldersWidget",
+    "FoldersModel",
+
+    "TasksWidget",
+    "TasksModel",
+
+    "get_qt_icon",
+    "RefreshThread",
+)
diff --git a/openpype/tools/ayon_utils/widgets/folders_widget.py b/openpype/tools/ayon_utils/widgets/folders_widget.py
new file mode 100644
index 0000000000..3fab64f657
--- /dev/null
+++ b/openpype/tools/ayon_utils/widgets/folders_widget.py
@@ -0,0 +1,364 @@
+import collections
+
+from qtpy import QtWidgets, QtGui, QtCore
+
+from openpype.tools.utils import (
+    RecursiveSortFilterProxyModel,
+    DeselectableTreeView,
+)
+
+from .utils import RefreshThread, get_qt_icon
+
+SENDER_NAME = "qt_folders_model"
+ITEM_ID_ROLE = QtCore.Qt.UserRole + 1
+ITEM_NAME_ROLE = QtCore.Qt.UserRole + 2
+
+
+class FoldersModel(QtGui.QStandardItemModel):
+    """Folders model which cares about refresh of folders.
+
+    Args:
+        controller (AbstractWorkfilesFrontend): The control object.
+    """
+
+    refreshed = QtCore.Signal()
+
+    def __init__(self, controller):
+        super(FoldersModel, self).__init__()
+
+        self._controller = controller
+        self._items_by_id = {}
+        self._parent_id_by_id = {}
+
+        self._refresh_threads = {}
+        self._current_refresh_thread = None
+        self._last_project_name = None
+
+        self._has_content = False
+        self._is_refreshing = False
+
+    @property
+    def is_refreshing(self):
+        """Model is refreshing.
+
+        Returns:
+            bool: True if model is refreshing.
+        """
+        return self._is_refreshing
+
+    @property
+    def has_content(self):
+        """Has at least one folder.
+
+        Returns:
+            bool: True if model has at least one folder.
+        """
+
+        return self._has_content
+
+    def clear(self):
+        self._items_by_id = {}
+        self._parent_id_by_id = {}
+        self._has_content = False
+        super(FoldersModel, self).clear()
+
+    def get_index_by_id(self, item_id):
+        """Get index by folder id.
+
+        Returns:
+            QtCore.QModelIndex: Index of the folder. Can be invalid if folder
+                is not available.
+        """
+        item = self._items_by_id.get(item_id)
+        if item is None:
+            return QtCore.QModelIndex()
+        return self.indexFromItem(item)
+
+    def set_project_name(self, project_name):
+        """Refresh folders items.
+
+        Refresh start thread because it can cause that controller can
+        start query from database if folders are not cached.
+        """
+
+        if not project_name:
+            self._last_project_name = project_name
+            self._current_refresh_thread = None
+            self._fill_items({})
+            return
+
+        self._is_refreshing = True
+
+        if self._last_project_name != project_name:
+            self.clear()
+        self._last_project_name = project_name
+
+        thread = self._refresh_threads.get(project_name)
+        if thread is not None:
+            self._current_refresh_thread = thread
+            return
+
+        thread = RefreshThread(
+            project_name,
+            self._controller.get_folder_items,
+            project_name,
+            SENDER_NAME
+        )
+        self._current_refresh_thread = thread
+        self._refresh_threads[thread.id] = thread
+        thread.refresh_finished.connect(self._on_refresh_thread)
+        thread.start()
+
+    def _on_refresh_thread(self, thread_id):
+        """Callback when refresh thread is finished.
+
+        Technically can be running multiple refresh threads at the same time,
+        to avoid using values from wrong thread, we check if thread id is
+        current refresh thread id.
+
+        Folders are stored by id.
+
+        Args:
+            thread_id (str): Thread id.
+        """
+
+        # Make sure to remove thread from '_refresh_threads' dict
+        thread = self._refresh_threads.pop(thread_id)
+        if (
+            self._current_refresh_thread is None
+            or thread_id != self._current_refresh_thread.id
+        ):
+            return
+
+        self._fill_items(thread.get_result())
+
+    def _fill_items(self, folder_items_by_id):
+        if not folder_items_by_id:
+            if folder_items_by_id is not None:
+                self.clear()
+            self._is_refreshing = False
+            self.refreshed.emit()
+            return
+
+        self._has_content = True
+
+        folder_ids = set(folder_items_by_id)
+        ids_to_remove = set(self._items_by_id) - folder_ids
+
+        folder_items_by_parent = collections.defaultdict(dict)
+        for folder_item in folder_items_by_id.values():
+            (
+                folder_items_by_parent
+                [folder_item.parent_id]
+                [folder_item.entity_id]
+            ) = folder_item
+
+        hierarchy_queue = collections.deque()
+        hierarchy_queue.append((self.invisibleRootItem(), None))
+
+        # Keep pointers to removed items until the refresh finishes
+        #   - some children of the items could be moved and reused elsewhere
+        removed_items = []
+        while hierarchy_queue:
+            item = hierarchy_queue.popleft()
+            parent_item, parent_id = item
+            folder_items = folder_items_by_parent[parent_id]
+
+            items_by_id = {}
+            folder_ids_to_add = set(folder_items)
+            for row_idx in reversed(range(parent_item.rowCount())):
+                child_item = parent_item.child(row_idx)
+                child_id = child_item.data(ITEM_ID_ROLE)
+                if child_id in ids_to_remove:
+                    removed_items.append(parent_item.takeRow(row_idx))
+                else:
+                    items_by_id[child_id] = child_item
+
+            new_items = []
+            for item_id in folder_ids_to_add:
+                folder_item = folder_items[item_id]
+                item = items_by_id.get(item_id)
+                if item is None:
+                    is_new = True
+                    item = QtGui.QStandardItem()
+                    item.setEditable(False)
+                else:
+                    is_new = self._parent_id_by_id[item_id] != parent_id
+
+                icon = get_qt_icon(folder_item.icon)
+                item.setData(item_id, ITEM_ID_ROLE)
+                item.setData(folder_item.name, ITEM_NAME_ROLE)
+                item.setData(folder_item.label, QtCore.Qt.DisplayRole)
+                item.setData(icon, QtCore.Qt.DecorationRole)
+                if is_new:
+                    new_items.append(item)
+                self._items_by_id[item_id] = item
+                self._parent_id_by_id[item_id] = parent_id
+
+                hierarchy_queue.append((item, item_id))
+
+            if new_items:
+                parent_item.appendRows(new_items)
+
+        for item_id in ids_to_remove:
+            self._items_by_id.pop(item_id)
+            self._parent_id_by_id.pop(item_id)
+
+        self._is_refreshing = False
+        self.refreshed.emit()
+
+
+class FoldersWidget(QtWidgets.QWidget):
+    """Folders widget.
+
+    Widget that handles folders view, model and selection.
+
+    Expected selection handling is disabled by default. If enabled, the
+    widget will handle the expected in predefined way. Widget is listening
+    to event 'expected_selection_changed' with expected event data below,
+    the same data must be available when called method
+    'get_expected_selection_data' on controller.
+
+    {
+        "folder": {
+            "current": bool,               # Folder is what should be set now
+            "folder_id": Union[str, None], # Folder id that should be selected
+        },
+        ...
+    }
+
+    Selection is confirmed by calling method 'expected_folder_selected' on
+    controller.
+
+
+    Args:
+        controller (AbstractWorkfilesFrontend): The control object.
+        parent (QtWidgets.QWidget): The parent widget.
+        handle_expected_selection (bool): If True, the widget will handle
+            the expected selection. Defaults to False.
+    """
+
+    def __init__(self, controller, parent, handle_expected_selection=False):
+        super(FoldersWidget, self).__init__(parent)
+
+        folders_view = DeselectableTreeView(self)
+        folders_view.setHeaderHidden(True)
+
+        folders_model = FoldersModel(controller)
+        folders_proxy_model = RecursiveSortFilterProxyModel()
+        folders_proxy_model.setSourceModel(folders_model)
+
+        folders_view.setModel(folders_proxy_model)
+
+        main_layout = QtWidgets.QHBoxLayout(self)
+        main_layout.setContentsMargins(0, 0, 0, 0)
+        main_layout.addWidget(folders_view, 1)
+
+        controller.register_event_callback(
+            "selection.project.changed",
+            self._on_project_selection_change,
+        )
+        controller.register_event_callback(
+            "folders.refresh.finished",
+            self._on_folders_refresh_finished
+        )
+        controller.register_event_callback(
+            "controller.refresh.finished",
+            self._on_controller_refresh
+        )
+        controller.register_event_callback(
+            "expected_selection_changed",
+            self._on_expected_selection_change
+        )
+
+        selection_model = folders_view.selectionModel()
+        selection_model.selectionChanged.connect(self._on_selection_change)
+
+        folders_model.refreshed.connect(self._on_model_refresh)
+
+        self._controller = controller
+        self._folders_view = folders_view
+        self._folders_model = folders_model
+        self._folders_proxy_model = folders_proxy_model
+
+        self._handle_expected_selection = handle_expected_selection
+        self._expected_selection = None
+
+    def set_name_filer(self, name):
+        """Set filter of folder name.
+
+        Args:
+            name (str): The string filter.
+        """
+
+        self._folders_proxy_model.setFilterFixedString(name)
+
+    def _on_project_selection_change(self, event):
+        project_name = event["project_name"]
+        self._set_project_name(project_name)
+
+    def _set_project_name(self, project_name):
+        self._folders_model.set_project_name(project_name)
+
+    def _clear(self):
+        self._folders_model.clear()
+
+    def _on_folders_refresh_finished(self, event):
+        if event["sender"] != SENDER_NAME:
+            self._set_project_name(event["project_name"])
+
+    def _on_controller_refresh(self):
+        self._update_expected_selection()
+
+    def _on_model_refresh(self):
+        if self._expected_selection:
+            self._set_expected_selection()
+        self._folders_proxy_model.sort(0)
+
+    def _get_selected_item_id(self):
+        selection_model = self._folders_view.selectionModel()
+        for index in selection_model.selectedIndexes():
+            item_id = index.data(ITEM_ID_ROLE)
+            if item_id is not None:
+                return item_id
+        return None
+
+    def _on_selection_change(self):
+        item_id = self._get_selected_item_id()
+        self._controller.set_selected_folder(item_id)
+
+    # Expected selection handling
+    def _on_expected_selection_change(self, event):
+        self._update_expected_selection(event.data)
+
+    def _update_expected_selection(self, expected_data=None):
+        if not self._handle_expected_selection:
+            return
+
+        if expected_data is None:
+            expected_data = self._controller.get_expected_selection_data()
+
+        folder_data = expected_data.get("folder")
+        if not folder_data or not folder_data["current"]:
+            return
+
+        folder_id = folder_data["id"]
+        self._expected_selection = folder_id
+        if not self._folders_model.is_refreshing:
+            self._set_expected_selection()
+
+    def _set_expected_selection(self):
+        if not self._handle_expected_selection:
+            return
+
+        folder_id = self._expected_selection
+        self._expected_selection = None
+        if (
+            folder_id is not None
+            and folder_id != self._get_selected_item_id()
+        ):
+            index = self._folders_model.get_index_by_id(folder_id)
+            if index.isValid():
+                proxy_index = self._folders_proxy_model.mapFromSource(index)
+                self._folders_view.setCurrentIndex(proxy_index)
+        self._controller.expected_folder_selected(folder_id)
diff --git a/openpype/tools/ayon_utils/widgets/projects_widget.py b/openpype/tools/ayon_utils/widgets/projects_widget.py
new file mode 100644
index 0000000000..818d574910
--- /dev/null
+++ b/openpype/tools/ayon_utils/widgets/projects_widget.py
@@ -0,0 +1,325 @@
+from qtpy import QtWidgets, QtCore, QtGui
+
+from openpype.tools.ayon_utils.models import PROJECTS_MODEL_SENDER
+from .utils import RefreshThread, get_qt_icon
+
+PROJECT_NAME_ROLE = QtCore.Qt.UserRole + 1
+PROJECT_IS_ACTIVE_ROLE = QtCore.Qt.UserRole + 2
+
+
+class ProjectsModel(QtGui.QStandardItemModel):
+    refreshed = QtCore.Signal()
+
+    def __init__(self, controller):
+        super(ProjectsModel, self).__init__()
+        self._controller = controller
+
+        self._project_items = {}
+
+        self._empty_item = None
+        self._empty_item_added = False
+
+        self._is_refreshing = False
+        self._refresh_thread = None
+
+    @property
+    def is_refreshing(self):
+        return self._is_refreshing
+
+    def refresh(self):
+        self._refresh()
+
+    def has_content(self):
+        return len(self._project_items) > 0
+
+    def _add_empty_item(self):
+        item = self._get_empty_item()
+        if not self._empty_item_added:
+            root_item = self.invisibleRootItem()
+            root_item.appendRow(item)
+            self._empty_item_added = True
+
+    def _remove_empty_item(self):
+        if not self._empty_item_added:
+            return
+
+        root_item = self.invisibleRootItem()
+        item = self._get_empty_item()
+        root_item.takeRow(item.row())
+        self._empty_item_added = False
+
+    def _get_empty_item(self):
+        if self._empty_item is None:
+            item = QtGui.QStandardItem("< No projects >")
+            item.setFlags(QtCore.Qt.NoItemFlags)
+            self._empty_item = item
+        return self._empty_item
+
+    def _refresh(self):
+        if self._is_refreshing:
+            return
+        self._is_refreshing = True
+        refresh_thread = RefreshThread(
+            "projects", self._query_project_items
+        )
+        refresh_thread.refresh_finished.connect(self._refresh_finished)
+        refresh_thread.start()
+        self._refresh_thread = refresh_thread
+
+    def _query_project_items(self):
+        return self._controller.get_project_items()
+
+    def _refresh_finished(self):
+        # TODO check if failed
+        result = self._refresh_thread.get_result()
+        self._refresh_thread = None
+
+        self._fill_items(result)
+
+        self._is_refreshing = False
+        self.refreshed.emit()
+
+    def _fill_items(self, project_items):
+        items_to_remove = set(self._project_items.keys())
+        new_items = []
+        for project_item in project_items:
+            project_name = project_item.name
+            items_to_remove.discard(project_name)
+            item = self._project_items.get(project_name)
+            if item is None:
+                item = QtGui.QStandardItem()
+                new_items.append(item)
+            icon = get_qt_icon(project_item.icon)
+            item.setData(project_name, QtCore.Qt.DisplayRole)
+            item.setData(icon, QtCore.Qt.DecorationRole)
+            item.setData(project_name, PROJECT_NAME_ROLE)
+            item.setData(project_item.active, PROJECT_IS_ACTIVE_ROLE)
+            self._project_items[project_name] = item
+
+        root_item = self.invisibleRootItem()
+        if new_items:
+            root_item.appendRows(new_items)
+
+        for project_name in items_to_remove:
+            item = self._project_items.pop(project_name)
+            root_item.removeRow(item.row())
+
+        if self.has_content():
+            self._remove_empty_item()
+        else:
+            self._add_empty_item()
+
+
+class ProjectSortFilterProxy(QtCore.QSortFilterProxyModel):
+    def __init__(self, *args, **kwargs):
+        super(ProjectSortFilterProxy, self).__init__(*args, **kwargs)
+        self._filter_inactive = True
+        # Disable case sensitivity
+        self.setSortCaseSensitivity(QtCore.Qt.CaseInsensitive)
+
+    def lessThan(self, left_index, right_index):
+        if left_index.data(PROJECT_NAME_ROLE) is None:
+            return True
+
+        if right_index.data(PROJECT_NAME_ROLE) is None:
+            return False
+
+        left_is_active = left_index.data(PROJECT_IS_ACTIVE_ROLE)
+        right_is_active = right_index.data(PROJECT_IS_ACTIVE_ROLE)
+        if right_is_active == left_is_active:
+            return super(ProjectSortFilterProxy, self).lessThan(
+                left_index, right_index
+            )
+
+        if left_is_active:
+            return True
+        return False
+
+    def filterAcceptsRow(self, source_row, source_parent):
+        index = self.sourceModel().index(source_row, 0, source_parent)
+        string_pattern = self.filterRegularExpression().pattern()
+        if (
+            self._filter_inactive
+            and not index.data(PROJECT_IS_ACTIVE_ROLE)
+        ):
+            return False
+
+        if string_pattern:
+            project_name = index.data(PROJECT_IS_ACTIVE_ROLE)
+            if project_name is not None:
+                return string_pattern.lower() in project_name.lower()
+
+        return super(ProjectSortFilterProxy, self).filterAcceptsRow(
+            source_row, source_parent
+        )
+
+    def _custom_index_filter(self, index):
+        return bool(index.data(PROJECT_IS_ACTIVE_ROLE))
+
+    def is_active_filter_enabled(self):
+        return self._filter_inactive
+
+    def set_active_filter_enabled(self, value):
+        if self._filter_inactive == value:
+            return
+        self._filter_inactive = value
+        self.invalidateFilter()
+
+
+class ProjectsCombobox(QtWidgets.QWidget):
+    def __init__(self, controller, parent, handle_expected_selection=False):
+        super(ProjectsCombobox, self).__init__(parent)
+
+        projects_combobox = QtWidgets.QComboBox(self)
+        combobox_delegate = QtWidgets.QStyledItemDelegate(projects_combobox)
+        projects_combobox.setItemDelegate(combobox_delegate)
+        projects_model = ProjectsModel(controller)
+        projects_proxy_model = ProjectSortFilterProxy()
+        projects_proxy_model.setSourceModel(projects_model)
+        projects_combobox.setModel(projects_proxy_model)
+
+        main_layout = QtWidgets.QHBoxLayout(self)
+        main_layout.setContentsMargins(0, 0, 0, 0)
+        main_layout.addWidget(projects_combobox, 1)
+
+        projects_model.refreshed.connect(self._on_model_refresh)
+
+        controller.register_event_callback(
+            "projects.refresh.finished",
+            self._on_projects_refresh_finished
+        )
+        controller.register_event_callback(
+            "controller.refresh.finished",
+            self._on_controller_refresh
+        )
+        controller.register_event_callback(
+            "expected_selection_changed",
+            self._on_expected_selection_change
+        )
+
+        projects_combobox.currentIndexChanged.connect(
+            self._on_current_index_changed
+        )
+
+        self._controller = controller
+        self._listen_selection_change = True
+
+        self._handle_expected_selection = handle_expected_selection
+        self._expected_selection = None
+
+        self._projects_combobox = projects_combobox
+        self._projects_model = projects_model
+        self._projects_proxy_model = projects_proxy_model
+        self._combobox_delegate = combobox_delegate
+
+    def refresh(self):
+        self._projects_model.refresh()
+
+    def set_selection(self, project_name):
+        """Set selection to a given project.
+
+        Selection change is ignored if project is not found.
+
+        Args:
+            project_name (str): Name of project.
+
+        Returns:
+            bool: True if selection was changed, False otherwise. NOTE:
+                Selection may not be changed if project is not found, or if
+                project is already selected.
+        """
+
+        idx = self._projects_combobox.findData(
+            project_name, PROJECT_NAME_ROLE)
+        if idx < 0:
+            return False
+        if idx != self._projects_combobox.currentIndex():
+            self._projects_combobox.setCurrentIndex(idx)
+            return True
+        return False
+
+    def set_listen_to_selection_change(self, listen):
+        """Disable listening to changes of the selection.
+
+        Because combobox is triggering selection change when it's model
+        is refreshed, it's necessary to disable listening to selection for
+        some cases, e.g. when is on a different page of UI and should be just
+        refreshed.
+
+        Args:
+            listen (bool): Enable or disable listening to selection changes.
+        """
+
+        self._listen_selection_change = listen
+
+    def get_current_project_name(self):
+        """Name of selected project.
+
+        Returns:
+            Union[str, None]: Name of selected project, or None if no project
+        """
+
+        idx = self._projects_combobox.currentIndex()
+        if idx < 0:
+            return None
+        return self._projects_combobox.itemData(idx, PROJECT_NAME_ROLE)
+
+    def _on_current_index_changed(self, idx):
+        if not self._listen_selection_change:
+            return
+        project_name = self._projects_combobox.itemData(
+            idx, PROJECT_NAME_ROLE)
+        self._controller.set_selected_project(project_name)
+
+    def _on_model_refresh(self):
+        self._projects_proxy_model.sort(0)
+        if self._expected_selection:
+            self._set_expected_selection()
+
+    def _on_projects_refresh_finished(self, event):
+        if event["sender"] != PROJECTS_MODEL_SENDER:
+            self._projects_model.refresh()
+
+    def _on_controller_refresh(self):
+        self._update_expected_selection()
+
+    # Expected selection handling
+    def _on_expected_selection_change(self, event):
+        self._update_expected_selection(event.data)
+
+    def _set_expected_selection(self):
+        if not self._handle_expected_selection:
+            return
+        project_name = self._expected_selection
+        if project_name is not None:
+            if project_name != self.get_current_project_name():
+                self.set_selection(project_name)
+            else:
+                # Fake project change
+                self._on_current_index_changed(
+                    self._projects_combobox.currentIndex()
+                )
+
+        self._controller.expected_project_selected(project_name)
+
+    def _update_expected_selection(self, expected_data=None):
+        if not self._handle_expected_selection:
+            return
+        if expected_data is None:
+            expected_data = self._controller.get_expected_selection_data()
+
+        project_data = expected_data.get("project")
+        if (
+            not project_data
+            or not project_data["current"]
+            or project_data["selected"]
+        ):
+            return
+        self._expected_selection = project_data["name"]
+        if not self._projects_model.is_refreshing:
+            self._set_expected_selection()
+
+
+class ProjectsWidget(QtWidgets.QWidget):
+    # TODO implement
+    pass
diff --git a/openpype/tools/ayon_utils/widgets/tasks_widget.py b/openpype/tools/ayon_utils/widgets/tasks_widget.py
new file mode 100644
index 0000000000..66ebd0b777
--- /dev/null
+++ b/openpype/tools/ayon_utils/widgets/tasks_widget.py
@@ -0,0 +1,436 @@
+from qtpy import QtWidgets, QtGui, QtCore
+
+from openpype.style import get_disabled_entity_icon_color
+from openpype.tools.utils import DeselectableTreeView
+
+from .utils import RefreshThread, get_qt_icon
+
+SENDER_NAME = "qt_tasks_model"
+ITEM_ID_ROLE = QtCore.Qt.UserRole + 1
+PARENT_ID_ROLE = QtCore.Qt.UserRole + 2
+ITEM_NAME_ROLE = QtCore.Qt.UserRole + 3
+TASK_TYPE_ROLE = QtCore.Qt.UserRole + 4
+
+
+class TasksModel(QtGui.QStandardItemModel):
+    """Tasks model which cares about refresh of tasks by folder id.
+
+    Args:
+        controller (AbstractWorkfilesFrontend): The control object.
+    """
+
+    refreshed = QtCore.Signal()
+
+    def __init__(self, controller):
+        super(TasksModel, self).__init__()
+
+        self._controller = controller
+
+        self._items_by_name = {}
+        self._has_content = False
+        self._is_refreshing = False
+
+        self._invalid_selection_item_used = False
+        self._invalid_selection_item = None
+        self._empty_tasks_item_used = False
+        self._empty_tasks_item = None
+
+        self._last_project_name = None
+        self._last_folder_id = None
+
+        self._refresh_threads = {}
+        self._current_refresh_thread = None
+
+        # Initial state
+        self._add_invalid_selection_item()
+
+    def clear(self):
+        self._items_by_name = {}
+        self._has_content = False
+        self._remove_invalid_items()
+        super(TasksModel, self).clear()
+
+    def refresh(self, project_name, folder_id):
+        """Refresh tasks for folder.
+
+        Args:
+            project_name (Union[str]): Name of project.
+            folder_id (Union[str, None]): Folder id.
+        """
+
+        self._refresh(project_name, folder_id)
+
+    def get_index_by_name(self, task_name):
+        """Find item by name and return its index.
+
+        Returns:
+            QtCore.QModelIndex: Index of item. Is invalid if task is not
+                found by name.
+        """
+
+        item = self._items_by_name.get(task_name)
+        if item is None:
+            return QtCore.QModelIndex()
+        return self.indexFromItem(item)
+
+    def get_last_project_name(self):
+        """Get last refreshed project name.
+
+        Returns:
+            Union[str, None]: Project name.
+        """
+
+        return self._last_project_name
+
+    def get_last_folder_id(self):
+        """Get last refreshed folder id.
+
+        Returns:
+            Union[str, None]: Folder id.
+        """
+
+        return self._last_folder_id
+
+    def set_selected_project(self, project_name):
+        self._selected_project_name = project_name
+
+    def _get_invalid_selection_item(self):
+        if self._invalid_selection_item is None:
+            item = QtGui.QStandardItem("Select a folder")
+            item.setFlags(QtCore.Qt.NoItemFlags)
+            icon = get_qt_icon({
+                "type": "awesome-font",
+                "name": "fa.times",
+                "color": get_disabled_entity_icon_color(),
+            })
+            item.setData(icon, QtCore.Qt.DecorationRole)
+            self._invalid_selection_item = item
+        return self._invalid_selection_item
+
+    def _get_empty_task_item(self):
+        if self._empty_tasks_item is None:
+            item = QtGui.QStandardItem("No task")
+            icon = get_qt_icon({
+                "type": "awesome-font",
+                "name": "fa.exclamation-circle",
+                "color": get_disabled_entity_icon_color(),
+            })
+            item.setData(icon, QtCore.Qt.DecorationRole)
+            item.setFlags(QtCore.Qt.NoItemFlags)
+            self._empty_tasks_item = item
+        return self._empty_tasks_item
+
+    def _add_invalid_item(self, item):
+        self.clear()
+        root_item = self.invisibleRootItem()
+        root_item.appendRow(item)
+
+    def _remove_invalid_item(self, item):
+        root_item = self.invisibleRootItem()
+        root_item.takeRow(item.row())
+
+    def _remove_invalid_items(self):
+        self._remove_invalid_selection_item()
+        self._remove_empty_task_item()
+
+    def _add_invalid_selection_item(self):
+        if not self._invalid_selection_item_used:
+            self._add_invalid_item(self._get_invalid_selection_item())
+            self._invalid_selection_item_used = True
+
+    def _remove_invalid_selection_item(self):
+        if self._invalid_selection_item:
+            self._remove_invalid_item(self._get_invalid_selection_item())
+            self._invalid_selection_item_used = False
+
+    def _add_empty_task_item(self):
+        if not self._empty_tasks_item_used:
+            self._add_invalid_item(self._get_empty_task_item())
+            self._empty_tasks_item_used = True
+
+    def _remove_empty_task_item(self):
+        if self._empty_tasks_item_used:
+            self._remove_invalid_item(self._get_empty_task_item())
+            self._empty_tasks_item_used = False
+
+    def _refresh(self, project_name, folder_id):
+        self._is_refreshing = True
+        self._last_project_name = project_name
+        self._last_folder_id = folder_id
+        if not folder_id:
+            self._add_invalid_selection_item()
+            self._current_refresh_thread = None
+            self._is_refreshing = False
+            self.refreshed.emit()
+            return
+
+        thread = self._refresh_threads.get(folder_id)
+        if thread is not None:
+            self._current_refresh_thread = thread
+            return
+        thread = RefreshThread(
+            folder_id,
+            self._controller.get_task_items,
+            project_name,
+            folder_id
+        )
+        self._current_refresh_thread = thread
+        self._refresh_threads[thread.id] = thread
+        thread.refresh_finished.connect(self._on_refresh_thread)
+        thread.start()
+
+    def _on_refresh_thread(self, thread_id):
+        """Callback when refresh thread is finished.
+
+        Technically can be running multiple refresh threads at the same time,
+        to avoid using values from wrong thread, we check if thread id is
+        current refresh thread id.
+
+        Tasks are stored by name, so if a folder has same task name as
+        previously selected folder it keeps the selection.
+
+        Args:
+            thread_id (str): Thread id.
+        """
+
+        # Make sure to remove thread from '_refresh_threads' dict
+        thread = self._refresh_threads.pop(thread_id)
+        if (
+            self._current_refresh_thread is None
+            or thread_id != self._current_refresh_thread.id
+        ):
+            return
+
+        task_items = thread.get_result()
+        # Task items are refreshed
+        if task_items is None:
+            return
+
+        # No tasks are available on folder
+        if not task_items:
+            self._add_empty_task_item()
+            return
+        self._remove_invalid_items()
+
+        new_items = []
+        new_names = set()
+        for task_item in task_items:
+            name = task_item.name
+            new_names.add(name)
+            item = self._items_by_name.get(name)
+            if item is None:
+                item = QtGui.QStandardItem()
+                item.setEditable(False)
+                new_items.append(item)
+                self._items_by_name[name] = item
+
+            # TODO cache locally
+            icon = get_qt_icon(task_item.icon)
+            item.setData(task_item.label, QtCore.Qt.DisplayRole)
+            item.setData(name, ITEM_NAME_ROLE)
+            item.setData(task_item.id, ITEM_ID_ROLE)
+            item.setData(task_item.parent_id, PARENT_ID_ROLE)
+            item.setData(icon, QtCore.Qt.DecorationRole)
+
+        root_item = self.invisibleRootItem()
+
+        for name in set(self._items_by_name) - new_names:
+            item = self._items_by_name.pop(name)
+            root_item.removeRow(item.row())
+
+        if new_items:
+            root_item.appendRows(new_items)
+
+        self._has_content = root_item.rowCount() > 0
+        self._is_refreshing = False
+        self.refreshed.emit()
+
+    @property
+    def is_refreshing(self):
+        """Model is refreshing.
+
+        Returns:
+            bool: Model is refreshing
+        """
+
+        return self._is_refreshing
+
+    @property
+    def has_content(self):
+        """Model has content.
+
+        Returns:
+            bools: Have at least one task.
+        """
+
+        return self._has_content
+
+    def headerData(self, section, orientation, role):
+        # Show nice labels in the header
+        if (
+            role == QtCore.Qt.DisplayRole
+            and orientation == QtCore.Qt.Horizontal
+        ):
+            if section == 0:
+                return "Tasks"
+
+        return super(TasksModel, self).headerData(
+            section, orientation, role
+        )
+
+
+class TasksWidget(QtWidgets.QWidget):
+    """Tasks widget.
+
+    Widget that handles tasks view, model and selection.
+
+    Args:
+        controller (AbstractWorkfilesFrontend): Workfiles controller.
+        parent (QtWidgets.QWidget): Parent widget.
+        handle_expected_selection (Optional[bool]): Handle expected selection.
+    """
+
+    def __init__(self, controller, parent, handle_expected_selection=False):
+        super(TasksWidget, self).__init__(parent)
+
+        tasks_view = DeselectableTreeView(self)
+        tasks_view.setIndentation(0)
+
+        tasks_model = TasksModel(controller)
+        tasks_proxy_model = QtCore.QSortFilterProxyModel()
+        tasks_proxy_model.setSourceModel(tasks_model)
+
+        tasks_view.setModel(tasks_proxy_model)
+
+        main_layout = QtWidgets.QHBoxLayout(self)
+        main_layout.setContentsMargins(0, 0, 0, 0)
+        main_layout.addWidget(tasks_view, 1)
+
+        controller.register_event_callback(
+            "tasks.refresh.finished",
+            self._on_tasks_refresh_finished
+        )
+        controller.register_event_callback(
+            "selection.folder.changed",
+            self._folder_selection_changed
+        )
+        controller.register_event_callback(
+            "expected_selection_changed",
+            self._on_expected_selection_change
+        )
+
+        selection_model = tasks_view.selectionModel()
+        selection_model.selectionChanged.connect(self._on_selection_change)
+
+        tasks_model.refreshed.connect(self._on_tasks_model_refresh)
+
+        self._controller = controller
+        self._tasks_view = tasks_view
+        self._tasks_model = tasks_model
+        self._tasks_proxy_model = tasks_proxy_model
+
+        self._selected_folder_id = None
+
+        self._handle_expected_selection = handle_expected_selection
+        self._expected_selection_data = None
+
+    def _clear(self):
+        self._tasks_model.clear()
+
+    def _on_tasks_refresh_finished(self, event):
+        """Tasks were refreshed in controller.
+
+        Ignore if refresh was triggered by tasks model, or refreshed folder is
+        not the same as currently selected folder.
+
+        Args:
+            event (Event): Event object.
+        """
+
+        # Refresh only if current folder id is the same
+        if (
+            event["sender"] == SENDER_NAME
+            or event["folder_id"] != self._selected_folder_id
+        ):
+            return
+        self._tasks_model.refresh(
+            event["project_name"], self._selected_folder_id
+        )
+
+    def _folder_selection_changed(self, event):
+        self._selected_folder_id = event["folder_id"]
+        self._tasks_model.refresh(
+            event["project_name"], self._selected_folder_id
+        )
+
+    def _on_tasks_model_refresh(self):
+        if not self._set_expected_selection():
+            self._on_selection_change()
+        self._tasks_proxy_model.sort(0)
+
+    def _get_selected_item_ids(self):
+        selection_model = self._tasks_view.selectionModel()
+        for index in selection_model.selectedIndexes():
+            task_id = index.data(ITEM_ID_ROLE)
+            task_name = index.data(ITEM_NAME_ROLE)
+            parent_id = index.data(PARENT_ID_ROLE)
+            if task_name is not None:
+                return parent_id, task_id, task_name
+        return self._selected_folder_id, None, None
+
+    def _on_selection_change(self):
+        # Don't trigger task change during refresh
+        #   - a task was deselected if that happens
+        #   - can cause crash triggered during tasks refreshing
+        if self._tasks_model.is_refreshing:
+            return
+
+        parent_id, task_id, task_name = self._get_selected_item_ids()
+        self._controller.set_selected_task(task_id, task_name)
+
+    # Expected selection handling
+    def _on_expected_selection_change(self, event):
+        self._update_expected_selection(event.data)
+
+    def _set_expected_selection(self):
+        if not self._handle_expected_selection:
+            return False
+
+        if self._expected_selection_data is None:
+            return False
+        folder_id = self._expected_selection_data["folder_id"]
+        task_name = self._expected_selection_data["task_name"]
+        self._expected_selection_data = None
+        model_folder_id = self._tasks_model.get_last_folder_id()
+        if folder_id != model_folder_id:
+            return False
+        if task_name is not None:
+            index = self._tasks_model.get_index_by_name(task_name)
+            if index.isValid():
+                proxy_index = self._tasks_proxy_model.mapFromSource(index)
+                self._tasks_view.setCurrentIndex(proxy_index)
+        self._controller.expected_task_selected(folder_id, task_name)
+        return True
+
+    def _update_expected_selection(self, expected_data=None):
+        if not self._handle_expected_selection:
+            return
+        if expected_data is None:
+            expected_data = self._controller.get_expected_selection_data()
+        folder_data = expected_data.get("folder")
+        task_data = expected_data.get("task")
+        if (
+            not folder_data
+            or not task_data
+            or not task_data["current"]
+        ):
+            return
+        folder_id = folder_data["id"]
+        self._expected_selection_data = {
+            "task_name": task_data["name"],
+            "folder_id": folder_id,
+        }
+        model_folder_id = self._tasks_model.get_last_folder_id()
+        if folder_id != model_folder_id or self._tasks_model.is_refreshing:
+            return
+        self._set_expected_selection()
diff --git a/openpype/tools/ayon_utils/widgets/utils.py b/openpype/tools/ayon_utils/widgets/utils.py
new file mode 100644
index 0000000000..8bc3b1ea9b
--- /dev/null
+++ b/openpype/tools/ayon_utils/widgets/utils.py
@@ -0,0 +1,98 @@
+import os
+from functools import partial
+
+from qtpy import QtCore, QtGui
+
+from openpype.tools.utils.lib import get_qta_icon_by_name_and_color
+
+
+class RefreshThread(QtCore.QThread):
+    refresh_finished = QtCore.Signal(str)
+
+    def __init__(self, thread_id, func, *args, **kwargs):
+        super(RefreshThread, self).__init__()
+        self._id = thread_id
+        self._callback = partial(func, *args, **kwargs)
+        self._exception = None
+        self._result = None
+
+    @property
+    def id(self):
+        return self._id
+
+    @property
+    def failed(self):
+        return self._exception is not None
+
+    def run(self):
+        try:
+            self._result = self._callback()
+        except Exception as exc:
+            self._exception = exc
+        self.refresh_finished.emit(self.id)
+
+    def get_result(self):
+        return self._result
+
+
+class _IconsCache:
+    """Cache for icons."""
+
+    _cache = {}
+    _default = None
+
+    @classmethod
+    def _get_cache_key(cls, icon_def):
+        parts = []
+        icon_type = icon_def["type"]
+        if icon_type == "path":
+            parts = [icon_type, icon_def["path"]]
+
+        elif icon_type == "awesome-font":
+            parts = [icon_type, icon_def["name"], icon_def["color"]]
+        return "|".join(parts)
+
+    @classmethod
+    def get_icon(cls, icon_def):
+        icon_type = icon_def["type"]
+        cache_key = cls._get_cache_key(icon_def)
+        cache = cls._cache.get(cache_key)
+        if cache is not None:
+            return cache
+
+        icon = None
+        if icon_type == "path":
+            path = icon_def["path"]
+            if os.path.exists(path):
+                icon = QtGui.QIcon(path)
+
+        elif icon_type == "awesome-font":
+            icon_name = icon_def["name"]
+            icon_color = icon_def["color"]
+            icon = get_qta_icon_by_name_and_color(icon_name, icon_color)
+            if icon is None:
+                icon = get_qta_icon_by_name_and_color(
+                    "fa.{}".format(icon_name), icon_color)
+        if icon is None:
+            icon = cls.get_default()
+        cls._cache[cache_key] = icon
+        return icon
+
+    @classmethod
+    def get_default(cls):
+        pix = QtGui.QPixmap(1, 1)
+        pix.fill(QtCore.Qt.transparent)
+        return QtGui.QIcon(pix)
+
+
+def get_qt_icon(icon_def):
+    """Returns icon from cache or creates new one.
+
+    Args:
+        icon_def (dict[str, Any]): Icon definition.
+
+    Returns:
+        QtGui.QIcon: Icon.
+    """
+
+    return _IconsCache.get_icon(icon_def)
diff --git a/openpype/tools/launcher/actions.py b/openpype/tools/launcher/actions.py
index 61660ee9b7..285b5d04ca 100644
--- a/openpype/tools/launcher/actions.py
+++ b/openpype/tools/launcher/actions.py
@@ -1,8 +1,5 @@
-import os
-
 from qtpy import QtWidgets, QtGui
 
-from openpype import PLUGINS_DIR
 from openpype import style
 from openpype import resources
 from openpype.lib import (
@@ -10,46 +7,7 @@ from openpype.lib import (
     ApplictionExecutableNotFound,
     ApplicationLaunchFailed
 )
-from openpype.pipeline import (
-    LauncherAction,
-    register_launcher_action_path,
-)
-
-
-def register_actions_from_paths(paths):
-    if not paths:
-        return
-
-    for path in paths:
-        if not path:
-            continue
-
-        if path.startswith("."):
-            print((
-                "BUG: Relative paths are not allowed for security reasons. {}"
-            ).format(path))
-            continue
-
-        if not os.path.exists(path):
-            print("Path was not found: {}".format(path))
-            continue
-
-        register_launcher_action_path(path)
-
-
-def register_config_actions():
-    """Register actions from the configuration for Launcher"""
-
-    actions_dir = os.path.join(PLUGINS_DIR, "actions")
-    if os.path.exists(actions_dir):
-        register_actions_from_paths([actions_dir])
-
-
-def register_environment_actions():
-    """Register actions from AVALON_ACTIONS for Launcher."""
-
-    paths_str = os.environ.get("AVALON_ACTIONS") or ""
-    register_actions_from_paths(paths_str.split(os.pathsep))
+from openpype.pipeline import LauncherAction
 
 
 # TODO move to 'openpype.pipeline.actions'
diff --git a/openpype/tools/utils/__init__.py b/openpype/tools/utils/__init__.py
index d343353112..018088e916 100644
--- a/openpype/tools/utils/__init__.py
+++ b/openpype/tools/utils/__init__.py
@@ -15,6 +15,10 @@ from .widgets import (
     IconButton,
     PixmapButton,
     SeparatorWidget,
+    VerticalExpandButton,
+    SquareButton,
+    RefreshButton,
+    GoToCurrentButton,
 )
 from .views import DeselectableTreeView
 from .error_dialog import ErrorMessageBox
@@ -60,6 +64,11 @@ __all__ = (
     "PixmapButton",
     "SeparatorWidget",
 
+    "VerticalExpandButton",
+    "SquareButton",
+    "RefreshButton",
+    "GoToCurrentButton",
+
     "DeselectableTreeView",
 
     "ErrorMessageBox",
diff --git a/openpype/tools/utils/widgets.py b/openpype/tools/utils/widgets.py
index a70437cc65..9223afecaa 100644
--- a/openpype/tools/utils/widgets.py
+++ b/openpype/tools/utils/widgets.py
@@ -6,10 +6,13 @@ import qtawesome
 
 from openpype.style import (
     get_objected_colors,
-    get_style_image_path
+    get_style_image_path,
+    get_default_tools_icon_color,
 )
 from openpype.lib.attribute_definitions import AbstractAttrDef
 
+from .lib import get_qta_icon_by_name_and_color
+
 log = logging.getLogger(__name__)
 
 
@@ -777,3 +780,77 @@ class SeparatorWidget(QtWidgets.QFrame):
         self._orientation = orientation
 
         self._set_size(self._size)
+
+
+def get_refresh_icon():
+    return get_qta_icon_by_name_and_color(
+        "fa.refresh", get_default_tools_icon_color()
+    )
+
+
+def get_go_to_current_icon():
+    return get_qta_icon_by_name_and_color(
+        "fa.arrow-down", get_default_tools_icon_color()
+    )
+
+
+class VerticalExpandButton(QtWidgets.QPushButton):
+    """Button which is expanding vertically.
+
+    By default, button is a little bit smaller than other widgets like
+        QLineEdit. This button is expanding vertically to match size of
+        other widgets, next to it.
+    """
+
+    def __init__(self, parent=None):
+        super(VerticalExpandButton, self).__init__(parent)
+
+        sp = self.sizePolicy()
+        sp.setVerticalPolicy(QtWidgets.QSizePolicy.Minimum)
+        self.setSizePolicy(sp)
+
+
+class SquareButton(QtWidgets.QPushButton):
+    """Make button square shape.
+
+    Change width to match height on resize.
+    """
+
+    def __init__(self, *args, **kwargs):
+        super(SquareButton, self).__init__(*args, **kwargs)
+
+        sp = self.sizePolicy()
+        sp.setVerticalPolicy(QtWidgets.QSizePolicy.Minimum)
+        sp.setHorizontalPolicy(QtWidgets.QSizePolicy.Minimum)
+        self.setSizePolicy(sp)
+        self._ideal_width = None
+
+    def showEvent(self, event):
+        super(SquareButton, self).showEvent(event)
+        self._ideal_width = self.height()
+        self.updateGeometry()
+
+    def resizeEvent(self, event):
+        super(SquareButton, self).resizeEvent(event)
+        self._ideal_width = self.height()
+        self.updateGeometry()
+
+    def sizeHint(self):
+        sh = super(SquareButton, self).sizeHint()
+        ideal_width = self._ideal_width
+        if ideal_width is None:
+            ideal_width = sh.height()
+        sh.setWidth(ideal_width)
+        return sh
+
+
+class RefreshButton(VerticalExpandButton):
+    def __init__(self, parent=None):
+        super(RefreshButton, self).__init__(parent)
+        self.setIcon(get_refresh_icon())
+
+
+class GoToCurrentButton(VerticalExpandButton):
+    def __init__(self, parent=None):
+        super(GoToCurrentButton, self).__init__(parent)
+        self.setIcon(get_go_to_current_icon())

From bfb5868417f1fbf127b65bdf8cb214585a2312b7 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <43494761+iLLiCiTiT@users.noreply.github.com>
Date: Fri, 22 Sep 2023 14:18:57 +0200
Subject: [PATCH 298/366] AYON: Fix task type short name conversion (#5641)

* fix task type short name conversion

* workfiles tool can query project entity

* use project entity to fill task template data
---
 openpype/client/server/conversion_utils.py    |  2 ++
 openpype/tools/ayon_workfiles/abstract.py     | 10 ++++++++++
 openpype/tools/ayon_workfiles/control.py      |  3 +++
 .../tools/ayon_workfiles/models/hierarchy.py  | 11 ++++++++++
 .../tools/ayon_workfiles/models/workfiles.py  | 20 ++++++++++++++-----
 5 files changed, 41 insertions(+), 5 deletions(-)

diff --git a/openpype/client/server/conversion_utils.py b/openpype/client/server/conversion_utils.py
index f67a1ef9c4..8c18cb1c13 100644
--- a/openpype/client/server/conversion_utils.py
+++ b/openpype/client/server/conversion_utils.py
@@ -235,6 +235,8 @@ def convert_v4_project_to_v3(project):
         new_task_types = {}
         for task_type in task_types:
             name = task_type.pop("name")
+            # Change 'shortName' to 'short_name'
+            task_type["short_name"] = task_type.pop("shortName", None)
             new_task_types[name] = task_type
 
         config["tasks"] = new_task_types
diff --git a/openpype/tools/ayon_workfiles/abstract.py b/openpype/tools/ayon_workfiles/abstract.py
index e30a2c2499..f511181837 100644
--- a/openpype/tools/ayon_workfiles/abstract.py
+++ b/openpype/tools/ayon_workfiles/abstract.py
@@ -442,6 +442,16 @@ class AbstractWorkfilesBackend(AbstractWorkfilesCommon):
 
         pass
 
+    @abstractmethod
+    def get_project_entity(self):
+        """Get current project entity.
+
+        Returns:
+            dict[str, Any]: Project entity data.
+        """
+
+        pass
+
     @abstractmethod
     def get_folder_entity(self, folder_id):
         """Get folder entity by id.
diff --git a/openpype/tools/ayon_workfiles/control.py b/openpype/tools/ayon_workfiles/control.py
index fc8819bff3..1153a3c01f 100644
--- a/openpype/tools/ayon_workfiles/control.py
+++ b/openpype/tools/ayon_workfiles/control.py
@@ -193,6 +193,9 @@ class BaseWorkfileController(
             self._project_anatomy = Anatomy(self.get_current_project_name())
         return self._project_anatomy
 
+    def get_project_entity(self):
+        return self._entities_model.get_project_entity()
+
     def get_folder_entity(self, folder_id):
         return self._entities_model.get_folder_entity(folder_id)
 
diff --git a/openpype/tools/ayon_workfiles/models/hierarchy.py b/openpype/tools/ayon_workfiles/models/hierarchy.py
index 948c0b8a17..a1d51525da 100644
--- a/openpype/tools/ayon_workfiles/models/hierarchy.py
+++ b/openpype/tools/ayon_workfiles/models/hierarchy.py
@@ -77,8 +77,11 @@ class EntitiesModel(object):
     event_source = "entities.model"
 
     def __init__(self, controller):
+        project_cache = CacheItem()
+        project_cache.set_invalid({})
         folders_cache = CacheItem()
         folders_cache.set_invalid({})
+        self._project_cache = project_cache
         self._folders_cache = folders_cache
         self._tasks_cache = {}
 
@@ -90,6 +93,7 @@ class EntitiesModel(object):
         self._controller = controller
 
     def reset(self):
+        self._project_cache.set_invalid({})
         self._folders_cache.set_invalid({})
         self._tasks_cache = {}
 
@@ -99,6 +103,13 @@ class EntitiesModel(object):
     def refresh(self):
         self._refresh_folders_cache()
 
+    def get_project_entity(self):
+        if not self._project_cache.is_valid:
+            project_name = self._controller.get_current_project_name()
+            project_entity = ayon_api.get_project(project_name)
+            self._project_cache.update_data(project_entity)
+        return self._project_cache.get_data()
+
     def get_folder_items(self, sender):
         if not self._folders_cache.is_valid:
             self._refresh_folders_cache(sender)
diff --git a/openpype/tools/ayon_workfiles/models/workfiles.py b/openpype/tools/ayon_workfiles/models/workfiles.py
index eb82f62de3..316d8b2a16 100644
--- a/openpype/tools/ayon_workfiles/models/workfiles.py
+++ b/openpype/tools/ayon_workfiles/models/workfiles.py
@@ -43,13 +43,21 @@ def get_folder_template_data(folder):
     }
 
 
-def get_task_template_data(task):
+def get_task_template_data(project_entity, task):
     if not task:
         return {}
+    short_name = None
+    task_type_name = task["taskType"]
+    for task_type_info in project_entity["config"]["taskTypes"]:
+        if task_type_info["name"] == task_type_name:
+            short_name = task_type_info["shortName"]
+            break
+
     return {
         "task": {
             "name": task["name"],
-            "type": task["taskType"]
+            "type": task_type_name,
+            "short": short_name,
         }
     }
 
@@ -145,12 +153,13 @@ class WorkareaModel:
             self._fill_data_by_folder_id[folder_id] = fill_data
         return copy.deepcopy(fill_data)
 
-    def _get_task_data(self, folder_id, task_id):
+    def _get_task_data(self, project_entity, folder_id, task_id):
         task_data = self._task_data_by_folder_id.setdefault(folder_id, {})
         if task_id not in task_data:
             task = self._controller.get_task_entity(task_id)
             if task:
-                task_data[task_id] = get_task_template_data(task)
+                task_data[task_id] = get_task_template_data(
+                    project_entity, task)
         return copy.deepcopy(task_data[task_id])
 
     def _prepare_fill_data(self, folder_id, task_id):
@@ -159,7 +168,8 @@ class WorkareaModel:
 
         base_data = self._get_base_data()
         folder_data = self._get_folder_data(folder_id)
-        task_data = self._get_task_data(folder_id, task_id)
+        project_entity = self._controller.get_project_entity()
+        task_data = self._get_task_data(project_entity, folder_id, task_id)
 
         base_data.update(folder_data)
         base_data.update(task_data)

From dd2255f8fd13919d8e3d2d2df02652a515f00a57 Mon Sep 17 00:00:00 2001
From: Kayla Man <moonyuet2008@hotmail.com>
Date: Fri, 22 Sep 2023 20:39:33 +0800
Subject: [PATCH 299/366] jakub's comment

---
 openpype/hosts/nuke/api/plugin.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/openpype/hosts/nuke/api/plugin.py b/openpype/hosts/nuke/api/plugin.py
index a814615164..fe7b52cd8a 100644
--- a/openpype/hosts/nuke/api/plugin.py
+++ b/openpype/hosts/nuke/api/plugin.py
@@ -808,8 +808,8 @@ class ExporterReviewMov(ExporterReview):
             filename = os.path.basename(self.path_in)
             self.file = filename
             if ".{}".format(self.ext) not in self.file:
-                wrg_ext = filename.split(".")[-1]
-                self.file = filename.replace(wrg_ext, self.ext)
+                original_ext = filename.split(".")[-1]
+                self.file = filename.replace(original_ext, self.ext)
 
         self.path = os.path.join(
             self.staging_dir, self.file).replace("\\", "/")

From d744a486d64134455ffc636fef92ce09c9742b5f Mon Sep 17 00:00:00 2001
From: Kayla Man <moonyuet2008@hotmail.com>
Date: Fri, 22 Sep 2023 21:38:30 +0800
Subject: [PATCH 300/366] edit the settings where deprecated_setting used when
 it enabled; current_setting adopted when deprecated_setting diabled in
 extract_reiew_baking_streams

---
 .../publish/extract_review_baking_streams.py  | 30 ++++++-------------
 1 file changed, 9 insertions(+), 21 deletions(-)

diff --git a/openpype/hosts/nuke/plugins/publish/extract_review_baking_streams.py b/openpype/hosts/nuke/plugins/publish/extract_review_baking_streams.py
index 59a3f659c9..d9ae673c2c 100644
--- a/openpype/hosts/nuke/plugins/publish/extract_review_baking_streams.py
+++ b/openpype/hosts/nuke/plugins/publish/extract_review_baking_streams.py
@@ -28,30 +28,18 @@ class ExtractReviewDataBakingStreams(publish.Extractor):
     @classmethod
     def apply_settings(cls, project_settings):
         """just in case there are some old presets
-        in deprecrated ExtractReviewDataMov Plugins
+        in deprecated ExtractReviewDataMov Plugins
         """
         nuke_publish = project_settings["nuke"]["publish"]
-        deprecrated_review_settings = nuke_publish["ExtractReviewDataMov"]
-        current_review_settings = (
-            nuke_publish["ExtractReviewDataBakingStreams"]
-        )
-        if deprecrated_review_settings["viewer_lut_raw"] == (
-            current_review_settings["viewer_lut_raw"]
-        ):
-            cls.viewer_lut_raw = (
-                current_review_settings["viewer_lut_raw"]
-            )
+        deprecated_setting = nuke_publish["ExtractReviewDataMov"]
+        current_setting = nuke_publish["ExtractReviewDataBakingStreams"]
+        if not deprecated_setting["enabled"]:
+            if current_setting["enabled"]:
+                cls.viewer_lut_raw = current_setting["viewer_lut_raw"]
+                cls.outputs = current_setting["outputs"]
         else:
-            cls.viewer_lut_raw = (
-                deprecrated_review_settings["viewer_lut_raw"]
-            )
-
-        if deprecrated_review_settings["outputs"] == (
-            current_review_settings["outputs"]
-        ):
-            cls.outputs = current_review_settings["outputs"]
-        else:
-            cls.outputs = deprecrated_review_settings["outputs"]
+            cls.viewer_lut_raw = deprecated_setting["viewer_lut_raw"]
+            cls.outputs = deprecated_setting["outputs"]
 
     def process(self, instance):
         families = set(instance.data["families"])

From d498afbf489eefbe3a2733a17d6f8ebe988abf79 Mon Sep 17 00:00:00 2001
From: Simone Barbieri <simone.barbieri@hey.com>
Date: Fri, 22 Sep 2023 15:24:17 +0100
Subject: [PATCH 301/366] New family ue_yeticache, new creator and extractor

---
 .../plugins/create/create_unreal_yeticache.py | 39 ++++++++++++
 .../plugins/publish/collect_yeti_cache.py     |  2 +-
 .../publish/extract_unreal_yeticache.py       | 62 +++++++++++++++++++
 .../plugins/publish/collect_resources_path.py |  3 +-
 openpype/plugins/publish/integrate.py         |  3 +-
 5 files changed, 106 insertions(+), 3 deletions(-)
 create mode 100644 openpype/hosts/maya/plugins/create/create_unreal_yeticache.py
 create mode 100644 openpype/hosts/maya/plugins/publish/extract_unreal_yeticache.py

diff --git a/openpype/hosts/maya/plugins/create/create_unreal_yeticache.py b/openpype/hosts/maya/plugins/create/create_unreal_yeticache.py
new file mode 100644
index 0000000000..8ff3dccea2
--- /dev/null
+++ b/openpype/hosts/maya/plugins/create/create_unreal_yeticache.py
@@ -0,0 +1,39 @@
+from openpype.hosts.maya.api import (
+    lib,
+    plugin
+)
+from openpype.lib import NumberDef
+
+
+class CreateYetiCache(plugin.MayaCreator):
+    """Output for procedural plugin nodes of Yeti """
+
+    identifier = "io.openpype.creators.maya.unrealyeticache"
+    label = "Unreal Yeti Cache"
+    family = "ue_yeticache"
+    icon = "pagelines"
+
+    def get_instance_attr_defs(self):
+
+        defs = [
+            NumberDef("preroll",
+                      label="Preroll",
+                      minimum=0,
+                      default=0,
+                      decimals=0)
+        ]
+
+        # Add animation data without step and handles
+        defs.extend(lib.collect_animation_defs())
+        remove = {"step", "handleStart", "handleEnd"}
+        defs = [attr_def for attr_def in defs if attr_def.key not in remove]
+
+        # Add samples after frame range
+        defs.append(
+            NumberDef("samples",
+                      label="Samples",
+                      default=3,
+                      decimals=0)
+        )
+
+        return defs
diff --git a/openpype/hosts/maya/plugins/publish/collect_yeti_cache.py b/openpype/hosts/maya/plugins/publish/collect_yeti_cache.py
index 4dcda29050..426e330f89 100644
--- a/openpype/hosts/maya/plugins/publish/collect_yeti_cache.py
+++ b/openpype/hosts/maya/plugins/publish/collect_yeti_cache.py
@@ -39,7 +39,7 @@ class CollectYetiCache(pyblish.api.InstancePlugin):
 
     order = pyblish.api.CollectorOrder + 0.45
     label = "Collect Yeti Cache"
-    families = ["yetiRig", "yeticache"]
+    families = ["yetiRig", "yeticache", "ue_yeticache"]
     hosts = ["maya"]
 
     def process(self, instance):
diff --git a/openpype/hosts/maya/plugins/publish/extract_unreal_yeticache.py b/openpype/hosts/maya/plugins/publish/extract_unreal_yeticache.py
new file mode 100644
index 0000000000..2279d52111
--- /dev/null
+++ b/openpype/hosts/maya/plugins/publish/extract_unreal_yeticache.py
@@ -0,0 +1,62 @@
+import os
+import json
+
+from maya import cmds
+
+from openpype.pipeline import publish
+
+
+class ExtractYetiCache(publish.Extractor):
+    """Producing Yeti cache files using scene time range.
+
+    This will extract Yeti cache file sequence and fur settings.
+    """
+
+    label = "Extract Yeti Cache"
+    hosts = ["maya"]
+    families = ["ue_yeticache"]
+
+    def process(self, instance):
+
+        yeti_nodes = cmds.ls(instance, type="pgYetiMaya")
+        if not yeti_nodes:
+            raise RuntimeError("No pgYetiMaya nodes found in the instance")
+
+        # Define extract output file path
+        dirname = self.staging_dir(instance)
+
+        # Collect information for writing cache
+        start_frame = instance.data["frameStartHandle"]
+        end_frame = instance.data["frameEndHandle"]
+        preroll = instance.data["preroll"]
+        if preroll > 0:
+            start_frame -= preroll
+
+        kwargs = {}
+        samples = instance.data.get("samples", 0)
+        if samples == 0:
+            kwargs.update({"sampleTimes": "0.0 1.0"})
+        else:
+            kwargs.update({"samples": samples})
+
+        self.log.debug(f"Writing out cache {start_frame} - {end_frame}")
+        filename = "{0}.abc".format(instance.name)
+        path = os.path.join(dirname, filename)
+        cmds.pgYetiCommand(yeti_nodes,
+                           writeAlembic=path,
+                           range=(start_frame, end_frame),
+                           asUnrealAbc=True,
+                           **kwargs)
+
+        if "representations" not in instance.data:
+            instance.data["representations"] = []
+
+        representation = {
+            'name': 'abc',
+            'ext': 'abc',
+            'files': filename,
+            'stagingDir': dirname
+        }
+        instance.data["representations"].append(representation)
+
+        self.log.debug(f"Extracted {instance} to {dirname}")
diff --git a/openpype/plugins/publish/collect_resources_path.py b/openpype/plugins/publish/collect_resources_path.py
index f96dd0ae18..6840509f79 100644
--- a/openpype/plugins/publish/collect_resources_path.py
+++ b/openpype/plugins/publish/collect_resources_path.py
@@ -62,7 +62,8 @@ class CollectResourcesPath(pyblish.api.InstancePlugin):
                 "effect",
                 "staticMesh",
                 "skeletalMesh",
-                "xgen"
+                "xgen",
+                "ue_yeticache"
                 ]
 
     def process(self, instance):
diff --git a/openpype/plugins/publish/integrate.py b/openpype/plugins/publish/integrate.py
index 7e48155b9e..24fbc0d8e7 100644
--- a/openpype/plugins/publish/integrate.py
+++ b/openpype/plugins/publish/integrate.py
@@ -139,7 +139,8 @@ class IntegrateAsset(pyblish.api.InstancePlugin):
                 "simpleUnrealTexture",
                 "online",
                 "uasset",
-                "blendScene"
+                "blendScene",
+                "ue_yeticache"
                 ]
 
     default_template_name = "publish"

From 9781104f4e69f0d557fc4ec7e32afa8d26583e11 Mon Sep 17 00:00:00 2001
From: Simone Barbieri <simone.barbieri@hey.com>
Date: Fri, 22 Sep 2023 15:49:38 +0100
Subject: [PATCH 302/366] Implemented Unreal loader

---
 .../unreal/plugins/load/load_yeticache.py     | 151 ++++++++++++++++++
 1 file changed, 151 insertions(+)
 create mode 100644 openpype/hosts/unreal/plugins/load/load_yeticache.py

diff --git a/openpype/hosts/unreal/plugins/load/load_yeticache.py b/openpype/hosts/unreal/plugins/load/load_yeticache.py
new file mode 100644
index 0000000000..59dbdbee31
--- /dev/null
+++ b/openpype/hosts/unreal/plugins/load/load_yeticache.py
@@ -0,0 +1,151 @@
+# -*- coding: utf-8 -*-
+"""Loader for Yeti Cache."""
+import os
+
+from openpype.pipeline import (
+    get_representation_path,
+    AYON_CONTAINER_ID
+)
+from openpype.hosts.unreal.api import plugin
+from openpype.hosts.unreal.api import pipeline as unreal_pipeline
+import unreal  # noqa
+
+
+class YetiLoader(plugin.Loader):
+    """Load Yeti Cache"""
+
+    families = ["ue_yeticache"]
+    label = "Import Yeti"
+    representations = ["abc"]
+    icon = "pagelines"
+    color = "orange"
+
+    @staticmethod
+    def get_task(filename, asset_dir, asset_name, replace):
+        task = unreal.AssetImportTask()
+        options = unreal.AbcImportSettings()
+
+        task.set_editor_property('filename', filename)
+        task.set_editor_property('destination_path', asset_dir)
+        task.set_editor_property('destination_name', asset_name)
+        task.set_editor_property('replace_existing', replace)
+        task.set_editor_property('automated', True)
+        task.set_editor_property('save', True)
+
+        task.options = options
+
+        return task
+
+    def load(self, context, name, namespace, options):
+        """Load and containerise representation into Content Browser.
+
+        This is two step process. First, import FBX to temporary path and
+        then call `containerise()` on it - this moves all content to new
+        directory and then it will create AssetContainer there and imprint it
+        with metadata. This will mark this path as container.
+
+        Args:
+            context (dict): application context
+            name (str): subset name
+            namespace (str): in Unreal this is basically path to container.
+                             This is not passed here, so namespace is set
+                             by `containerise()` because only then we know
+                             real path.
+            data (dict): Those would be data to be imprinted. This is not used
+                         now, data are imprinted by `containerise()`.
+
+        Returns:
+            list(str): list of container content
+
+        """
+        # Create directory for asset and Ayon container
+        root = "/Game/Ayon/Assets"
+        asset = context.get('asset').get('name')
+        suffix = "_CON"
+        asset_name = f"{asset}_{name}" if asset else f"{name}"
+        version = context.get('version')
+        # Check if version is hero version and use different name
+        if not version.get("name") and version.get('type') == "hero_version":
+            name_version = f"{name}_hero"
+        else:
+            name_version = f"{name}_v{version.get('name'):03d}"
+
+        tools = unreal.AssetToolsHelpers().get_asset_tools()
+        asset_dir, container_name = tools.create_unique_asset_name(
+            f"{root}/{asset}/{name_version}", suffix="")
+
+        container_name += suffix
+
+        if not unreal.EditorAssetLibrary.does_directory_exist(asset_dir):
+            unreal.EditorAssetLibrary.make_directory(asset_dir)
+
+            path = self.filepath_from_context(context)
+            task = self.get_task(path, asset_dir, asset_name, False)
+
+            unreal.AssetToolsHelpers.get_asset_tools().import_asset_tasks([task])  # noqa: E501
+
+            # Create Asset Container
+            unreal_pipeline.create_container(
+                container=container_name, path=asset_dir)
+
+        data = {
+            "schema": "ayon:container-2.0",
+            "id": AYON_CONTAINER_ID,
+            "asset": asset,
+            "namespace": asset_dir,
+            "container_name": container_name,
+            "asset_name": asset_name,
+            "loader": str(self.__class__.__name__),
+            "representation": context["representation"]["_id"],
+            "parent": context["representation"]["parent"],
+            "family": context["representation"]["context"]["family"]
+        }
+        unreal_pipeline.imprint(f"{asset_dir}/{container_name}", data)
+
+        asset_content = unreal.EditorAssetLibrary.list_assets(
+            asset_dir, recursive=True, include_folder=True
+        )
+
+        for a in asset_content:
+            unreal.EditorAssetLibrary.save_asset(a)
+
+        return asset_content
+
+    def update(self, container, representation):
+        name = container["asset_name"]
+        source_path = get_representation_path(representation)
+        destination_path = container["namespace"]
+
+        task = self.get_task(source_path, destination_path, name, True)
+
+        # do import fbx and replace existing data
+        unreal.AssetToolsHelpers.get_asset_tools().import_asset_tasks([task])
+
+        container_path = f'{container["namespace"]}/{container["objectName"]}'
+        # update metadata
+        unreal_pipeline.imprint(
+            container_path,
+            {
+                "representation": str(representation["_id"]),
+                "parent": str(representation["parent"])
+            })
+
+        asset_content = unreal.EditorAssetLibrary.list_assets(
+            destination_path, recursive=True, include_folder=True
+        )
+
+        for a in asset_content:
+            unreal.EditorAssetLibrary.save_asset(a)
+
+    def remove(self, container):
+        path = container["namespace"]
+        parent_path = os.path.dirname(path)
+
+        unreal.EditorAssetLibrary.delete_directory(path)
+
+        asset_content = unreal.EditorAssetLibrary.list_assets(
+            parent_path, recursive=False
+        )
+
+        if len(asset_content) == 0:
+            unreal.EditorAssetLibrary.delete_directory(parent_path)

From 41b207d657f8c4da054248791a946f0c86657000 Mon Sep 17 00:00:00 2001
From: Simone Barbieri <simone.barbieri@hey.com>
Date: Fri, 22 Sep 2023 15:58:27 +0100
Subject: [PATCH 303/366] Hound fixes

---
 openpype/hosts/maya/plugins/publish/extract_unreal_yeticache.py | 1 -
 1 file changed, 1 deletion(-)

diff --git a/openpype/hosts/maya/plugins/publish/extract_unreal_yeticache.py b/openpype/hosts/maya/plugins/publish/extract_unreal_yeticache.py
index 2279d52111..816e125c33 100644
--- a/openpype/hosts/maya/plugins/publish/extract_unreal_yeticache.py
+++ b/openpype/hosts/maya/plugins/publish/extract_unreal_yeticache.py
@@ -1,5 +1,4 @@
 import os
-import json
 
 from maya import cmds
 

From e27930c42064f9a6903bcedc0998c8e8b6e2eacb Mon Sep 17 00:00:00 2001
From: Ynbot <bot@ynput.io>
Date: Sat, 23 Sep 2023 03:24:16 +0000
Subject: [PATCH 304/366] [Automated] Bump version

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

diff --git a/openpype/version.py b/openpype/version.py
index 483b70436a..d1ebde3d04 100644
--- a/openpype/version.py
+++ b/openpype/version.py
@@ -1,3 +1,3 @@
 # -*- coding: utf-8 -*-
 """Package declaring Pype version."""
-__version__ = "3.17.1-nightly.1"
+__version__ = "3.17.1-nightly.2"

From 60d75300114f9ebba17f3882a81627080ef92ac8 Mon Sep 17 00:00:00 2001
From: "github-actions[bot]" <github-actions[bot]@users.noreply.github.com>
Date: Sat, 23 Sep 2023 03:24:52 +0000
Subject: [PATCH 305/366] chore(): update bug report / version

---
 .github/ISSUE_TEMPLATE/bug_report.yml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/ISSUE_TEMPLATE/bug_report.yml b/.github/ISSUE_TEMPLATE/bug_report.yml
index 0762eb2f20..87d904fc84 100644
--- a/.github/ISSUE_TEMPLATE/bug_report.yml
+++ b/.github/ISSUE_TEMPLATE/bug_report.yml
@@ -35,6 +35,8 @@ body:
       label: Version
       description: What version are you running? Look to OpenPype Tray
       options:
+        - 3.17.1-nightly.2
+        - 3.17.1-nightly.1
         - 3.17.0
         - 3.16.7
         - 3.16.7-nightly.2
@@ -133,8 +135,6 @@ body:
         - 3.14.10-nightly.5
         - 3.14.10-nightly.4
         - 3.14.10-nightly.3
-        - 3.14.10-nightly.2
-        - 3.14.10-nightly.1
     validations:
       required: true
   - type: dropdown

From 21d547a085c1b06fc9f26829920b24dd0068d01b Mon Sep 17 00:00:00 2001
From: Kayla Man <moonyuet2008@hotmail.com>
Date: Sun, 24 Sep 2023 12:49:30 +0800
Subject: [PATCH 306/366] introduce the function for checking the filename to
 see if it consists of the frame hashes element

---
 openpype/hosts/nuke/api/lib.py    | 18 ++++++++++++++++++
 openpype/hosts/nuke/api/plugin.py |  9 +++++----
 2 files changed, 23 insertions(+), 4 deletions(-)

diff --git a/openpype/hosts/nuke/api/lib.py b/openpype/hosts/nuke/api/lib.py
index 41e6a27cef..ed517b472c 100644
--- a/openpype/hosts/nuke/api/lib.py
+++ b/openpype/hosts/nuke/api/lib.py
@@ -3397,3 +3397,21 @@ def create_viewer_profile_string(viewer, display=None, path_like=False):
     if path_like:
         return "{}/{}".format(display, viewer)
     return "{} ({})".format(viewer, display)
+
+def get_file_with_name_and_hashes(original_path, name):
+    """Function to get the ranmed filename with frame hashes
+
+    Args:
+        original_path (str): the filename with frame hashes
+        name (str): the name of the tags
+
+    Returns:
+        filename: the renamed filename with the tag
+    """
+    filename = os.path.basename(original_path)
+    fhead = filename.split(".")[0]
+    if "#" in fhead:
+        fhead = fhead.replace("#", "")[:-1]
+    new_fhead = "{}.{}".format(fhead, name)
+    filename = filename.replace(fhead, new_fhead)
+    return filename
diff --git a/openpype/hosts/nuke/api/plugin.py b/openpype/hosts/nuke/api/plugin.py
index fe7b52cd8a..b7927738d6 100644
--- a/openpype/hosts/nuke/api/plugin.py
+++ b/openpype/hosts/nuke/api/plugin.py
@@ -38,7 +38,8 @@ from .lib import (
     get_node_data,
     get_view_process_node,
     get_viewer_config_from_string,
-    deprecated
+    deprecated,
+    get_file_with_name_and_hashes
 )
 from .pipeline import (
     list_instances,
@@ -805,11 +806,12 @@ class ExporterReviewMov(ExporterReview):
 
         self.file = self.fhead + self.name + ".{}".format(self.ext)
         if ".{}".format(self.ext) not in VIDEO_EXTENSIONS:
-            filename = os.path.basename(self.path_in)
+            filename = get_file_with_name_and_hashes(
+                self.path_in, self.name)
             self.file = filename
             if ".{}".format(self.ext) not in self.file:
                 original_ext = filename.split(".")[-1]
-                self.file = filename.replace(original_ext, self.ext)
+                self.file = filename.replace(original_ext, ext)
 
         self.path = os.path.join(
             self.staging_dir, self.file).replace("\\", "/")
@@ -931,7 +933,6 @@ class ExporterReviewMov(ExporterReview):
         self.log.debug("Path: {}".format(self.path))
         write_node["file"].setValue(str(self.path))
         write_node["file_type"].setValue(str(self.ext))
-        self.log.debug("{0}".format(self.ext))
         # Knobs `meta_codec` and `mov64_codec` are not available on centos.
         # TODO shouldn't this come from settings on outputs?
         try:

From 6f858a80ca4839bb581685d48d4d5d6304ac5403 Mon Sep 17 00:00:00 2001
From: Kayla Man <moonyuet2008@hotmail.com>
Date: Sun, 24 Sep 2023 12:50:42 +0800
Subject: [PATCH 307/366] hound

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

diff --git a/openpype/hosts/nuke/api/lib.py b/openpype/hosts/nuke/api/lib.py
index ed517b472c..2c5838ffd3 100644
--- a/openpype/hosts/nuke/api/lib.py
+++ b/openpype/hosts/nuke/api/lib.py
@@ -3398,6 +3398,7 @@ def create_viewer_profile_string(viewer, display=None, path_like=False):
         return "{}/{}".format(display, viewer)
     return "{} ({})".format(viewer, display)
 
+
 def get_file_with_name_and_hashes(original_path, name):
     """Function to get the ranmed filename with frame hashes
 

From 5f7f4f08d1cf1ac38c4016e3c4d4bb2211b73767 Mon Sep 17 00:00:00 2001
From: Kayla Man <moonyuet2008@hotmail.com>
Date: Mon, 25 Sep 2023 14:23:17 +0800
Subject: [PATCH 308/366] fix the slate in

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

diff --git a/openpype/hosts/nuke/api/plugin.py b/openpype/hosts/nuke/api/plugin.py
index b7927738d6..f587d109c1 100644
--- a/openpype/hosts/nuke/api/plugin.py
+++ b/openpype/hosts/nuke/api/plugin.py
@@ -591,6 +591,11 @@ class ExporterReview(object):
             # get first and last frame
             self.first_frame = min(self.collection.indexes)
             self.last_frame = max(self.collection.indexes)
+
+            first = self.instance.data.get("frameStartHandle", None)
+            if first:
+                if first > self.first_frame:
+                    self.first_frame = first
         else:
             self.fname = os.path.basename(self.path_in)
             self.fhead = os.path.splitext(self.fname)[0] + "."

From 4c854600cbbc3a7d4d1475893ab3f900d2c92605 Mon Sep 17 00:00:00 2001
From: Simone Barbieri <simone.barbieri@hey.com>
Date: Mon, 25 Sep 2023 10:07:37 +0100
Subject: [PATCH 309/366] Renamed family to yeticacheUE

---
 openpype/hosts/maya/plugins/create/create_unreal_yeticache.py   | 2 +-
 openpype/hosts/maya/plugins/publish/collect_yeti_cache.py       | 2 +-
 openpype/hosts/maya/plugins/publish/extract_unreal_yeticache.py | 2 +-
 openpype/hosts/unreal/plugins/load/load_yeticache.py            | 2 +-
 openpype/plugins/publish/collect_resources_path.py              | 2 +-
 openpype/plugins/publish/integrate.py                           | 2 +-
 6 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/openpype/hosts/maya/plugins/create/create_unreal_yeticache.py b/openpype/hosts/maya/plugins/create/create_unreal_yeticache.py
index 8ff3dccea2..defa6ed6d9 100644
--- a/openpype/hosts/maya/plugins/create/create_unreal_yeticache.py
+++ b/openpype/hosts/maya/plugins/create/create_unreal_yeticache.py
@@ -10,7 +10,7 @@ class CreateYetiCache(plugin.MayaCreator):
 
     identifier = "io.openpype.creators.maya.unrealyeticache"
     label = "Unreal Yeti Cache"
-    family = "ue_yeticache"
+    family = "yeticacheUE"
     icon = "pagelines"
 
     def get_instance_attr_defs(self):
diff --git a/openpype/hosts/maya/plugins/publish/collect_yeti_cache.py b/openpype/hosts/maya/plugins/publish/collect_yeti_cache.py
index 426e330f89..7a1516997a 100644
--- a/openpype/hosts/maya/plugins/publish/collect_yeti_cache.py
+++ b/openpype/hosts/maya/plugins/publish/collect_yeti_cache.py
@@ -39,7 +39,7 @@ class CollectYetiCache(pyblish.api.InstancePlugin):
 
     order = pyblish.api.CollectorOrder + 0.45
     label = "Collect Yeti Cache"
-    families = ["yetiRig", "yeticache", "ue_yeticache"]
+    families = ["yetiRig", "yeticache", "yeticacheUE"]
     hosts = ["maya"]
 
     def process(self, instance):
diff --git a/openpype/hosts/maya/plugins/publish/extract_unreal_yeticache.py b/openpype/hosts/maya/plugins/publish/extract_unreal_yeticache.py
index 816e125c33..e72146a871 100644
--- a/openpype/hosts/maya/plugins/publish/extract_unreal_yeticache.py
+++ b/openpype/hosts/maya/plugins/publish/extract_unreal_yeticache.py
@@ -13,7 +13,7 @@ class ExtractYetiCache(publish.Extractor):
 
     label = "Extract Yeti Cache"
     hosts = ["maya"]
-    families = ["ue_yeticache"]
+    families = ["yeticacheUE"]
 
     def process(self, instance):
 
diff --git a/openpype/hosts/unreal/plugins/load/load_yeticache.py b/openpype/hosts/unreal/plugins/load/load_yeticache.py
index 59dbdbee31..328f92d020 100644
--- a/openpype/hosts/unreal/plugins/load/load_yeticache.py
+++ b/openpype/hosts/unreal/plugins/load/load_yeticache.py
@@ -14,7 +14,7 @@ import unreal  # noqa
 class YetiLoader(plugin.Loader):
     """Load Yeti Cache"""
 
-    families = ["ue_yeticache"]
+    families = ["yeticacheUE"]
     label = "Import Yeti"
     representations = ["abc"]
     icon = "pagelines"
diff --git a/openpype/plugins/publish/collect_resources_path.py b/openpype/plugins/publish/collect_resources_path.py
index 6840509f79..57a612c5ae 100644
--- a/openpype/plugins/publish/collect_resources_path.py
+++ b/openpype/plugins/publish/collect_resources_path.py
@@ -63,7 +63,7 @@ class CollectResourcesPath(pyblish.api.InstancePlugin):
                 "staticMesh",
                 "skeletalMesh",
                 "xgen",
-                "ue_yeticache"
+                "yeticacheUE"
                 ]
 
     def process(self, instance):
diff --git a/openpype/plugins/publish/integrate.py b/openpype/plugins/publish/integrate.py
index 24fbc0d8e7..ce24dad1b5 100644
--- a/openpype/plugins/publish/integrate.py
+++ b/openpype/plugins/publish/integrate.py
@@ -140,7 +140,7 @@ class IntegrateAsset(pyblish.api.InstancePlugin):
                 "online",
                 "uasset",
                 "blendScene",
-                "ue_yeticache"
+                "yeticacheUE"
                 ]
 
     default_template_name = "publish"

From 51875f592e95a30f84563835fa63d7b4c31e3dc9 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Mon, 25 Sep 2023 11:21:02 +0200
Subject: [PATCH 310/366] instance data keys should not be optional

---
 openpype/hosts/nuke/api/plugin.py | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/openpype/hosts/nuke/api/plugin.py b/openpype/hosts/nuke/api/plugin.py
index 1e318e17cf..4ce314f6fb 100644
--- a/openpype/hosts/nuke/api/plugin.py
+++ b/openpype/hosts/nuke/api/plugin.py
@@ -580,8 +580,9 @@ class ExporterReview(object):
     def get_file_info(self):
         if self.collection:
             # get path
-            self.fname = os.path.basename(self.collection.format(
-                "{head}{padding}{tail}"))
+            self.fname = os.path.basename(
+                self.collection.format("{head}{padding}{tail}")
+            )
             self.fhead = self.collection.format("{head}")
 
             # get first and last frame
@@ -590,8 +591,8 @@ class ExporterReview(object):
         else:
             self.fname = os.path.basename(self.path_in)
             self.fhead = os.path.splitext(self.fname)[0] + "."
-            self.first_frame = self.instance.data.get("frameStartHandle", None)
-            self.last_frame = self.instance.data.get("frameEndHandle", None)
+            self.first_frame = self.instance.data["frameStartHandle"]
+            self.last_frame = self.instance.data["frameEndHandle"]
 
         if "#" in self.fhead:
             self.fhead = self.fhead.replace("#", "")[:-1]

From 4289997553340bccb7bb682d6c14ac4b51ca6939 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Mon, 25 Sep 2023 11:21:28 +0200
Subject: [PATCH 311/366] slate frame exception - in case it already exists

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

diff --git a/openpype/hosts/nuke/api/plugin.py b/openpype/hosts/nuke/api/plugin.py
index 4ce314f6fb..6d5d7eddf1 100644
--- a/openpype/hosts/nuke/api/plugin.py
+++ b/openpype/hosts/nuke/api/plugin.py
@@ -588,6 +588,12 @@ class ExporterReview(object):
             # get first and last frame
             self.first_frame = min(self.collection.indexes)
             self.last_frame = max(self.collection.indexes)
+
+            # make sure slate frame is not included
+            frame_start_handle = self.instance.data["frameStartHandle"]
+            if frame_start_handle > self.first_frame:
+                self.first_frame = frame_start_handle
+
         else:
             self.fname = os.path.basename(self.path_in)
             self.fhead = os.path.splitext(self.fname)[0] + "."

From 50bae2d049092f7f43e9ef619f1b65ee0c14db25 Mon Sep 17 00:00:00 2001
From: Simone Barbieri <simone.barbieri@hey.com>
Date: Mon, 25 Sep 2023 10:34:53 +0100
Subject: [PATCH 312/366] Check if Groom plugin is active when loading in
 Unreal

---
 .../unreal/plugins/load/load_yeticache.py     | 27 +++++++++++++++++++
 1 file changed, 27 insertions(+)

diff --git a/openpype/hosts/unreal/plugins/load/load_yeticache.py b/openpype/hosts/unreal/plugins/load/load_yeticache.py
index 328f92d020..92f080d7c5 100644
--- a/openpype/hosts/unreal/plugins/load/load_yeticache.py
+++ b/openpype/hosts/unreal/plugins/load/load_yeticache.py
@@ -1,6 +1,7 @@
 # -*- coding: utf-8 -*-
 """Loader for Yeti Cache."""
 import os
+import json
 
 from openpype.pipeline import (
     get_representation_path,
@@ -36,6 +37,28 @@ class YetiLoader(plugin.Loader):
 
         return task
 
+    @staticmethod
+    def is_groom_module_active():
+        """
+        Check if Groom plugin is active.
+
+        This is a workaround, because the Unreal python API don't have
+        any method to check if plugin is active.
+        """
+        prj_file = unreal.Paths.get_project_file_path()
+
+        with open(prj_file, "r") as fp:
+            data = json.load(fp)
+
+        plugins = data.get("Plugins")
+
+        if not plugins:
+            return False
+
+        plugin_names = [p.get("Name") for p in plugins]
+
+        return "HairStrands" in plugin_names
+
     def load(self, context, name, namespace, options):
         """Load and containerise representation into Content Browser.
 
@@ -58,6 +81,10 @@ class YetiLoader(plugin.Loader):
             list(str): list of container content
 
         """
+        # Check if Groom plugin is active
+        if not self.is_groom_module_active():
+            raise RuntimeError("Groom plugin is not activated.")
+
         # Create directory for asset and Ayon container
         root = "/Game/Ayon/Assets"
         asset = context.get('asset').get('name')

From 5cf8fdbb6ca60327634ed5b8110a395410d5be51 Mon Sep 17 00:00:00 2001
From: Simone Barbieri <simone.barbieri@hey.com>
Date: Mon, 25 Sep 2023 10:45:28 +0100
Subject: [PATCH 313/366] Do not use version in the import folder

---
 .../plugins/create/create_unreal_yeticache.py  |  2 +-
 .../unreal/plugins/load/load_yeticache.py      | 18 ++++++++++--------
 2 files changed, 11 insertions(+), 9 deletions(-)

diff --git a/openpype/hosts/maya/plugins/create/create_unreal_yeticache.py b/openpype/hosts/maya/plugins/create/create_unreal_yeticache.py
index defa6ed6d9..c9f9cd9ba8 100644
--- a/openpype/hosts/maya/plugins/create/create_unreal_yeticache.py
+++ b/openpype/hosts/maya/plugins/create/create_unreal_yeticache.py
@@ -9,7 +9,7 @@ class CreateYetiCache(plugin.MayaCreator):
     """Output for procedural plugin nodes of Yeti """
 
     identifier = "io.openpype.creators.maya.unrealyeticache"
-    label = "Unreal Yeti Cache"
+    label = "Unreal - Yeti Cache"
     family = "yeticacheUE"
     icon = "pagelines"
 
diff --git a/openpype/hosts/unreal/plugins/load/load_yeticache.py b/openpype/hosts/unreal/plugins/load/load_yeticache.py
index 92f080d7c5..bb6c2d78cc 100644
--- a/openpype/hosts/unreal/plugins/load/load_yeticache.py
+++ b/openpype/hosts/unreal/plugins/load/load_yeticache.py
@@ -90,18 +90,20 @@ class YetiLoader(plugin.Loader):
         asset = context.get('asset').get('name')
         suffix = "_CON"
         asset_name = f"{asset}_{name}" if asset else f"{name}"
-        version = context.get('version')
-        # Check if version is hero version and use different name
-        if not version.get("name") and version.get('type') == "hero_version":
-            name_version = f"{name}_hero"
-        else:
-            name_version = f"{name}_v{version.get('name'):03d}"
 
         tools = unreal.AssetToolsHelpers().get_asset_tools()
         asset_dir, container_name = tools.create_unique_asset_name(
-            f"{root}/{asset}/{name_version}", suffix="")
+            f"{root}/{asset}/{name}", suffix="")
+
+        unique_number = 1
+        while unreal.EditorAssetLibrary.does_directory_exist(
+            f"{asset_dir}_{unique_number:02}"
+        ):
+            unique_number += 1
+
+        asset_dir = f"{asset_dir}_{unique_number:02}"
+        container_name = f"{container_name}_{unique_number:02}{suffix}"
 
-        container_name += suffix
 
         if not unreal.EditorAssetLibrary.does_directory_exist(asset_dir):
             unreal.EditorAssetLibrary.make_directory(asset_dir)

From 24e6b756ec44976667500129df08cb3b7fae495b Mon Sep 17 00:00:00 2001
From: Simone Barbieri <simone.barbieri@hey.com>
Date: Mon, 25 Sep 2023 10:46:33 +0100
Subject: [PATCH 314/366] Hound fix

---
 openpype/hosts/unreal/plugins/load/load_yeticache.py | 1 -
 1 file changed, 1 deletion(-)

diff --git a/openpype/hosts/unreal/plugins/load/load_yeticache.py b/openpype/hosts/unreal/plugins/load/load_yeticache.py
index bb6c2d78cc..22f5029bac 100644
--- a/openpype/hosts/unreal/plugins/load/load_yeticache.py
+++ b/openpype/hosts/unreal/plugins/load/load_yeticache.py
@@ -104,7 +104,6 @@ class YetiLoader(plugin.Loader):
         asset_dir = f"{asset_dir}_{unique_number:02}"
         container_name = f"{container_name}_{unique_number:02}{suffix}"
 
-
         if not unreal.EditorAssetLibrary.does_directory_exist(asset_dir):
             unreal.EditorAssetLibrary.make_directory(asset_dir)
 

From 41e81ef7a87faced226f2bcc6b904e58de5f78e0 Mon Sep 17 00:00:00 2001
From: Kayla Man <moonyuet2008@hotmail.com>
Date: Mon, 25 Sep 2023 18:03:22 +0800
Subject: [PATCH 315/366] rename the function and the elaborate the docstring

---
 openpype/hosts/nuke/api/lib.py    | 6 ++++--
 openpype/hosts/nuke/api/plugin.py | 4 ++--
 2 files changed, 6 insertions(+), 4 deletions(-)

diff --git a/openpype/hosts/nuke/api/lib.py b/openpype/hosts/nuke/api/lib.py
index 2c5838ffd3..d95839bb8d 100644
--- a/openpype/hosts/nuke/api/lib.py
+++ b/openpype/hosts/nuke/api/lib.py
@@ -3399,8 +3399,10 @@ def create_viewer_profile_string(viewer, display=None, path_like=False):
     return "{} ({})".format(viewer, display)
 
 
-def get_file_with_name_and_hashes(original_path, name):
-    """Function to get the ranmed filename with frame hashes
+def get_head_filename_without_hashes(original_path, name):
+    """Function to get the ranmed head filename without frame hashes
+    To avoid the system being confused on finding the filename with
+    frame hashes if the head of the filename has the hashed symbol
 
     Args:
         original_path (str): the filename with frame hashes
diff --git a/openpype/hosts/nuke/api/plugin.py b/openpype/hosts/nuke/api/plugin.py
index 97e7c3ad8c..1550a60f32 100644
--- a/openpype/hosts/nuke/api/plugin.py
+++ b/openpype/hosts/nuke/api/plugin.py
@@ -39,7 +39,7 @@ from .lib import (
     get_view_process_node,
     get_viewer_config_from_string,
     deprecated,
-    get_file_with_name_and_hashes
+    get_head_filename_without_hashes
 )
 from .pipeline import (
     list_instances,
@@ -813,7 +813,7 @@ class ExporterReviewMov(ExporterReview):
 
         self.file = self.fhead + self.name + ".{}".format(self.ext)
         if ".{}".format(self.ext) not in VIDEO_EXTENSIONS:
-            filename = get_file_with_name_and_hashes(
+            filename = get_head_filename_without_hashes(
                 self.path_in, self.name)
             self.file = filename
             if ".{}".format(self.ext) not in self.file:

From 22ce181f2de6b1ed001a135442c1884a71882599 Mon Sep 17 00:00:00 2001
From: Kayla Man <moonyuet2008@hotmail.com>
Date: Mon, 25 Sep 2023 18:24:48 +0800
Subject: [PATCH 316/366] make sure the deprecated setting used when it enabled
 while the current setting is used when the deprecrated setting diabled

---
 openpype/settings/ayon_settings.py | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/openpype/settings/ayon_settings.py b/openpype/settings/ayon_settings.py
index a66e1b6ec6..b43e0b7c5f 100644
--- a/openpype/settings/ayon_settings.py
+++ b/openpype/settings/ayon_settings.py
@@ -754,10 +754,9 @@ def _convert_nuke_project_settings(ayon_settings, output):
     current_review_settings = (
         ayon_publish["ExtractReviewDataBakingStreams"]
     )
-    if deprecrated_review_settings["outputs"] == (
-        current_review_settings["outputs"]
-    ):
-        outputs_settings = current_review_settings["outputs"]
+    if not deprecrated_review_settings["enabled"]:
+        if current_review_settings["enabled"]:
+            outputs_settings = current_review_settings["outputs"]
     else:
         outputs_settings = deprecrated_review_settings["outputs"]
 

From 3da4bac77db45edff25df7e4958a301ff5775cbc Mon Sep 17 00:00:00 2001
From: Kayla Man <moonyuet2008@hotmail.com>
Date: Mon, 25 Sep 2023 18:26:16 +0800
Subject: [PATCH 317/366] typo in lib

---
 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 d95839bb8d..3617133d2b 100644
--- a/openpype/hosts/nuke/api/lib.py
+++ b/openpype/hosts/nuke/api/lib.py
@@ -3400,7 +3400,7 @@ def create_viewer_profile_string(viewer, display=None, path_like=False):
 
 
 def get_head_filename_without_hashes(original_path, name):
-    """Function to get the ranmed head filename without frame hashes
+    """Function to get the renamed head filename without frame hashes
     To avoid the system being confused on finding the filename with
     frame hashes if the head of the filename has the hashed symbol
 

From e0ce8013f46a1cf1c46774f43697930c09a7fd6a Mon Sep 17 00:00:00 2001
From: Simone Barbieri <simone.barbieri@hey.com>
Date: Mon, 25 Sep 2023 11:32:44 +0100
Subject: [PATCH 318/366] Use f-string

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

diff --git a/openpype/hosts/maya/plugins/publish/extract_unreal_yeticache.py b/openpype/hosts/maya/plugins/publish/extract_unreal_yeticache.py
index e72146a871..963285093e 100644
--- a/openpype/hosts/maya/plugins/publish/extract_unreal_yeticache.py
+++ b/openpype/hosts/maya/plugins/publish/extract_unreal_yeticache.py
@@ -39,7 +39,7 @@ class ExtractYetiCache(publish.Extractor):
             kwargs.update({"samples": samples})
 
         self.log.debug(f"Writing out cache {start_frame} - {end_frame}")
-        filename = "{0}.abc".format(instance.name)
+        filename = f"{instance.name}.abc"
         path = os.path.join(dirname, filename)
         cmds.pgYetiCommand(yeti_nodes,
                            writeAlembic=path,

From 0e594b39cdf836b8ce41637efba825a3863deae4 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Mon, 25 Sep 2023 12:52:51 +0200
Subject: [PATCH 319/366] no need to check `config_data` exits in this section
 of code.

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

diff --git a/openpype/pipeline/colorspace.py b/openpype/pipeline/colorspace.py
index 44cff34c67..a77dc5763a 100644
--- a/openpype/pipeline/colorspace.py
+++ b/openpype/pipeline/colorspace.py
@@ -177,7 +177,7 @@ def get_colorspace_name_from_filepath(
         return None
 
     # validate matching colorspace with config
-    if validate and config_data:
+    if validate:
         validate_imageio_colorspace_in_config(
             config_data["path"], colorspace_name)
 

From 5d1f2b0d9ed3ff44f1f924870e9a829c9ee4ee12 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Mon, 25 Sep 2023 13:01:43 +0200
Subject: [PATCH 320/366] typo

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

diff --git a/openpype/pipeline/colorspace.py b/openpype/pipeline/colorspace.py
index a77dc5763a..a67457b1bf 100644
--- a/openpype/pipeline/colorspace.py
+++ b/openpype/pipeline/colorspace.py
@@ -328,7 +328,7 @@ def parse_colorspace_from_filepath(
         str: name of colorspace
     """
     def _get_colorspace_match_regex(colorspaces):
-        """Return a regex patter
+        """Return a regex pattern
 
         Allows to search a colorspace match in a filename
 

From 8b76238b2d8199e2af541365e6ef074ef1c95825 Mon Sep 17 00:00:00 2001
From: Kayla Man <moonyuet2008@hotmail.com>
Date: Mon, 25 Sep 2023 19:25:44 +0800
Subject: [PATCH 321/366] fixing get_head_filename_without_hashes not being
 able to get multiple hashes & some strip fix

---
 openpype/hosts/nuke/api/lib.py    | 8 ++++++--
 openpype/hosts/nuke/api/plugin.py | 2 +-
 2 files changed, 7 insertions(+), 3 deletions(-)

diff --git a/openpype/hosts/nuke/api/lib.py b/openpype/hosts/nuke/api/lib.py
index 3617133d2b..29e7c88c71 100644
--- a/openpype/hosts/nuke/api/lib.py
+++ b/openpype/hosts/nuke/api/lib.py
@@ -3406,15 +3406,19 @@ def get_head_filename_without_hashes(original_path, name):
 
     Args:
         original_path (str): the filename with frame hashes
+        e.g. "renderAssetMain.####.exr"
         name (str): the name of the tags
+        e.g. "baking"
 
     Returns:
         filename: the renamed filename with the tag
+        e.g. "renderAssetMain.baking.####.exr"
     """
     filename = os.path.basename(original_path)
     fhead = filename.split(".")[0]
-    if "#" in fhead:
-        fhead = fhead.replace("#", "")[:-1]
+    tmp_fhead = re.sub("\d", "#", fhead)
+    if "#" in tmp_fhead:
+        fhead = tmp_fhead.replace("#", "").rstrip(".")
     new_fhead = "{}.{}".format(fhead, name)
     filename = filename.replace(fhead, new_fhead)
     return filename
diff --git a/openpype/hosts/nuke/api/plugin.py b/openpype/hosts/nuke/api/plugin.py
index 1550a60f32..ca31068943 100644
--- a/openpype/hosts/nuke/api/plugin.py
+++ b/openpype/hosts/nuke/api/plugin.py
@@ -817,7 +817,7 @@ class ExporterReviewMov(ExporterReview):
                 self.path_in, self.name)
             self.file = filename
             if ".{}".format(self.ext) not in self.file:
-                original_ext = filename.split(".")[-1]
+                original_ext = os.path.splitext(filename)[-1].strip(".")    # noqa
                 self.file = filename.replace(original_ext, ext)
 
         self.path = os.path.join(

From e2509a9447c5900f4c469a2c81e89c9a79a2524e Mon Sep 17 00:00:00 2001
From: Kayla Man <moonyuet2008@hotmail.com>
Date: Mon, 25 Sep 2023 19:29:35 +0800
Subject: [PATCH 322/366] hound

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

diff --git a/openpype/hosts/nuke/api/lib.py b/openpype/hosts/nuke/api/lib.py
index 29e7c88c71..7b1aaa8fe0 100644
--- a/openpype/hosts/nuke/api/lib.py
+++ b/openpype/hosts/nuke/api/lib.py
@@ -3415,8 +3415,8 @@ def get_head_filename_without_hashes(original_path, name):
         e.g. "renderAssetMain.baking.####.exr"
     """
     filename = os.path.basename(original_path)
-    fhead = filename.split(".")[0]
-    tmp_fhead = re.sub("\d", "#", fhead)
+    fhead = os.path.splitext(filename)[0].strip(".")
+    tmp_fhead = re.sub(r"\d", "#", fhead)
     if "#" in tmp_fhead:
         fhead = tmp_fhead.replace("#", "").rstrip(".")
     new_fhead = "{}.{}".format(fhead, name)

From c77faa4be4f0db9c2d6f8d083bae70c41f0fc776 Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Mon, 25 Sep 2023 13:42:22 +0200
Subject: [PATCH 323/366] Fix audio node source in - source out on updating
 audio version

---
 .../hosts/maya/plugins/load/load_audio.py     | 47 ++++++++-----------
 1 file changed, 20 insertions(+), 27 deletions(-)

diff --git a/openpype/hosts/maya/plugins/load/load_audio.py b/openpype/hosts/maya/plugins/load/load_audio.py
index ecf98303d2..a8a878d49d 100644
--- a/openpype/hosts/maya/plugins/load/load_audio.py
+++ b/openpype/hosts/maya/plugins/load/load_audio.py
@@ -1,12 +1,6 @@
 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 (
-    get_current_project_name,
     load,
     get_representation_path,
 )
@@ -67,7 +61,26 @@ class AudioLoader(load.LoaderPlugin):
         activate_sound = current_sound == audio_node
 
         path = get_representation_path(representation)
-        cmds.setAttr("{}.filename".format(audio_node), path, type="string")
+
+        cmds.sound(
+            audio_node,
+            edit=True,
+            file=path
+        )
+
+        # The source start + end does not automatically update itself to the
+        # length of thew new audio file, even though maya does do that when
+        # when creating a new audio node. So to update we compute it manually.
+        # This would however override any source start and source end a user
+        # might have done on the original audio node after load.
+        audio_frame_count = cmds.getAttr("{}.frameCount".format(audio_node))
+        audio_sample_rate = cmds.getAttr("{}.sampleRate".format(audio_node))
+        duration_in_seconds = audio_frame_count / audio_sample_rate
+        fps = mel.eval('currentTimeUnitToFPS()')  # workfile FPS
+        source_start = 0
+        source_end = (duration_in_seconds * fps)
+        cmds.setAttr("{}.sourceStart".format(audio_node), source_start)
+        cmds.setAttr("{}.sourceEnd".format(audio_node), source_end)
 
         if activate_sound:
             # maya by default deactivates it from timeline on file change
@@ -84,26 +97,6 @@ class AudioLoader(load.LoaderPlugin):
             type="string"
         )
 
-        # Set frame range.
-        project_name = get_current_project_name()
-        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", "data.frameStart", "data.frameEnd"]
-        )
-
-        source_start = 1 - asset["data"]["frameStart"]
-        source_end = asset["data"]["frameEnd"]
-
-        cmds.setAttr("{}.sourceStart".format(audio_node), source_start)
-        cmds.setAttr("{}.sourceEnd".format(audio_node), source_end)
-
     def switch(self, container, representation):
         self.update(container, representation)
 

From 905038f6e86ef5c8116f852cab7547d7ea8d6ac8 Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Mon, 25 Sep 2023 13:42:39 +0200
Subject: [PATCH 324/366] Fix typo

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

diff --git a/openpype/hosts/maya/plugins/load/load_audio.py b/openpype/hosts/maya/plugins/load/load_audio.py
index a8a878d49d..90cadb31b1 100644
--- a/openpype/hosts/maya/plugins/load/load_audio.py
+++ b/openpype/hosts/maya/plugins/load/load_audio.py
@@ -70,7 +70,7 @@ class AudioLoader(load.LoaderPlugin):
 
         # The source start + end does not automatically update itself to the
         # length of thew new audio file, even though maya does do that when
-        # when creating a new audio node. So to update we compute it manually.
+        # creating a new audio node. So to update we compute it manually.
         # This would however override any source start and source end a user
         # might have done on the original audio node after load.
         audio_frame_count = cmds.getAttr("{}.frameCount".format(audio_node))

From b0ae4257f95f56a4d5510a48516945e5bfb4edbb Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Mon, 25 Sep 2023 15:23:02 +0200
Subject: [PATCH 325/366] missing `allowed_exts` issue and unit tests fix

---
 openpype/pipeline/colorspace.py | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/openpype/pipeline/colorspace.py b/openpype/pipeline/colorspace.py
index a67457b1bf..2800050496 100644
--- a/openpype/pipeline/colorspace.py
+++ b/openpype/pipeline/colorspace.py
@@ -27,6 +27,9 @@ class CachedData:
     has_compatible_ocio_package = None
     config_version_data = {}
     ocio_config_colorspaces = {}
+    allowed_exts = {
+        ext.lstrip(".") for ext in IMAGE_EXTENSIONS.union(VIDEO_EXTENSIONS)
+    }
 
 
 class DeprecatedWarning(DeprecationWarning):
@@ -361,7 +364,7 @@ def parse_colorspace_from_filepath(
 
     # match colorspace from  filepath
     regex_pattern = _get_colorspace_match_regex(
-        colorspaces + underscored_colorspaces.keys())
+        list(colorspaces) + list(underscored_colorspaces))
     match = regex_pattern.search(filepath)
     colorspace = match.group(0) if match else None
 

From 92bc7c12f9241eb4a3c40c7c543ac84c30e78a92 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Mon, 25 Sep 2023 17:23:34 +0200
Subject: [PATCH 326/366] fixing missing assetEntity

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

diff --git a/openpype/plugins/publish/collect_sequence_frame_data.py b/openpype/plugins/publish/collect_sequence_frame_data.py
index 6c2bfbf358..5fecc65446 100644
--- a/openpype/plugins/publish/collect_sequence_frame_data.py
+++ b/openpype/plugins/publish/collect_sequence_frame_data.py
@@ -28,6 +28,10 @@ class CollectSequenceFrameData(pyblish.api.InstancePlugin):
 
     def get_frame_data_from_repre_sequence(self, instance):
         repres = instance.data.get("representations")
+        parent_entity = (
+            instance.context.data.get("assetEntity")
+            or instance.context.data["projectEntity"]
+        )
         if repres:
             first_repre = repres[0]
             if "ext" not in first_repre:
@@ -52,5 +56,5 @@ class CollectSequenceFrameData(pyblish.api.InstancePlugin):
                 "frameEnd": repres_frames[-1],
                 "handleStart": 0,
                 "handleEnd": 0,
-                "fps": instance.context.data["assetEntity"]["data"]["fps"]
+                "fps": parent_entity["data"]["fps"]
             }

From a73ba98209aa18fe6174a135e986962aac3d2ab0 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Mon, 25 Sep 2023 17:29:14 +0200
Subject: [PATCH 327/366] assetEntity is not on context data

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

diff --git a/openpype/plugins/publish/collect_sequence_frame_data.py b/openpype/plugins/publish/collect_sequence_frame_data.py
index 5fecc65446..1c456563e6 100644
--- a/openpype/plugins/publish/collect_sequence_frame_data.py
+++ b/openpype/plugins/publish/collect_sequence_frame_data.py
@@ -29,7 +29,7 @@ class CollectSequenceFrameData(pyblish.api.InstancePlugin):
     def get_frame_data_from_repre_sequence(self, instance):
         repres = instance.data.get("representations")
         parent_entity = (
-            instance.context.data.get("assetEntity")
+            instance.data.get("assetEntity")
             or instance.context.data["projectEntity"]
         )
         if repres:

From 1bd07bd15b1bf238e186b23b7d112e9fe4637737 Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Mon, 25 Sep 2023 18:01:24 +0200
Subject: [PATCH 328/366] OP-6874 - remove trailing underscore in subset name
 (#5647)

If {layer} placeholder is at the end of subset name template and not used (for example in auto_image where separating it by layer doesn't make any sense) trailing '_' was kept.
This updates cleaning logic and extracts it as it might be similar in regular `image` instance.
---
 openpype/hosts/photoshop/lib.py               | 17 +++++++++++++
 .../plugins/create/create_flatten_image.py    | 14 ++---------
 .../photoshop/plugins/create/create_image.py  |  3 ++-
 .../unit/openpype/hosts/photoshop/test_lib.py | 25 +++++++++++++++++++
 4 files changed, 46 insertions(+), 13 deletions(-)
 create mode 100644 tests/unit/openpype/hosts/photoshop/test_lib.py

diff --git a/openpype/hosts/photoshop/lib.py b/openpype/hosts/photoshop/lib.py
index ae7a33b7b6..9f603a70d2 100644
--- a/openpype/hosts/photoshop/lib.py
+++ b/openpype/hosts/photoshop/lib.py
@@ -1,5 +1,8 @@
+import re
+
 import openpype.hosts.photoshop.api as api
 from openpype.client import get_asset_by_name
+from openpype.lib import prepare_template_data
 from openpype.pipeline import (
     AutoCreator,
     CreatedInstance
@@ -78,3 +81,17 @@ class PSAutoCreator(AutoCreator):
             existing_instance["asset"] = asset_name
             existing_instance["task"] = task_name
             existing_instance["subset"] = subset_name
+
+
+def clean_subset_name(subset_name):
+    """Clean all variants leftover {layer} from subset name."""
+    dynamic_data = prepare_template_data({"layer": "{layer}"})
+    for value in dynamic_data.values():
+        if value in subset_name:
+            subset_name = (subset_name.replace(value, "")
+                                      .replace("__", "_")
+                                      .replace("..", "."))
+    # clean trailing separator as Main_
+    pattern = r'[\W_]+$'
+    replacement = ''
+    return re.sub(pattern, replacement, subset_name)
diff --git a/openpype/hosts/photoshop/plugins/create/create_flatten_image.py b/openpype/hosts/photoshop/plugins/create/create_flatten_image.py
index e4229788bd..afde77fdb4 100644
--- a/openpype/hosts/photoshop/plugins/create/create_flatten_image.py
+++ b/openpype/hosts/photoshop/plugins/create/create_flatten_image.py
@@ -2,7 +2,7 @@ from openpype.pipeline import CreatedInstance
 
 from openpype.lib import BoolDef
 import openpype.hosts.photoshop.api as api
-from openpype.hosts.photoshop.lib import PSAutoCreator
+from openpype.hosts.photoshop.lib import PSAutoCreator, clean_subset_name
 from openpype.pipeline.create import get_subset_name
 from openpype.lib import prepare_template_data
 from openpype.client import get_asset_by_name
@@ -129,14 +129,4 @@ class AutoImageCreator(PSAutoCreator):
             self.family, variant, task_name, asset_doc,
             project_name, host_name, dynamic_data=dynamic_data
         )
-        return self._clean_subset_name(subset_name)
-
-    def _clean_subset_name(self, subset_name):
-        """Clean all variants leftover {layer} from subset name."""
-        dynamic_data = prepare_template_data({"layer": "{layer}"})
-        for value in dynamic_data.values():
-            if value in subset_name:
-                return (subset_name.replace(value, "")
-                        .replace("__", "_")
-                        .replace("..", "."))
-        return subset_name
+        return clean_subset_name(subset_name)
diff --git a/openpype/hosts/photoshop/plugins/create/create_image.py b/openpype/hosts/photoshop/plugins/create/create_image.py
index af20d456e0..4f2e90886a 100644
--- a/openpype/hosts/photoshop/plugins/create/create_image.py
+++ b/openpype/hosts/photoshop/plugins/create/create_image.py
@@ -10,6 +10,7 @@ from openpype.pipeline import (
 from openpype.lib import prepare_template_data
 from openpype.pipeline.create import SUBSET_NAME_ALLOWED_SYMBOLS
 from openpype.hosts.photoshop.api.pipeline import cache_and_get_instances
+from openpype.hosts.photoshop.lib import clean_subset_name
 
 
 class ImageCreator(Creator):
@@ -88,6 +89,7 @@ class ImageCreator(Creator):
 
             layer_fill = prepare_template_data({"layer": layer_name})
             subset_name = subset_name.format(**layer_fill)
+            subset_name = clean_subset_name(subset_name)
 
             if group.long_name:
                 for directory in group.long_name[::-1]:
@@ -184,7 +186,6 @@ class ImageCreator(Creator):
         self.mark_for_review = plugin_settings["mark_for_review"]
         self.enabled = plugin_settings["enabled"]
 
-
     def get_detail_description(self):
         return """Creator for Image instances
 
diff --git a/tests/unit/openpype/hosts/photoshop/test_lib.py b/tests/unit/openpype/hosts/photoshop/test_lib.py
new file mode 100644
index 0000000000..ad4feb42ae
--- /dev/null
+++ b/tests/unit/openpype/hosts/photoshop/test_lib.py
@@ -0,0 +1,25 @@
+import pytest
+
+from openpype.hosts.photoshop.lib import clean_subset_name
+
+"""
+Tests cleanup of unused layer placeholder ({layer}) from subset name.
+Layer differentiation might be desired in subset name, but in some cases it
+might be used (in `auto_image` - only single image without layer diff.,
+single image instance created without toggled use of subset name etc.)
+"""
+
+
+def test_no_layer_placeholder():
+    clean_subset = clean_subset_name("imageMain")
+    assert "imageMain" == clean_subset
+
+
+@pytest.mark.parametrize("subset_name",
+                         ["imageMain{Layer}",
+                          "imageMain_{layer}",  # trailing _
+                          "image{Layer}Main",
+                          "image{LAYER}Main"])
+def test_not_used_layer_placeholder(subset_name):
+    clean_subset = clean_subset_name(subset_name)
+    assert "imageMain" == clean_subset

From 0595afe8a3240747cd852e3fc4073f58382ccd86 Mon Sep 17 00:00:00 2001
From: Kayla Man <moonyuet2008@hotmail.com>
Date: Tue, 26 Sep 2023 00:34:44 +0800
Subject: [PATCH 329/366] add % check on the fhead in the lib.py

---
 openpype/hosts/nuke/api/lib.py | 18 +++++++++++++-----
 1 file changed, 13 insertions(+), 5 deletions(-)

diff --git a/openpype/hosts/nuke/api/lib.py b/openpype/hosts/nuke/api/lib.py
index af07092daf..8790794fcd 100644
--- a/openpype/hosts/nuke/api/lib.py
+++ b/openpype/hosts/nuke/api/lib.py
@@ -3432,19 +3432,27 @@ def get_head_filename_without_hashes(original_path, name):
 
     Args:
         original_path (str): the filename with frame hashes
-        e.g. "renderAssetMain.####.exr"
+        e.g. "renderCompositingMain.####.exr"
         name (str): the name of the tags
         e.g. "baking"
 
     Returns:
         filename: the renamed filename with the tag
-        e.g. "renderAssetMain.baking.####.exr"
+        e.g. "renderCompositingMain.baking.####.exr"
     """
     filename = os.path.basename(original_path)
     fhead = os.path.splitext(filename)[0].strip(".")
-    tmp_fhead = re.sub(r"\d", "#", fhead)
-    if "#" in tmp_fhead:
-        fhead = tmp_fhead.replace("#", "").rstrip(".")
+    if "#" in fhead:
+        fhead = re.sub("#+", "", fhead).rstrip(".")
+    elif "%" in fhead:
+        # use regex to convert %04d to {:0>4}
+        padding = re.search("%(\\d)+d", fhead)
+        padding = padding.group(1) if padding else 1
+        fhead = re.sub(
+            "%.*d",
+            "{{:0>{}}}".format(padding),
+            fhead
+        ).rstip(".")
     new_fhead = "{}.{}".format(fhead, name)
     filename = filename.replace(fhead, new_fhead)
     return filename

From 65bfe023c7d2b8a571185a49e78ef7b775d30fc9 Mon Sep 17 00:00:00 2001
From: Kayla Man <moonyuet2008@hotmail.com>
Date: Tue, 26 Sep 2023 00:41:04 +0800
Subject: [PATCH 330/366] transform the files with frame hashes to the list of
 filenames when publishing

---
 openpype/hosts/nuke/api/lib.py    | 24 ++++++++++++++++++++++++
 openpype/hosts/nuke/api/plugin.py |  7 ++++++-
 2 files changed, 30 insertions(+), 1 deletion(-)

diff --git a/openpype/hosts/nuke/api/lib.py b/openpype/hosts/nuke/api/lib.py
index 8790794fcd..9e41dbe8bc 100644
--- a/openpype/hosts/nuke/api/lib.py
+++ b/openpype/hosts/nuke/api/lib.py
@@ -3456,3 +3456,27 @@ def get_head_filename_without_hashes(original_path, name):
     new_fhead = "{}.{}".format(fhead, name)
     filename = filename.replace(fhead, new_fhead)
     return filename
+
+
+def get_filenames_without_hash(filename, frame_start, frame_end):
+    """Get filenames without frame hash
+        i.e. "renderCompositingMain.baking.0001.exr"
+
+    Args:
+        filename (str): filename with frame hash
+        frame_start (str): start of the frame
+        frame_end (str): end of the frame
+
+    Returns:
+        filenames(list): list of filename
+    """
+    filenames = []
+    for frame in range(int(frame_start), (int(frame_end) + 1)):
+        if "#" in filename:
+            # use regex to convert #### to {:0>4}
+            def replace(match):
+                return "{{:0>{}}}".format(len(match.group()))
+            filename_without_hashes = re.sub("#+", replace, filename)
+            new_filename = filename_without_hashes.format(frame)
+            filenames.append(new_filename)
+    return filenames
diff --git a/openpype/hosts/nuke/api/plugin.py b/openpype/hosts/nuke/api/plugin.py
index ca31068943..348a0b5d76 100644
--- a/openpype/hosts/nuke/api/plugin.py
+++ b/openpype/hosts/nuke/api/plugin.py
@@ -39,7 +39,8 @@ from .lib import (
     get_view_process_node,
     get_viewer_config_from_string,
     deprecated,
-    get_head_filename_without_hashes
+    get_head_filename_without_hashes,
+    get_filenames_without_hash
 )
 from .pipeline import (
     list_instances,
@@ -638,6 +639,10 @@ class ExporterReview(object):
                 "frameStart": self.first_frame,
                 "frameEnd": self.last_frame,
             })
+        if ".{}".format(self.ext) not in VIDEO_EXTENSIONS:
+            filenames = get_filenames_without_hash(
+                self.file, self.first_frame, self.last_frame)
+            repre["files"] = filenames
 
         if self.multiple_presets:
             repre["outputName"] = self.name

From 4b1c9077e6c0f109c3315ddc88dd74f09a301bfe Mon Sep 17 00:00:00 2001
From: Jakub Trllo <43494761+iLLiCiTiT@users.noreply.github.com>
Date: Tue, 26 Sep 2023 13:42:01 +0200
Subject: [PATCH 331/366] fix workfiles tool save button (#5653)

---
 openpype/tools/ayon_workfiles/models/workfiles.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/tools/ayon_workfiles/models/workfiles.py b/openpype/tools/ayon_workfiles/models/workfiles.py
index 316d8b2a16..4d989ed22c 100644
--- a/openpype/tools/ayon_workfiles/models/workfiles.py
+++ b/openpype/tools/ayon_workfiles/models/workfiles.py
@@ -48,7 +48,7 @@ def get_task_template_data(project_entity, task):
         return {}
     short_name = None
     task_type_name = task["taskType"]
-    for task_type_info in project_entity["config"]["taskTypes"]:
+    for task_type_info in project_entity["taskTypes"]:
         if task_type_info["name"] == task_type_name:
             short_name = task_type_info["shortName"]
             break

From 40755fce119f388efa85e4cab5c94da749b54dbf Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Tue, 26 Sep 2023 18:56:01 +0200
Subject: [PATCH 332/366] Increase timout for deadline test (#5654)

DL picks up jobs quite slow, so bump up delay.
---
 tests/integration/hosts/maya/test_deadline_publish_in_maya.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/tests/integration/hosts/maya/test_deadline_publish_in_maya.py b/tests/integration/hosts/maya/test_deadline_publish_in_maya.py
index c5bf526f52..9332177944 100644
--- a/tests/integration/hosts/maya/test_deadline_publish_in_maya.py
+++ b/tests/integration/hosts/maya/test_deadline_publish_in_maya.py
@@ -32,7 +32,7 @@ class TestDeadlinePublishInMaya(MayaDeadlinePublishTestClass):
     # keep empty to locate latest installed variant or explicit
     APP_VARIANT = ""
 
-    TIMEOUT = 120  # publish timeout
+    TIMEOUT = 180  # publish timeout
 
     def test_db_asserts(self, dbcon, publish_finished):
         """Host and input data dependent expected results in DB."""

From 16bcbc155867c0daef9c990484035c6ba0f16ec2 Mon Sep 17 00:00:00 2001
From: Ynbot <bot@ynput.io>
Date: Wed, 27 Sep 2023 03:24:58 +0000
Subject: [PATCH 333/366] [Automated] Bump version

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

diff --git a/openpype/version.py b/openpype/version.py
index d1ebde3d04..c8ae6dffd8 100644
--- a/openpype/version.py
+++ b/openpype/version.py
@@ -1,3 +1,3 @@
 # -*- coding: utf-8 -*-
 """Package declaring Pype version."""
-__version__ = "3.17.1-nightly.2"
+__version__ = "3.17.1-nightly.3"

From 3ddfb13e2aae05e4df2b3a6da7900600d8649d1d Mon Sep 17 00:00:00 2001
From: "github-actions[bot]" <github-actions[bot]@users.noreply.github.com>
Date: Wed, 27 Sep 2023 03:25:45 +0000
Subject: [PATCH 334/366] chore(): update bug report / version

---
 .github/ISSUE_TEMPLATE/bug_report.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/ISSUE_TEMPLATE/bug_report.yml b/.github/ISSUE_TEMPLATE/bug_report.yml
index 87d904fc84..a2edd28f5b 100644
--- a/.github/ISSUE_TEMPLATE/bug_report.yml
+++ b/.github/ISSUE_TEMPLATE/bug_report.yml
@@ -35,6 +35,7 @@ body:
       label: Version
       description: What version are you running? Look to OpenPype Tray
       options:
+        - 3.17.1-nightly.3
         - 3.17.1-nightly.2
         - 3.17.1-nightly.1
         - 3.17.0
@@ -134,7 +135,6 @@ body:
         - 3.14.10-nightly.6
         - 3.14.10-nightly.5
         - 3.14.10-nightly.4
-        - 3.14.10-nightly.3
     validations:
       required: true
   - type: dropdown

From 4ae8e7fa774e06ebc690998f2dd7d623a9e8c044 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Wed, 27 Sep 2023 11:39:15 +0200
Subject: [PATCH 335/366] removing project entity redundancy

---
 .../plugins/publish/collect_sequence_frame_data.py   | 12 +++++++-----
 1 file changed, 7 insertions(+), 5 deletions(-)

diff --git a/openpype/plugins/publish/collect_sequence_frame_data.py b/openpype/plugins/publish/collect_sequence_frame_data.py
index 1c456563e6..33ff3281a2 100644
--- a/openpype/plugins/publish/collect_sequence_frame_data.py
+++ b/openpype/plugins/publish/collect_sequence_frame_data.py
@@ -28,10 +28,12 @@ class CollectSequenceFrameData(pyblish.api.InstancePlugin):
 
     def get_frame_data_from_repre_sequence(self, instance):
         repres = instance.data.get("representations")
-        parent_entity = (
-            instance.data.get("assetEntity")
-            or instance.context.data["projectEntity"]
-        )
+        parent_entity = instance.data.get("assetEntity")
+
+        if not parent_entity:
+            self.log.warning("Cannot find parent entity data")
+            return
+
         if repres:
             first_repre = repres[0]
             if "ext" not in first_repre:
@@ -40,7 +42,7 @@ class CollectSequenceFrameData(pyblish.api.InstancePlugin):
                 return
 
             files = first_repre["files"]
-            collections, remainder = clique.assemble(files)
+            collections, _ = clique.assemble(files)
             if not collections:
                 # No sequences detected and we can't retrieve
                 # frame range

From fbafc420aaaced3501be9e2b24f8025c85809c8c Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Wed, 27 Sep 2023 12:28:42 +0200
Subject: [PATCH 336/366] reverting enhancing UX of sequence or asset frame
 data collection

---
 ...> collect_frame_data_from_asset_entity.py} | 23 +++++++------------
 .../publish/collect_sequence_frame_data.py    | 21 +++++++++--------
 2 files changed, 19 insertions(+), 25 deletions(-)
 rename openpype/hosts/traypublisher/plugins/publish/{collect_missing_frame_range_asset_entity.py => collect_frame_data_from_asset_entity.py} (51%)

diff --git a/openpype/hosts/traypublisher/plugins/publish/collect_missing_frame_range_asset_entity.py b/openpype/hosts/traypublisher/plugins/publish/collect_frame_data_from_asset_entity.py
similarity index 51%
rename from openpype/hosts/traypublisher/plugins/publish/collect_missing_frame_range_asset_entity.py
rename to openpype/hosts/traypublisher/plugins/publish/collect_frame_data_from_asset_entity.py
index 72379ea4e1..f2e24d88eb 100644
--- a/openpype/hosts/traypublisher/plugins/publish/collect_missing_frame_range_asset_entity.py
+++ b/openpype/hosts/traypublisher/plugins/publish/collect_frame_data_from_asset_entity.py
@@ -2,18 +2,18 @@ import pyblish.api
 from openpype.pipeline import OptionalPyblishPluginMixin
 
 
-class CollectMissingFrameDataFromAssetEntity(
+class CollectFrameDataFromAssetEntity(
     pyblish.api.InstancePlugin,
     OptionalPyblishPluginMixin
 ):
-    """Collect Missing Frame Range data From Asset Entity
+    """Collect Frame Data From AssetEntity found in context
 
     Frame range data will only be collected if the keys
     are not yet collected for the instance.
     """
 
     order = pyblish.api.CollectorOrder + 0.491
-    label = "Collect Missing Frame Data From Asset Entity"
+    label = "Collect Frame Data From Asset"
     families = ["plate", "pointcache",
                 "vdbcache", "online",
                 "render"]
@@ -23,7 +23,9 @@ class CollectMissingFrameDataFromAssetEntity(
     def process(self, instance):
         if not self.is_active(instance.data):
             return
-        missing_keys = []
+
+        asset_data = instance.data["assetEntity"]["data"]
+
         for key in (
             "fps",
             "frameStart",
@@ -31,14 +33,5 @@ class CollectMissingFrameDataFromAssetEntity(
             "handleStart",
             "handleEnd"
         ):
-            if key not in instance.data:
-                missing_keys.append(key)
-        keys_set = []
-        for key in missing_keys:
-            asset_data = instance.data["assetEntity"]["data"]
-            if key in asset_data:
-                instance.data[key] = asset_data[key]
-                keys_set.append(key)
-        if keys_set:
-            self.log.debug(f"Frame range data {keys_set} "
-                           "has been collected from asset entity.")
+            instance.data[key] = asset_data[key]
+            self.log.debug(f"Collected Frame range data '{key}':{asset_data[key]} ")
diff --git a/openpype/plugins/publish/collect_sequence_frame_data.py b/openpype/plugins/publish/collect_sequence_frame_data.py
index 33ff3281a2..d8ad5d0a21 100644
--- a/openpype/plugins/publish/collect_sequence_frame_data.py
+++ b/openpype/plugins/publish/collect_sequence_frame_data.py
@@ -9,7 +9,7 @@ class CollectSequenceFrameData(pyblish.api.InstancePlugin):
     start and end frame respectively
     """
 
-    order = pyblish.api.CollectorOrder + 0.2
+    order = pyblish.api.CollectorOrder + 0.490
     label = "Collect Sequence Frame Data"
     families = ["plate", "pointcache",
                 "vdbcache", "online",
@@ -18,21 +18,22 @@ class CollectSequenceFrameData(pyblish.api.InstancePlugin):
 
     def process(self, instance):
         frame_data = self.get_frame_data_from_repre_sequence(instance)
+
         if not frame_data:
             # if no dict data skip collecting the frame range data
             return
+
         for key, value in frame_data.items():
-            if key not in instance.data:
-                instance.data[key] = value
-                self.log.debug(f"Collected Frame range data '{key}':{value} ")
+            instance.data[key] = value
+            self.log.debug(f"Collected Frame range data '{key}':{value} ")
+
+        test_keys = {key: value for key, value in instance.data.items() if key in frame_data}
+        self.log.debug(f"Final Instance frame data: {test_keys}")
+
 
     def get_frame_data_from_repre_sequence(self, instance):
         repres = instance.data.get("representations")
-        parent_entity = instance.data.get("assetEntity")
-
-        if not parent_entity:
-            self.log.warning("Cannot find parent entity data")
-            return
+        asset_data = instance.data["assetEntity"]["data"]
 
         if repres:
             first_repre = repres[0]
@@ -58,5 +59,5 @@ class CollectSequenceFrameData(pyblish.api.InstancePlugin):
                 "frameEnd": repres_frames[-1],
                 "handleStart": 0,
                 "handleEnd": 0,
-                "fps": parent_entity["data"]["fps"]
+                "fps": asset_data["fps"]
             }

From 5b1cbfaa6743c6bd4f9b6be4e86b3a0854dbb3c9 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Wed, 27 Sep 2023 12:35:36 +0200
Subject: [PATCH 337/366] removing debug prints

---
 .../plugins/publish/collect_frame_data_from_asset_entity.py    | 3 ++-
 openpype/plugins/publish/collect_sequence_frame_data.py        | 3 ---
 2 files changed, 2 insertions(+), 4 deletions(-)

diff --git a/openpype/hosts/traypublisher/plugins/publish/collect_frame_data_from_asset_entity.py b/openpype/hosts/traypublisher/plugins/publish/collect_frame_data_from_asset_entity.py
index f2e24d88eb..5ba84bc05b 100644
--- a/openpype/hosts/traypublisher/plugins/publish/collect_frame_data_from_asset_entity.py
+++ b/openpype/hosts/traypublisher/plugins/publish/collect_frame_data_from_asset_entity.py
@@ -34,4 +34,5 @@ class CollectFrameDataFromAssetEntity(
             "handleEnd"
         ):
             instance.data[key] = asset_data[key]
-            self.log.debug(f"Collected Frame range data '{key}':{asset_data[key]} ")
+            self.log.debug(
+                f"Collected Frame range data '{key}':{asset_data[key]} ")
diff --git a/openpype/plugins/publish/collect_sequence_frame_data.py b/openpype/plugins/publish/collect_sequence_frame_data.py
index d8ad5d0a21..f9ac869ec3 100644
--- a/openpype/plugins/publish/collect_sequence_frame_data.py
+++ b/openpype/plugins/publish/collect_sequence_frame_data.py
@@ -27,9 +27,6 @@ class CollectSequenceFrameData(pyblish.api.InstancePlugin):
             instance.data[key] = value
             self.log.debug(f"Collected Frame range data '{key}':{value} ")
 
-        test_keys = {key: value for key, value in instance.data.items() if key in frame_data}
-        self.log.debug(f"Final Instance frame data: {test_keys}")
-
 
     def get_frame_data_from_repre_sequence(self, instance):
         repres = instance.data.get("representations")

From e90d227a234fec278b214c3ed4086350403eda80 Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Wed, 27 Sep 2023 13:37:01 +0200
Subject: [PATCH 338/366] reverting the functionality

- sequencial original frame data should be optional plugin
- sequential data are added if activated
- asset data frame data are not optional anymore and are added only if missing
---
 .../collect_frame_data_from_asset_entity.py   | 27 +++++++++----------
 .../publish/collect_sequence_frame_data.py    | 18 ++++++++++---
 .../project_settings/traypublisher.json       |  4 +--
 .../schema_project_traypublisher.json         |  4 +--
 4 files changed, 31 insertions(+), 22 deletions(-)
 rename openpype/{ => hosts/traypublisher}/plugins/publish/collect_sequence_frame_data.py (82%)

diff --git a/openpype/hosts/traypublisher/plugins/publish/collect_frame_data_from_asset_entity.py b/openpype/hosts/traypublisher/plugins/publish/collect_frame_data_from_asset_entity.py
index 5ba84bc05b..2950076cd0 100644
--- a/openpype/hosts/traypublisher/plugins/publish/collect_frame_data_from_asset_entity.py
+++ b/openpype/hosts/traypublisher/plugins/publish/collect_frame_data_from_asset_entity.py
@@ -1,11 +1,7 @@
 import pyblish.api
-from openpype.pipeline import OptionalPyblishPluginMixin
 
 
-class CollectFrameDataFromAssetEntity(
-    pyblish.api.InstancePlugin,
-    OptionalPyblishPluginMixin
-):
+class CollectFrameDataFromAssetEntity(pyblish.api.InstancePlugin):
     """Collect Frame Data From AssetEntity found in context
 
     Frame range data will only be collected if the keys
@@ -18,14 +14,9 @@ class CollectFrameDataFromAssetEntity(
                 "vdbcache", "online",
                 "render"]
     hosts = ["traypublisher"]
-    optional = True
 
     def process(self, instance):
-        if not self.is_active(instance.data):
-            return
-
-        asset_data = instance.data["assetEntity"]["data"]
-
+        missing_keys = []
         for key in (
             "fps",
             "frameStart",
@@ -33,6 +24,14 @@ class CollectFrameDataFromAssetEntity(
             "handleStart",
             "handleEnd"
         ):
-            instance.data[key] = asset_data[key]
-            self.log.debug(
-                f"Collected Frame range data '{key}':{asset_data[key]} ")
+            if key not in instance.data:
+                missing_keys.append(key)
+        keys_set = []
+        for key in missing_keys:
+            asset_data = instance.data["assetEntity"]["data"]
+            if key in asset_data:
+                instance.data[key] = asset_data[key]
+                keys_set.append(key)
+        if keys_set:
+            self.log.debug(f"Frame range data {keys_set} "
+                           "has been collected from asset entity.")
diff --git a/openpype/plugins/publish/collect_sequence_frame_data.py b/openpype/hosts/traypublisher/plugins/publish/collect_sequence_frame_data.py
similarity index 82%
rename from openpype/plugins/publish/collect_sequence_frame_data.py
rename to openpype/hosts/traypublisher/plugins/publish/collect_sequence_frame_data.py
index f9ac869ec3..db70d4fe0a 100644
--- a/openpype/plugins/publish/collect_sequence_frame_data.py
+++ b/openpype/hosts/traypublisher/plugins/publish/collect_sequence_frame_data.py
@@ -1,22 +1,32 @@
 import pyblish.api
 import clique
 
+from openpype.pipeline import OptionalPyblishPluginMixin
+
+
+class CollectSequenceFrameData(
+    pyblish.api.InstancePlugin,
+    OptionalPyblishPluginMixin
+):
+    """Collect Original Sequence Frame Data
 
-class CollectSequenceFrameData(pyblish.api.InstancePlugin):
-    """Collect Sequence Frame Data
     If the representation includes files with frame numbers,
     then set `frameStart` and `frameEnd` for the instance to the
     start and end frame respectively
     """
 
-    order = pyblish.api.CollectorOrder + 0.490
-    label = "Collect Sequence Frame Data"
+    order = pyblish.api.CollectorOrder + 0.4905
+    label = "Collect Original Sequence Frame Data"
     families = ["plate", "pointcache",
                 "vdbcache", "online",
                 "render"]
     hosts = ["traypublisher"]
+    optional = True
 
     def process(self, instance):
+        if not self.is_active(instance.data):
+            return
+
         frame_data = self.get_frame_data_from_repre_sequence(instance)
 
         if not frame_data:
diff --git a/openpype/settings/defaults/project_settings/traypublisher.json b/openpype/settings/defaults/project_settings/traypublisher.json
index 7f7b7d1452..e13de11414 100644
--- a/openpype/settings/defaults/project_settings/traypublisher.json
+++ b/openpype/settings/defaults/project_settings/traypublisher.json
@@ -346,10 +346,10 @@
         }
     },
     "publish": {
-        "CollectFrameDataFromAssetEntity": {
+        "CollectSequenceFrameData": {
             "enabled": true,
             "optional": true,
-            "active": true
+            "active": false
         },
         "ValidateFrameRange": {
             "enabled": true,
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 184fc657be..93e6325b5a 100644
--- a/openpype/settings/entities/schemas/projects_schema/schema_project_traypublisher.json
+++ b/openpype/settings/entities/schemas/projects_schema/schema_project_traypublisher.json
@@ -350,8 +350,8 @@
                     "name": "template_validate_plugin",
                     "template_data": [
                         {
-                            "key": "CollectFrameDataFromAssetEntity",
-                            "label": "Collect frame range from asset entity"
+                            "key": "CollectSequenceFrameData",
+                            "label": "Collect Original Sequence Frame Data"
                         },
                         {
                             "key": "ValidateFrameRange",

From 8897cdaa92f21e5c9de22cccd9e73ecc65c0c845 Mon Sep 17 00:00:00 2001
From: Kayla Man <moonyuet2008@hotmail.com>
Date: Wed, 27 Sep 2023 19:43:21 +0800
Subject: [PATCH 339/366] bug fix delete items from container to remove item

---
 openpype/hosts/max/api/plugin.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/hosts/max/api/plugin.py b/openpype/hosts/max/api/plugin.py
index 3389447cb0..b23d156d0d 100644
--- a/openpype/hosts/max/api/plugin.py
+++ b/openpype/hosts/max/api/plugin.py
@@ -91,7 +91,7 @@ MS_CUSTOM_ATTRIB = """attributes "openPypeData"
         (
             current_selection = selectByName title:"Select Objects to remove
             from the Container" buttontext:"Remove" filter: nodes_to_rmv
-            if current_selection == undefined then return False
+            if current_selection == undefined or current_selection.count == 0 then return False
             temp_arr = #()
             i_node_arr = #()
             new_i_node_arr = #()

From 1c8ab8ecfacc95543fa348a08c4e1b23495bc52c Mon Sep 17 00:00:00 2001
From: Jakub Jezek <jakubjezek001@gmail.com>
Date: Wed, 27 Sep 2023 13:47:16 +0200
Subject: [PATCH 340/366] better label

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

diff --git a/openpype/hosts/traypublisher/plugins/publish/collect_frame_data_from_asset_entity.py b/openpype/hosts/traypublisher/plugins/publish/collect_frame_data_from_asset_entity.py
index 2950076cd0..e8a2cae16c 100644
--- a/openpype/hosts/traypublisher/plugins/publish/collect_frame_data_from_asset_entity.py
+++ b/openpype/hosts/traypublisher/plugins/publish/collect_frame_data_from_asset_entity.py
@@ -9,7 +9,7 @@ class CollectFrameDataFromAssetEntity(pyblish.api.InstancePlugin):
     """
 
     order = pyblish.api.CollectorOrder + 0.491
-    label = "Collect Frame Data From Asset"
+    label = "Collect Missing Frame Data From Asset"
     families = ["plate", "pointcache",
                 "vdbcache", "online",
                 "render"]

From 723d187835a83d7f76c65017411b0a7263a8e18a Mon Sep 17 00:00:00 2001
From: Kayla Man <moonyuet2008@hotmail.com>
Date: Wed, 27 Sep 2023 19:54:01 +0800
Subject: [PATCH 341/366] hound

---
 openpype/hosts/max/api/plugin.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/hosts/max/api/plugin.py b/openpype/hosts/max/api/plugin.py
index b23d156d0d..31f01b6bbf 100644
--- a/openpype/hosts/max/api/plugin.py
+++ b/openpype/hosts/max/api/plugin.py
@@ -91,7 +91,7 @@ MS_CUSTOM_ATTRIB = """attributes "openPypeData"
         (
             current_selection = selectByName title:"Select Objects to remove
             from the Container" buttontext:"Remove" filter: nodes_to_rmv
-            if current_selection == undefined or current_selection.count == 0 then return False
+            if current_selection == undefined or current_selection.count == 0 then return False     # noqa
             temp_arr = #()
             i_node_arr = #()
             new_i_node_arr = #()

From 42132e50e98208f581f97005dba839ba414265ee Mon Sep 17 00:00:00 2001
From: Kayla Man <moonyuet2008@hotmail.com>
Date: Wed, 27 Sep 2023 21:34:57 +0800
Subject: [PATCH 342/366] # noqa makes the maxscript not working

---
 openpype/hosts/max/api/plugin.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/hosts/max/api/plugin.py b/openpype/hosts/max/api/plugin.py
index 31f01b6bbf..b23d156d0d 100644
--- a/openpype/hosts/max/api/plugin.py
+++ b/openpype/hosts/max/api/plugin.py
@@ -91,7 +91,7 @@ MS_CUSTOM_ATTRIB = """attributes "openPypeData"
         (
             current_selection = selectByName title:"Select Objects to remove
             from the Container" buttontext:"Remove" filter: nodes_to_rmv
-            if current_selection == undefined or current_selection.count == 0 then return False     # noqa
+            if current_selection == undefined or current_selection.count == 0 then return False
             temp_arr = #()
             i_node_arr = #()
             new_i_node_arr = #()

From 49e8a4b008a17ce97fb3ed4a77c53534f6e2509c Mon Sep 17 00:00:00 2001
From: Kayla Man <moonyuet2008@hotmail.com>
Date: Wed, 27 Sep 2023 21:42:08 +0800
Subject: [PATCH 343/366] hound

---
 openpype/hosts/max/api/plugin.py | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/openpype/hosts/max/api/plugin.py b/openpype/hosts/max/api/plugin.py
index b23d156d0d..881295b317 100644
--- a/openpype/hosts/max/api/plugin.py
+++ b/openpype/hosts/max/api/plugin.py
@@ -91,7 +91,10 @@ MS_CUSTOM_ATTRIB = """attributes "openPypeData"
         (
             current_selection = selectByName title:"Select Objects to remove
             from the Container" buttontext:"Remove" filter: nodes_to_rmv
-            if current_selection == undefined or current_selection.count == 0 then return False
+            if current_selection == undefined or current_selection.count == 0 then
+            (
+                return False
+            )
             temp_arr = #()
             i_node_arr = #()
             new_i_node_arr = #()

From 9fdd895bb6e4acb16313225f6c85604002471547 Mon Sep 17 00:00:00 2001
From: Kayla Man <moonyuet2008@hotmail.com>
Date: Wed, 27 Sep 2023 21:44:19 +0800
Subject: [PATCH 344/366] rename current_selection to current_sel

---
 openpype/hosts/max/api/plugin.py | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/openpype/hosts/max/api/plugin.py b/openpype/hosts/max/api/plugin.py
index 881295b317..fa6db073db 100644
--- a/openpype/hosts/max/api/plugin.py
+++ b/openpype/hosts/max/api/plugin.py
@@ -65,12 +65,12 @@ MS_CUSTOM_ATTRIB = """attributes "openPypeData"
 
         on button_add pressed do
         (
-            current_selection = selectByName title:"Select Objects to add to
+            current_sel = selectByName title:"Select Objects to add to
             the Container" buttontext:"Add" filter:nodes_to_add
-            if current_selection == undefined then return False
+            if current_sel == undefined then return False
             temp_arr = #()
             i_node_arr = #()
-            for c in current_selection do
+            for c in current_sel do
             (
                 handle_name = node_to_name c
                 node_ref = NodeTransformMonitor node:c
@@ -89,9 +89,9 @@ MS_CUSTOM_ATTRIB = """attributes "openPypeData"
 
         on button_del pressed do
         (
-            current_selection = selectByName title:"Select Objects to remove
+            current_sel = selectByName title:"Select Objects to remove
             from the Container" buttontext:"Remove" filter: nodes_to_rmv
-            if current_selection == undefined or current_selection.count == 0 then
+            if current_sel == undefined or current_sel.count == 0 then
             (
                 return False
             )
@@ -100,7 +100,7 @@ MS_CUSTOM_ATTRIB = """attributes "openPypeData"
             new_i_node_arr = #()
             new_temp_arr = #()
 
-            for c in current_selection do
+            for c in current_sel do
             (
                 node_ref = NodeTransformMonitor node:c as string
                 handle_name = node_to_name c

From 6deb9338cbd56447ea548f20eb0a51158b124b9e Mon Sep 17 00:00:00 2001
From: Kayla Man <moonyuet2008@hotmail.com>
Date: Wed, 27 Sep 2023 21:47:02 +0800
Subject: [PATCH 345/366] fix the typo of rstrip

---
 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 9e41dbe8bc..351778d997 100644
--- a/openpype/hosts/nuke/api/lib.py
+++ b/openpype/hosts/nuke/api/lib.py
@@ -3452,7 +3452,7 @@ def get_head_filename_without_hashes(original_path, name):
             "%.*d",
             "{{:0>{}}}".format(padding),
             fhead
-        ).rstip(".")
+        ).rstrip(".")
     new_fhead = "{}.{}".format(fhead, name)
     filename = filename.replace(fhead, new_fhead)
     return filename

From ebdcc49cd7895aa3e4aceadb0a0af116a0e41843 Mon Sep 17 00:00:00 2001
From: Kayla Man <moonyuet2008@hotmail.com>
Date: Wed, 27 Sep 2023 22:52:53 +0800
Subject: [PATCH 346/366] implement more concise function for getting filenames
 with hashes

---
 openpype/hosts/nuke/api/lib.py | 28 +++++++++-------------------
 1 file changed, 9 insertions(+), 19 deletions(-)

diff --git a/openpype/hosts/nuke/api/lib.py b/openpype/hosts/nuke/api/lib.py
index 351778d997..d34e7a1e0a 100644
--- a/openpype/hosts/nuke/api/lib.py
+++ b/openpype/hosts/nuke/api/lib.py
@@ -3432,30 +3432,20 @@ def get_head_filename_without_hashes(original_path, name):
 
     Args:
         original_path (str): the filename with frame hashes
-        e.g. "renderCompositingMain.####.exr"
+            e.g. "renderCompositingMain.####.exr"
         name (str): the name of the tags
-        e.g. "baking"
+            e.g. "baking"
 
     Returns:
-        filename: the renamed filename with the tag
-        e.g. "renderCompositingMain.baking.####.exr"
+        str: the renamed filename with the tag
+            e.g. "renderCompositingMain.baking.####.exr"
     """
     filename = os.path.basename(original_path)
-    fhead = os.path.splitext(filename)[0].strip(".")
-    if "#" in fhead:
-        fhead = re.sub("#+", "", fhead).rstrip(".")
-    elif "%" in fhead:
-        # use regex to convert %04d to {:0>4}
-        padding = re.search("%(\\d)+d", fhead)
-        padding = padding.group(1) if padding else 1
-        fhead = re.sub(
-            "%.*d",
-            "{{:0>{}}}".format(padding),
-            fhead
-        ).rstrip(".")
-    new_fhead = "{}.{}".format(fhead, name)
-    filename = filename.replace(fhead, new_fhead)
-    return filename
+
+    def insert_name(matchobj):
+        return "{}.{}".format(name, matchobj.group(0))
+
+    return re.sub(r"(%\d*d)|#+", insert_name, filename)
 
 
 def get_filenames_without_hash(filename, frame_start, frame_end):

From abef01cd0560ce60e108ed71c1de1d159b7efcb1 Mon Sep 17 00:00:00 2001
From: Kayla Man <moonyuet2008@hotmail.com>
Date: Wed, 27 Sep 2023 22:54:18 +0800
Subject: [PATCH 347/366] edit docstring

---
 openpype/hosts/nuke/api/lib.py | 11 ++++++++---
 1 file changed, 8 insertions(+), 3 deletions(-)

diff --git a/openpype/hosts/nuke/api/lib.py b/openpype/hosts/nuke/api/lib.py
index d34e7a1e0a..cc2c5a6ec7 100644
--- a/openpype/hosts/nuke/api/lib.py
+++ b/openpype/hosts/nuke/api/lib.py
@@ -3430,15 +3430,20 @@ def get_head_filename_without_hashes(original_path, name):
     To avoid the system being confused on finding the filename with
     frame hashes if the head of the filename has the hashed symbol
 
+    Examples:
+        >>> get_head_filename_without_hashes("render.####.exr", "baking")
+        render.baking.####.exr
+        >>> get_head_filename_without_hashes("render.%d.exr", "tag")
+        render.tag.%d.exr
+        >>> get_head_filename_without_hashes("exr.####.exr", "foo")
+        exr.foo.%04d.exr
+
     Args:
         original_path (str): the filename with frame hashes
-            e.g. "renderCompositingMain.####.exr"
         name (str): the name of the tags
-            e.g. "baking"
 
     Returns:
         str: the renamed filename with the tag
-            e.g. "renderCompositingMain.baking.####.exr"
     """
     filename = os.path.basename(original_path)
 

From e493886f4de4316778d3129d40f441f8ded24b71 Mon Sep 17 00:00:00 2001
From: Kayla Man <moonyuet2008@hotmail.com>
Date: Wed, 27 Sep 2023 23:17:12 +0800
Subject: [PATCH 348/366] improve docstring on lib.py and add comment on the
 condition of setting filename with extension and improved the deprecrated
 settings

---
 openpype/hosts/nuke/api/lib.py                    |  2 +-
 openpype/hosts/nuke/api/plugin.py                 |  4 ++++
 .../publish/extract_review_baking_streams.py      | 10 +++++-----
 openpype/settings/ayon_settings.py                | 15 ++++++---------
 4 files changed, 16 insertions(+), 15 deletions(-)

diff --git a/openpype/hosts/nuke/api/lib.py b/openpype/hosts/nuke/api/lib.py
index cc2c5a6ec7..dafc4bf838 100644
--- a/openpype/hosts/nuke/api/lib.py
+++ b/openpype/hosts/nuke/api/lib.py
@@ -3463,7 +3463,7 @@ def get_filenames_without_hash(filename, frame_start, frame_end):
         frame_end (str): end of the frame
 
     Returns:
-        filenames(list): list of filename
+        list: filename per frame of the sequence
     """
     filenames = []
     for frame in range(int(frame_start), (int(frame_end) + 1)):
diff --git a/openpype/hosts/nuke/api/plugin.py b/openpype/hosts/nuke/api/plugin.py
index 348a0b5d76..e16aef6740 100644
--- a/openpype/hosts/nuke/api/plugin.py
+++ b/openpype/hosts/nuke/api/plugin.py
@@ -818,9 +818,13 @@ class ExporterReviewMov(ExporterReview):
 
         self.file = self.fhead + self.name + ".{}".format(self.ext)
         if ".{}".format(self.ext) not in VIDEO_EXTENSIONS:
+            # filename would be with frame hashes if
+            # the file extension is not in video format
             filename = get_head_filename_without_hashes(
                 self.path_in, self.name)
             self.file = filename
+            # make sure the filename are in
+            # correct image output format
             if ".{}".format(self.ext) not in self.file:
                 original_ext = os.path.splitext(filename)[-1].strip(".")    # noqa
                 self.file = filename.replace(original_ext, ext)
diff --git a/openpype/hosts/nuke/plugins/publish/extract_review_baking_streams.py b/openpype/hosts/nuke/plugins/publish/extract_review_baking_streams.py
index d9ae673c2c..fe468bd263 100644
--- a/openpype/hosts/nuke/plugins/publish/extract_review_baking_streams.py
+++ b/openpype/hosts/nuke/plugins/publish/extract_review_baking_streams.py
@@ -33,13 +33,13 @@ class ExtractReviewDataBakingStreams(publish.Extractor):
         nuke_publish = project_settings["nuke"]["publish"]
         deprecated_setting = nuke_publish["ExtractReviewDataMov"]
         current_setting = nuke_publish["ExtractReviewDataBakingStreams"]
-        if not deprecated_setting["enabled"]:
-            if current_setting["enabled"]:
-                cls.viewer_lut_raw = current_setting["viewer_lut_raw"]
-                cls.outputs = current_setting["outputs"]
-        else:
+        if deprecated_setting["enabled"]:
+            # Use deprecated settings if they are still enabled
             cls.viewer_lut_raw = deprecated_setting["viewer_lut_raw"]
             cls.outputs = deprecated_setting["outputs"]
+        elif current_setting["enabled"]:
+            cls.viewer_lut_raw = current_setting["viewer_lut_raw"]
+            cls.outputs = current_setting["outputs"]
 
     def process(self, instance):
         families = set(instance.data["families"])
diff --git a/openpype/settings/ayon_settings.py b/openpype/settings/ayon_settings.py
index b43e0b7c5f..dc6e9fab12 100644
--- a/openpype/settings/ayon_settings.py
+++ b/openpype/settings/ayon_settings.py
@@ -754,11 +754,10 @@ def _convert_nuke_project_settings(ayon_settings, output):
     current_review_settings = (
         ayon_publish["ExtractReviewDataBakingStreams"]
     )
-    if not deprecrated_review_settings["enabled"]:
-        if current_review_settings["enabled"]:
-            outputs_settings = current_review_settings["outputs"]
-    else:
+    if deprecrated_review_settings["enabled"]:
         outputs_settings = deprecrated_review_settings["outputs"]
+    elif current_review_settings["enabled"]:
+        outputs_settings = current_review_settings["outputs"]
 
     for item in outputs_settings:
         item_filter = item["filter"]
@@ -780,12 +779,10 @@ def _convert_nuke_project_settings(ayon_settings, output):
         name = item.pop("name")
         new_review_data_outputs[name] = item
 
-    if deprecrated_review_settings["outputs"] == (
-        current_review_settings["outputs"]
-    ):
-        current_review_settings["outputs"] = new_review_data_outputs
-    else:
+    if deprecrated_review_settings["enabled"]:
         deprecrated_review_settings["outputs"] = new_review_data_outputs
+    elif current_review_settings["enabled"]:
+        current_review_settings["outputs"] = new_review_data_outputs
 
     collect_instance_data = ayon_publish["CollectInstanceData"]
     if "sync_workfile_version_on_product_types" in collect_instance_data:

From 973e4804d5731dbb85e916177ecef7854d5d30d1 Mon Sep 17 00:00:00 2001
From: Kayla Man <moonyuet2008@hotmail.com>
Date: Wed, 27 Sep 2023 23:30:57 +0800
Subject: [PATCH 349/366] make sure not using .replace

---
 openpype/hosts/nuke/api/plugin.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/openpype/hosts/nuke/api/plugin.py b/openpype/hosts/nuke/api/plugin.py
index e16aef6740..81841d17be 100644
--- a/openpype/hosts/nuke/api/plugin.py
+++ b/openpype/hosts/nuke/api/plugin.py
@@ -826,8 +826,8 @@ class ExporterReviewMov(ExporterReview):
             # make sure the filename are in
             # correct image output format
             if ".{}".format(self.ext) not in self.file:
-                original_ext = os.path.splitext(filename)[-1].strip(".")    # noqa
-                self.file = filename.replace(original_ext, ext)
+                filename_no_ext, _ = os.path.splitext(filename)
+                self.file = "{}.{}".format(filename_no_ext, self.ext)
 
         self.path = os.path.join(
             self.staging_dir, self.file).replace("\\", "/")

From 70d3f20de4c1963c67bd40be2613fc67ee34e017 Mon Sep 17 00:00:00 2001
From: Ynbot <bot@ynput.io>
Date: Thu, 28 Sep 2023 09:30:43 +0000
Subject: [PATCH 350/366] [Automated] Release

---
 CHANGELOG.md        | 264 ++++++++++++++++++++++++++++++++++++++++++++
 openpype/version.py |   2 +-
 pyproject.toml      |   2 +-
 3 files changed, 266 insertions(+), 2 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 4bcf66a210..8f14340348 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,6 +1,270 @@
 # Changelog
 
 
+## [3.17.1](https://github.com/ynput/OpenPype/tree/3.17.1)
+
+
+[Full Changelog](https://github.com/ynput/OpenPype/compare/3.17.0...3.17.1)
+
+### **🆕 New features**
+
+
+<details>
+<summary>Unreal: Yeti support <a href="https://github.com/ynput/OpenPype/pull/5643">#5643</a></summary>
+
+Implemented Yeti support for Unreal.
+
+
+___
+
+</details>
+
+
+<details>
+<summary>Houdini: Add Static Mesh product-type (family) <a href="https://github.com/ynput/OpenPype/pull/5481">#5481</a></summary>
+
+This PR adds support to publish Unreal Static Mesh in Houdini as FBXQuick recap
+- [x] Add UE Static Mesh Creator
+- [x] Dynamic subset name like in Maya
+- [x] Collect Static Mesh Type
+- [x] Update collect output node
+- [x] Validate FBX output node
+- [x] Validate mesh is static
+- [x] Validate Unreal Static Mesh Name
+- [x] Validate Subset Name
+- [x] FBX Extractor
+- [x] FBX Loader
+- [x] Update OP Settings
+- [x] Update AYON Settings
+
+
+___
+
+</details>
+
+
+<details>
+<summary>Launcher tool: Refactor launcher tool (for AYON) <a href="https://github.com/ynput/OpenPype/pull/5612">#5612</a></summary>
+
+Refactored launcher tool to new tool. Separated backend and frontend logic. Refactored logic is AYON-centric and is used only in AYON mode, so it does not affect OpenPype.
+
+
+___
+
+</details>
+
+### **🚀 Enhancements**
+
+
+<details>
+<summary>Maya: Use custom staging dir function for Maya renders - OP-5265 <a href="https://github.com/ynput/OpenPype/pull/5186">#5186</a></summary>
+
+Check for custom staging dir when setting the renders output folder in Maya.
+
+
+___
+
+</details>
+
+
+<details>
+<summary>Colorspace: updating file path detection methods <a href="https://github.com/ynput/OpenPype/pull/5273">#5273</a></summary>
+
+Support for OCIO v2 file rules integrated into the available color management API
+
+
+___
+
+</details>
+
+
+<details>
+<summary>Chore: add default isort config <a href="https://github.com/ynput/OpenPype/pull/5572">#5572</a></summary>
+
+Add default configuration for isort tool
+
+
+___
+
+</details>
+
+
+<details>
+<summary>Deadline: set PATH environment in deadline jobs by GlobalJobPreLoad <a href="https://github.com/ynput/OpenPype/pull/5622">#5622</a></summary>
+
+This PR makes `GlobalJobPreLoad` to set `PATH` environment in deadline jobs so that we don't have to use the full executable path for deadline to launch the dcc app. This trick should save us adding logic to pass houdini patch version and modifying Houdini deadline plugin. This trick should work with other DCCs
+
+
+___
+
+</details>
+
+
+<details>
+<summary>nuke: extract review data mov read node with expression <a href="https://github.com/ynput/OpenPype/pull/5635">#5635</a></summary>
+
+Some productions might have set default values for read nodes, those settings are not colliding anymore now.
+
+
+___
+
+</details>
+
+### **🐛 Bug fixes**
+
+
+<details>
+<summary>Maya: Support new publisher for colorsets validation. <a href="https://github.com/ynput/OpenPype/pull/5630">#5630</a></summary>
+
+Fix `validate_color_sets` for the new publisher.In current `develop` the repair option does not appear due to wrong error raising.
+
+
+___
+
+</details>
+
+
+<details>
+<summary>Houdini: Camera Loader fix mismatch for Maya cameras <a href="https://github.com/ynput/OpenPype/pull/5584">#5584</a></summary>
+
+This PR adds
+- A workaround to match Maya render mask in Houdini
+- `SetCameraResolution` inventory action
+- set camera resolution when loading or updating camera
+
+
+___
+
+</details>
+
+
+<details>
+<summary>Nuke: fix set colorspace on writes <a href="https://github.com/ynput/OpenPype/pull/5634">#5634</a></summary>
+
+Colorspace is set correctly to any write node created from publisher.
+
+
+___
+
+</details>
+
+
+<details>
+<summary>TVPaint: Fix review family extraction <a href="https://github.com/ynput/OpenPype/pull/5637">#5637</a></summary>
+
+Extractor marks representation of review instance with review tag.
+
+
+___
+
+</details>
+
+
+<details>
+<summary>AYON settings: Extract OIIO transcode settings <a href="https://github.com/ynput/OpenPype/pull/5639">#5639</a></summary>
+
+Output definitions of Extract OIIO transcode have name to match OpenPype settings, and the settings are converted to dictionary in settings conversion.
+
+
+___
+
+</details>
+
+
+<details>
+<summary>AYON: Fix task type short name conversion <a href="https://github.com/ynput/OpenPype/pull/5641">#5641</a></summary>
+
+Convert AYON task type short name for OpenPype correctly.
+
+
+___
+
+</details>
+
+
+<details>
+<summary>colorspace: missing `allowed_exts` fix <a href="https://github.com/ynput/OpenPype/pull/5646">#5646</a></summary>
+
+Colorspace module is not failing due to missing `allowed_exts` attribute.
+
+
+___
+
+</details>
+
+
+<details>
+<summary>Photoshop: remove trailing underscore in subset name <a href="https://github.com/ynput/OpenPype/pull/5647">#5647</a></summary>
+
+If {layer} placeholder is at the end of subset name template and not used (for example in `auto_image` where separating it by layer doesn't make any sense) trailing '_' was kept. This updates cleaning logic and extracts it as it might be similar in regular `image` instance.
+
+
+___
+
+</details>
+
+
+<details>
+<summary>traypublisher: missing `assetEntity` in context data <a href="https://github.com/ynput/OpenPype/pull/5648">#5648</a></summary>
+
+Issue with missing `assetEnity` key in context data is not problem anymore.
+
+
+___
+
+</details>
+
+
+<details>
+<summary>AYON: Workfiles tool save button works <a href="https://github.com/ynput/OpenPype/pull/5653">#5653</a></summary>
+
+Fix save as button in workfiles tool.(It is mystery why this stopped to work??)
+
+
+___
+
+</details>
+
+
+<details>
+<summary>Max: bug fix delete items from container <a href="https://github.com/ynput/OpenPype/pull/5658">#5658</a></summary>
+
+Fix the bug shown when clicking "Delete Items from Container" and selecting nothing and press ok.
+
+
+___
+
+</details>
+
+### **🔀 Refactored code**
+
+
+<details>
+<summary>Chore: Remove unused functions from Fusion integration <a href="https://github.com/ynput/OpenPype/pull/5617">#5617</a></summary>
+
+Cleanup unused code from Fusion integration
+
+
+___
+
+</details>
+
+### **Merged pull requests**
+
+
+<details>
+<summary>Increase timout for deadline test <a href="https://github.com/ynput/OpenPype/pull/5654">#5654</a></summary>
+
+DL picks up jobs quite slow, so bump up delay.
+
+
+___
+
+</details>
+
+
+
+
 ## [3.17.0](https://github.com/ynput/OpenPype/tree/3.17.0)
 
 
diff --git a/openpype/version.py b/openpype/version.py
index c8ae6dffd8..f1e0cd0b80 100644
--- a/openpype/version.py
+++ b/openpype/version.py
@@ -1,3 +1,3 @@
 # -*- coding: utf-8 -*-
 """Package declaring Pype version."""
-__version__ = "3.17.1-nightly.3"
+__version__ = "3.17.1"
diff --git a/pyproject.toml b/pyproject.toml
index d0b1ecf589..2460185bdd 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "OpenPype"
-version = "3.17.0" # OpenPype
+version = "3.17.1" # OpenPype
 description = "Open VFX and Animation pipeline with support."
 authors = ["OpenPype Team <info@openpype.io>"]
 license = "MIT License"

From 030d5843fa2baba9e723067f34db0e1dbc46f297 Mon Sep 17 00:00:00 2001
From: "github-actions[bot]" <github-actions[bot]@users.noreply.github.com>
Date: Thu, 28 Sep 2023 09:31:44 +0000
Subject: [PATCH 351/366] chore(): update bug report / version

---
 .github/ISSUE_TEMPLATE/bug_report.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/ISSUE_TEMPLATE/bug_report.yml b/.github/ISSUE_TEMPLATE/bug_report.yml
index a2edd28f5b..591d865ca5 100644
--- a/.github/ISSUE_TEMPLATE/bug_report.yml
+++ b/.github/ISSUE_TEMPLATE/bug_report.yml
@@ -35,6 +35,7 @@ body:
       label: Version
       description: What version are you running? Look to OpenPype Tray
       options:
+        - 3.17.1
         - 3.17.1-nightly.3
         - 3.17.1-nightly.2
         - 3.17.1-nightly.1
@@ -134,7 +135,6 @@ body:
         - 3.14.10-nightly.7
         - 3.14.10-nightly.6
         - 3.14.10-nightly.5
-        - 3.14.10-nightly.4
     validations:
       required: true
   - type: dropdown

From 356f05ff91efd32dcecbb72081f94740ec8df908 Mon Sep 17 00:00:00 2001
From: Kayla Man <moonyuet2008@hotmail.com>
Date: Thu, 28 Sep 2023 19:20:37 +0800
Subject: [PATCH 352/366] docstring tweaks

---
 openpype/hosts/nuke/api/lib.py                              | 2 +-
 .../nuke/plugins/publish/extract_review_baking_streams.py   | 6 +++---
 openpype/settings/ayon_settings.py                          | 3 ++-
 3 files changed, 6 insertions(+), 5 deletions(-)

diff --git a/openpype/hosts/nuke/api/lib.py b/openpype/hosts/nuke/api/lib.py
index dafc4bf838..07f394ec00 100644
--- a/openpype/hosts/nuke/api/lib.py
+++ b/openpype/hosts/nuke/api/lib.py
@@ -3433,7 +3433,7 @@ def get_head_filename_without_hashes(original_path, name):
     Examples:
         >>> get_head_filename_without_hashes("render.####.exr", "baking")
         render.baking.####.exr
-        >>> get_head_filename_without_hashes("render.%d.exr", "tag")
+        >>> get_head_filename_without_hashes("render.%04d.exr", "tag")
         render.tag.%d.exr
         >>> get_head_filename_without_hashes("exr.####.exr", "foo")
         exr.foo.%04d.exr
diff --git a/openpype/hosts/nuke/plugins/publish/extract_review_baking_streams.py b/openpype/hosts/nuke/plugins/publish/extract_review_baking_streams.py
index fe468bd263..1ba107a3e7 100644
--- a/openpype/hosts/nuke/plugins/publish/extract_review_baking_streams.py
+++ b/openpype/hosts/nuke/plugins/publish/extract_review_baking_streams.py
@@ -9,7 +9,7 @@ from openpype.hosts.nuke.api.lib import maintained_selection
 
 
 class ExtractReviewDataBakingStreams(publish.Extractor):
-    """Extracts movie and thumbnail with baked in luts
+    """Extracts Sequences and thumbnail with baked in luts
 
     must be run after extract_render_local.py
 
@@ -27,8 +27,8 @@ class ExtractReviewDataBakingStreams(publish.Extractor):
 
     @classmethod
     def apply_settings(cls, project_settings):
-        """just in case there are some old presets
-        in deprecated ExtractReviewDataMov Plugins
+        """Apply the settings from the deprecated
+        ExtractReviewDataMov plugin for backwards compatibility
         """
         nuke_publish = project_settings["nuke"]["publish"]
         deprecated_setting = nuke_publish["ExtractReviewDataMov"]
diff --git a/openpype/settings/ayon_settings.py b/openpype/settings/ayon_settings.py
index dc6e9fab12..f23046e6c4 100644
--- a/openpype/settings/ayon_settings.py
+++ b/openpype/settings/ayon_settings.py
@@ -749,7 +749,8 @@ def _convert_nuke_project_settings(ayon_settings, output):
 
     new_review_data_outputs = {}
     outputs_settings = None
-    # just in case that the users having old presets in outputs setting
+    # Check deprecated ExtractReviewDataMov
+    # settings for backwards compatibility
     deprecrated_review_settings = ayon_publish["ExtractReviewDataMov"]
     current_review_settings = (
         ayon_publish["ExtractReviewDataBakingStreams"]

From 6c1e066b3b7d58eba28d38900a886a0c89c556b5 Mon Sep 17 00:00:00 2001
From: Kayla Man <moonyuet2008@hotmail.com>
Date: Thu, 28 Sep 2023 20:07:28 +0800
Subject: [PATCH 353/366] Rename ExtractReviewDataBakingStreams to
 ExtractReviewIntermediate

---
 .../nuke/plugins/publish/extract_review_baking_streams.py   | 6 +++---
 openpype/settings/ayon_settings.py                          | 2 +-
 openpype/settings/defaults/project_settings/nuke.json       | 2 +-
 .../projects_schema/schemas/schema_nuke_publish.json        | 6 +++---
 server_addon/nuke/server/settings/publish_plugins.py        | 4 ++--
 website/docs/project_settings/settings_project_global.md    | 2 +-
 website/docs/pype2/admin_presets_plugins.md                 | 2 +-
 7 files changed, 12 insertions(+), 12 deletions(-)

diff --git a/openpype/hosts/nuke/plugins/publish/extract_review_baking_streams.py b/openpype/hosts/nuke/plugins/publish/extract_review_baking_streams.py
index 1ba107a3e7..4407c039b4 100644
--- a/openpype/hosts/nuke/plugins/publish/extract_review_baking_streams.py
+++ b/openpype/hosts/nuke/plugins/publish/extract_review_baking_streams.py
@@ -8,7 +8,7 @@ from openpype.hosts.nuke.api import plugin
 from openpype.hosts.nuke.api.lib import maintained_selection
 
 
-class ExtractReviewDataBakingStreams(publish.Extractor):
+class ExtractReviewIntermediate(publish.Extractor):
     """Extracts Sequences and thumbnail with baked in luts
 
     must be run after extract_render_local.py
@@ -16,7 +16,7 @@ class ExtractReviewDataBakingStreams(publish.Extractor):
     """
 
     order = pyblish.api.ExtractorOrder + 0.01
-    label = "Extract Review Data Baking Streams"
+    label = "Extract Review Intermediate"
 
     families = ["review"]
     hosts = ["nuke"]
@@ -32,7 +32,7 @@ class ExtractReviewDataBakingStreams(publish.Extractor):
         """
         nuke_publish = project_settings["nuke"]["publish"]
         deprecated_setting = nuke_publish["ExtractReviewDataMov"]
-        current_setting = nuke_publish["ExtractReviewDataBakingStreams"]
+        current_setting = nuke_publish["ExtractReviewIntermediate"]
         if deprecated_setting["enabled"]:
             # Use deprecated settings if they are still enabled
             cls.viewer_lut_raw = deprecated_setting["viewer_lut_raw"]
diff --git a/openpype/settings/ayon_settings.py b/openpype/settings/ayon_settings.py
index f23046e6c4..fbf35aec0a 100644
--- a/openpype/settings/ayon_settings.py
+++ b/openpype/settings/ayon_settings.py
@@ -753,7 +753,7 @@ def _convert_nuke_project_settings(ayon_settings, output):
     # settings for backwards compatibility
     deprecrated_review_settings = ayon_publish["ExtractReviewDataMov"]
     current_review_settings = (
-        ayon_publish["ExtractReviewDataBakingStreams"]
+        ayon_publish["ExtractReviewIntermediate"]
     )
     if deprecrated_review_settings["enabled"]:
         outputs_settings = deprecrated_review_settings["outputs"]
diff --git a/openpype/settings/defaults/project_settings/nuke.json b/openpype/settings/defaults/project_settings/nuke.json
index fac78dbcd5..7346c9d7b8 100644
--- a/openpype/settings/defaults/project_settings/nuke.json
+++ b/openpype/settings/defaults/project_settings/nuke.json
@@ -501,7 +501,7 @@
                 }
             }
         },
-        "ExtractReviewDataBakingStreams": {
+        "ExtractReviewIntermediate": {
             "enabled": true,
             "viewer_lut_raw": false,
             "outputs": {
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 0f366d55ba..c14f47a3a7 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
@@ -373,14 +373,14 @@
         },
         {
             "type": "label",
-            "label": "^ Settings and for <span style=\"color:#FF0000\";><b>ExtractReviewDataMov</b></span> is deprecated and will be soon removed.  <br> Please use <b>ExtractReviewDataBakingStreams</b> instead."
+            "label": "^ Settings and for <span style=\"color:#FF0000\";><b>ExtractReviewDataMov</b></span> is deprecated and will be soon removed.  <br> Please use <b>ExtractReviewIntermediate</b> instead."
         },
         {
             "type": "dict",
             "collapsible": true,
             "checkbox_key": "enabled",
-            "key": "ExtractReviewDataBakingStreams",
-            "label": "ExtractReviewDataBakingStreams",
+            "key": "ExtractReviewIntermediate",
+            "label": "ExtractReviewIntermediate",
             "is_group": true,
             "children": [
                 {
diff --git a/server_addon/nuke/server/settings/publish_plugins.py b/server_addon/nuke/server/settings/publish_plugins.py
index 6459dd7225..399aa7e38e 100644
--- a/server_addon/nuke/server/settings/publish_plugins.py
+++ b/server_addon/nuke/server/settings/publish_plugins.py
@@ -282,7 +282,7 @@ class PublishPuginsModel(BaseSettingsModel):
         title="Extract Review Data Mov",
         default_factory=ExtractReviewDataMovModel
     )
-    ExtractReviewDataBakingStreams: ExtractReviewBakingStreamsModel = Field(
+    ExtractReviewIntermediate: ExtractReviewBakingStreamsModel = Field(
         title="Extract Review Data Baking Streams",
         default_factory=ExtractReviewBakingStreamsModel
     )
@@ -481,7 +481,7 @@ DEFAULT_PUBLISH_PLUGIN_SETTINGS = {
             }
         ]
     },
-    "ExtractReviewDataBakingStreams": {
+    "ExtractReviewIntermediate": {
         "enabled": True,
         "viewer_lut_raw": False,
         "outputs": [
diff --git a/website/docs/project_settings/settings_project_global.md b/website/docs/project_settings/settings_project_global.md
index 8ecfe0c5da..3aa9772118 100644
--- a/website/docs/project_settings/settings_project_global.md
+++ b/website/docs/project_settings/settings_project_global.md
@@ -189,7 +189,7 @@ A profile may generate multiple outputs from a single input. Each output must de
     - Profile filtering defines which group of output definitions is used but output definitions may require more specific filters on their own.
     - They may filter by subset name (regex can be used) or publish families. Publish families are more complex as are based on knowing code base.
     - Filtering by custom tags -> this is used for targeting to output definitions from other extractors using settings (at this moment only Nuke bake extractor can target using custom tags).
-        - Nuke extractor settings path: `project_settings/nuke/publish/ExtractReviewDataBakingStreams/outputs/baking/add_custom_tags`
+        - Nuke extractor settings path: `project_settings/nuke/publish/ExtractReviewIntermediate/outputs/baking/add_custom_tags`
     - Filtering by input length. Input may be video, sequence or single image. It is possible that `.mp4` should be created only when input is video or sequence and to create review `.png` when input is single frame. In some cases the output should be created even if it's single frame or multi frame input.
 
 
diff --git a/website/docs/pype2/admin_presets_plugins.md b/website/docs/pype2/admin_presets_plugins.md
index a869ead819..a039c5fbd8 100644
--- a/website/docs/pype2/admin_presets_plugins.md
+++ b/website/docs/pype2/admin_presets_plugins.md
@@ -534,7 +534,7 @@ Plugin responsible for generating thumbnails with colorspace controlled by Nuke.
 }
 ```
 
-### `ExtractReviewDataBakingStreams`
+### `ExtractReviewIntermediate`
 `viewer_lut_raw` **true** will publish the baked mov file without any colorspace conversion. It will be baked with the workfile workspace. This can happen in case the Viewer input process uses baked screen space luts.
 
 #### baking with controlled colorspace

From ef12a5229dec982aa525f9fee2c29493263e0faf Mon Sep 17 00:00:00 2001
From: Kayla Man <moonyuet2008@hotmail.com>
Date: Thu, 28 Sep 2023 20:27:55 +0800
Subject: [PATCH 354/366] plural form for extract_review_intermediate

---
 ...king_streams.py => extract_review_intermediates.py} |  4 ++--
 openpype/settings/ayon_settings.py                     |  2 +-
 openpype/settings/defaults/project_settings/nuke.json  |  2 +-
 .../projects_schema/schemas/schema_nuke_publish.json   |  6 +++---
 server_addon/nuke/server/settings/publish_plugins.py   | 10 +++++-----
 .../docs/project_settings/settings_project_global.md   |  2 +-
 website/docs/pype2/admin_presets_plugins.md            |  2 +-
 7 files changed, 14 insertions(+), 14 deletions(-)
 rename openpype/hosts/nuke/plugins/publish/{extract_review_baking_streams.py => extract_review_intermediates.py} (99%)

diff --git a/openpype/hosts/nuke/plugins/publish/extract_review_baking_streams.py b/openpype/hosts/nuke/plugins/publish/extract_review_intermediates.py
similarity index 99%
rename from openpype/hosts/nuke/plugins/publish/extract_review_baking_streams.py
rename to openpype/hosts/nuke/plugins/publish/extract_review_intermediates.py
index 4407c039b4..2d996b1381 100644
--- a/openpype/hosts/nuke/plugins/publish/extract_review_baking_streams.py
+++ b/openpype/hosts/nuke/plugins/publish/extract_review_intermediates.py
@@ -8,7 +8,7 @@ from openpype.hosts.nuke.api import plugin
 from openpype.hosts.nuke.api.lib import maintained_selection
 
 
-class ExtractReviewIntermediate(publish.Extractor):
+class ExtractReviewIntermediates(publish.Extractor):
     """Extracts Sequences and thumbnail with baked in luts
 
     must be run after extract_render_local.py
@@ -32,7 +32,7 @@ class ExtractReviewIntermediate(publish.Extractor):
         """
         nuke_publish = project_settings["nuke"]["publish"]
         deprecated_setting = nuke_publish["ExtractReviewDataMov"]
-        current_setting = nuke_publish["ExtractReviewIntermediate"]
+        current_setting = nuke_publish["ExtractReviewIntermediates"]
         if deprecated_setting["enabled"]:
             # Use deprecated settings if they are still enabled
             cls.viewer_lut_raw = deprecated_setting["viewer_lut_raw"]
diff --git a/openpype/settings/ayon_settings.py b/openpype/settings/ayon_settings.py
index fbf35aec0a..68693bb953 100644
--- a/openpype/settings/ayon_settings.py
+++ b/openpype/settings/ayon_settings.py
@@ -753,7 +753,7 @@ def _convert_nuke_project_settings(ayon_settings, output):
     # settings for backwards compatibility
     deprecrated_review_settings = ayon_publish["ExtractReviewDataMov"]
     current_review_settings = (
-        ayon_publish["ExtractReviewIntermediate"]
+        ayon_publish["ExtractReviewIntermediates"]
     )
     if deprecrated_review_settings["enabled"]:
         outputs_settings = deprecrated_review_settings["outputs"]
diff --git a/openpype/settings/defaults/project_settings/nuke.json b/openpype/settings/defaults/project_settings/nuke.json
index 7346c9d7b8..ad9f46c8ab 100644
--- a/openpype/settings/defaults/project_settings/nuke.json
+++ b/openpype/settings/defaults/project_settings/nuke.json
@@ -501,7 +501,7 @@
                 }
             }
         },
-        "ExtractReviewIntermediate": {
+        "ExtractReviewIntermediates": {
             "enabled": true,
             "viewer_lut_raw": false,
             "outputs": {
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 c14f47a3a7..fa08e19c63 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
@@ -373,14 +373,14 @@
         },
         {
             "type": "label",
-            "label": "^ Settings and for <span style=\"color:#FF0000\";><b>ExtractReviewDataMov</b></span> is deprecated and will be soon removed.  <br> Please use <b>ExtractReviewIntermediate</b> instead."
+            "label": "^ Settings and for <span style=\"color:#FF0000\";><b>ExtractReviewDataMov</b></span> is deprecated and will be soon removed.  <br> Please use <b>ExtractReviewIntermediates</b> instead."
         },
         {
             "type": "dict",
             "collapsible": true,
             "checkbox_key": "enabled",
-            "key": "ExtractReviewIntermediate",
-            "label": "ExtractReviewIntermediate",
+            "key": "ExtractReviewIntermediates",
+            "label": "ExtractReviewIntermediates",
             "is_group": true,
             "children": [
                 {
diff --git a/server_addon/nuke/server/settings/publish_plugins.py b/server_addon/nuke/server/settings/publish_plugins.py
index 399aa7e38e..efb814eff0 100644
--- a/server_addon/nuke/server/settings/publish_plugins.py
+++ b/server_addon/nuke/server/settings/publish_plugins.py
@@ -177,7 +177,7 @@ class ExtractReviewDataMovModel(BaseSettingsModel):
     )
 
 
-class ExtractReviewBakingStreamsModel(BaseSettingsModel):
+class ExtractReviewIntermediatesModel(BaseSettingsModel):
     enabled: bool = Field(title="Enabled")
     viewer_lut_raw: bool = Field(title="Viewer lut raw")
     outputs: list[BakingStreamModel] = Field(
@@ -282,9 +282,9 @@ class PublishPuginsModel(BaseSettingsModel):
         title="Extract Review Data Mov",
         default_factory=ExtractReviewDataMovModel
     )
-    ExtractReviewIntermediate: ExtractReviewBakingStreamsModel = Field(
-        title="Extract Review Data Baking Streams",
-        default_factory=ExtractReviewBakingStreamsModel
+    ExtractReviewIntermediates: ExtractReviewIntermediatesModel = Field(
+        title="Extract Review Intermediates",
+        default_factory=ExtractReviewIntermediatesModel
     )
     ExtractSlateFrame: ExtractSlateFrameModel = Field(
         title="Extract Slate Frame",
@@ -481,7 +481,7 @@ DEFAULT_PUBLISH_PLUGIN_SETTINGS = {
             }
         ]
     },
-    "ExtractReviewIntermediate": {
+    "ExtractReviewIntermediates": {
         "enabled": True,
         "viewer_lut_raw": False,
         "outputs": [
diff --git a/website/docs/project_settings/settings_project_global.md b/website/docs/project_settings/settings_project_global.md
index 3aa9772118..27aa60a464 100644
--- a/website/docs/project_settings/settings_project_global.md
+++ b/website/docs/project_settings/settings_project_global.md
@@ -189,7 +189,7 @@ A profile may generate multiple outputs from a single input. Each output must de
     - Profile filtering defines which group of output definitions is used but output definitions may require more specific filters on their own.
     - They may filter by subset name (regex can be used) or publish families. Publish families are more complex as are based on knowing code base.
     - Filtering by custom tags -> this is used for targeting to output definitions from other extractors using settings (at this moment only Nuke bake extractor can target using custom tags).
-        - Nuke extractor settings path: `project_settings/nuke/publish/ExtractReviewIntermediate/outputs/baking/add_custom_tags`
+        - Nuke extractor settings path: `project_settings/nuke/publish/ExtractReviewIntermediates/outputs/baking/add_custom_tags`
     - Filtering by input length. Input may be video, sequence or single image. It is possible that `.mp4` should be created only when input is video or sequence and to create review `.png` when input is single frame. In some cases the output should be created even if it's single frame or multi frame input.
 
 
diff --git a/website/docs/pype2/admin_presets_plugins.md b/website/docs/pype2/admin_presets_plugins.md
index a039c5fbd8..b5e8a3b8a8 100644
--- a/website/docs/pype2/admin_presets_plugins.md
+++ b/website/docs/pype2/admin_presets_plugins.md
@@ -534,7 +534,7 @@ Plugin responsible for generating thumbnails with colorspace controlled by Nuke.
 }
 ```
 
-### `ExtractReviewIntermediate`
+### `ExtractReviewIntermediates`
 `viewer_lut_raw` **true** will publish the baked mov file without any colorspace conversion. It will be baked with the workfile workspace. This can happen in case the Viewer input process uses baked screen space luts.
 
 #### baking with controlled colorspace

From f45552ff79fcc72b38825886584b4cecf9160a43 Mon Sep 17 00:00:00 2001
From: Kayla Man <moonyuet2008@hotmail.com>
Date: Thu, 28 Sep 2023 20:29:09 +0800
Subject: [PATCH 355/366] label tweak

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

diff --git a/openpype/hosts/nuke/plugins/publish/extract_review_intermediates.py b/openpype/hosts/nuke/plugins/publish/extract_review_intermediates.py
index 2d996b1381..78fb37e8d7 100644
--- a/openpype/hosts/nuke/plugins/publish/extract_review_intermediates.py
+++ b/openpype/hosts/nuke/plugins/publish/extract_review_intermediates.py
@@ -16,7 +16,7 @@ class ExtractReviewIntermediates(publish.Extractor):
     """
 
     order = pyblish.api.ExtractorOrder + 0.01
-    label = "Extract Review Intermediate"
+    label = "Extract Review Intermediates"
 
     families = ["review"]
     hosts = ["nuke"]

From f57c1eb8889fea3b29a85ef0e425c909236dcc7a Mon Sep 17 00:00:00 2001
From: Kayla Man <moonyuet2008@hotmail.com>
Date: Thu, 28 Sep 2023 23:32:39 +0800
Subject: [PATCH 356/366] edit docsting and rename BakingStreamModel as
 IntermediateOutputModel

---
 .../nuke/plugins/publish/extract_review_intermediates.py    | 3 ++-
 server_addon/nuke/server/settings/publish_plugins.py        | 6 +++---
 2 files changed, 5 insertions(+), 4 deletions(-)

diff --git a/openpype/hosts/nuke/plugins/publish/extract_review_intermediates.py b/openpype/hosts/nuke/plugins/publish/extract_review_intermediates.py
index 78fb37e8d7..da060e3157 100644
--- a/openpype/hosts/nuke/plugins/publish/extract_review_intermediates.py
+++ b/openpype/hosts/nuke/plugins/publish/extract_review_intermediates.py
@@ -9,7 +9,8 @@ from openpype.hosts.nuke.api.lib import maintained_selection
 
 
 class ExtractReviewIntermediates(publish.Extractor):
-    """Extracts Sequences and thumbnail with baked in luts
+    """Extracting intermediate videos or sequences with
+    thumbnail for transcoding.
 
     must be run after extract_render_local.py
 
diff --git a/server_addon/nuke/server/settings/publish_plugins.py b/server_addon/nuke/server/settings/publish_plugins.py
index efb814eff0..19206149b6 100644
--- a/server_addon/nuke/server/settings/publish_plugins.py
+++ b/server_addon/nuke/server/settings/publish_plugins.py
@@ -149,7 +149,7 @@ class ReformatNodesConfigModel(BaseSettingsModel):
     )
 
 
-class BakingStreamModel(BaseSettingsModel):
+class IntermediateOutputModel(BaseSettingsModel):
     name: str = Field(title="Output name")
     filter: BakingStreamFilterModel = Field(
         title="Filter", default_factory=BakingStreamFilterModel)
@@ -171,7 +171,7 @@ class ExtractReviewDataMovModel(BaseSettingsModel):
     """
     enabled: bool = Field(title="Enabled")
     viewer_lut_raw: bool = Field(title="Viewer lut raw")
-    outputs: list[BakingStreamModel] = Field(
+    outputs: list[IntermediateOutputModel] = Field(
         default_factory=list,
         title="Baking streams"
     )
@@ -180,7 +180,7 @@ class ExtractReviewDataMovModel(BaseSettingsModel):
 class ExtractReviewIntermediatesModel(BaseSettingsModel):
     enabled: bool = Field(title="Enabled")
     viewer_lut_raw: bool = Field(title="Viewer lut raw")
-    outputs: list[BakingStreamModel] = Field(
+    outputs: list[IntermediateOutputModel] = Field(
         default_factory=list,
         title="Baking streams"
     )

From a66edaf1d051be4c6be2cfe189fe7a5912296968 Mon Sep 17 00:00:00 2001
From: Petr Kalis <petr.kalis@gmail.com>
Date: Fri, 29 Sep 2023 17:33:28 +0200
Subject: [PATCH 357/366] Maya: implement matchmove publishing (#5445)

* OP-6360 - allow export of multiple cameras as alembic

* OP-6360 - make validation of camera count optional

* OP-6360 - make ValidatorCameraContents optional

This validator checks number of cameras, without optionality publish wouldn't be possible.

* OP-6360 - allow extraction of multiple cameras to .ma

* OP-6360 - update defaults for Ayon

Changes to Ayon settings should also bump up version of addon.

* OP-6360 - new matchmove creator

This family should be for more complex sets (eg. multiple cameras, with geometry, planes etc.

* OP-6360 - updated camera extractors

Added matchmove family to extract multiple cameras.
Single camera is protected by required validator.

* OP-6360 - added matchmove to reference loader

* Revert "OP-6360 - make ValidatorCameraContents optional"

This reverts commit 4096e81f785b1299b54b1e485eb672403fb89a66.

* Revert "OP-6360 - update defaults for Ayon"

This reverts commit 4391b25cfc93fbb783146a726c6097477146c467.

* OP-6360 - performance update

Number of cameras might be quite large, set operations will be faster than loop.

* Revert "OP-6360 - make validation of camera count optional"

This reverts commit ee3d91a4cbec607b0f8cc9d47382684eba88d6d0.

* OP-6360 - explicitly cast to list for Maya functions

cmds.ls doesn't like sets in some older versions of Maya apparently. Sets are used here for performance reason, so explicitly cast them to list to make Maya happy.

* OP-6360 - added documentation about matchmove family

* OP-6360 - copy input planes

* OP-6360 - expose Settings to keep Image planes

Previous implementation didn't export Image planes in Maya file, to keep behavior backward compatible new Setting was added and set to False.

* OP-6360 - make both camera extractors optional

In Settings Alembic extractor was visible as optional even if code didn't follow that.

* OP-6360 - used long name

* OP-6360 - fix wrong variable

* Update openpype/hosts/maya/plugins/publish/extract_camera_mayaScene.py

Co-authored-by: Roy Nieterau <roy_nieterau@hotmail.com>

* OP-6360 - removed shortening of varible

* OP-6360 - Hound

* OP-6360 - fix wrong key

* Update openpype/hosts/maya/plugins/publish/extract_camera_mayaScene.py

Co-authored-by: Toke Jepsen <tokejepsen@gmail.com>

* Update openpype/hosts/maya/api/lib.py

Co-authored-by: Toke Jepsen <tokejepsen@gmail.com>

* Update openpype/hosts/maya/plugins/publish/extract_camera_alembic.py

Co-authored-by: Toke Jepsen <tokejepsen@gmail.com>

* OP-6360 - fix wrong variable

* OP-6360 - added reattaching method

Image planes were attached wrong, added method to reattach them properly.

* Revert "Update openpype/hosts/maya/api/lib.py"

This reverts commit 4f40ad613946903e8c51b2720ac52756e701f8b8.

* OP-6360 - exported baked camera should be deleted

Forgotten commenting just for development.

* OP-6360 - updated docstring

* OP-6360 - remove scale keys

Currently parentConstraint from old camera to new one doesn't work for keyed scale attributes. To key scale attributes doesn't make much sense so as a workaround, keys for scale attributes are checked AND if they are diferent from defaults (1.0) publish fails (as artist might want to actually key scale). If all scale keys are defaults, they are temporarily removed, cameras are parent constrained, exported and old camera returned to original state.

* OP-6360 - cleaned up resetting of scale keys

Batch calls used instead of one by one.
Cleaned up a return type as key value is no necessary as we are not setting it, just key.

* OP-6360 - removed unnecessary logging

* OP-6360 - reattach image plane to original camera

Image plane must be reattached before baked camera(s) are deleted.

* OP-6360 - added context manager to keep image planes attached to original camera

Without this image planes would disappear after removal of baked cameras.

* OP-6360 - refactored contextmanager

* OP-6360 - renamed flag

Input connections are not copied anymore as they might be dangerous. It is possible to epxlicitly attach only image planes instead.

* OP-6360 - removed copyInputConnections

Copying input connections might be dangerous (rig etc.), it is possible to explicitly attach only image planes.

* OP-6360 - updated plugin labels

* Update openpype/hosts/maya/plugins/create/create_matchmove.py

Co-authored-by: Roy Nieterau <roy_nieterau@hotmail.com>

* OP-6360 - fixed formatting

---------

Co-authored-by: Roy Nieterau <roy_nieterau@hotmail.com>
Co-authored-by: Toke Jepsen <tokejepsen@gmail.com>
---
 openpype/hosts/maya/api/lib.py                |   2 +-
 .../maya/plugins/create/create_matchmove.py   |  32 ++++
 .../hosts/maya/plugins/load/load_reference.py |   3 +-
 .../plugins/publish/extract_camera_alembic.py |  22 ++-
 .../publish/extract_camera_mayaScene.py       | 142 ++++++++++++++----
 .../defaults/project_settings/maya.json       |   6 +
 .../schemas/schema_maya_publish.json          |  29 ++++
 website/docs/artist_publish.md                |  70 ++++-----
 8 files changed, 229 insertions(+), 77 deletions(-)
 create mode 100644 openpype/hosts/maya/plugins/create/create_matchmove.py

diff --git a/openpype/hosts/maya/api/lib.py b/openpype/hosts/maya/api/lib.py
index 40b3419e73..a197e5b592 100644
--- a/openpype/hosts/maya/api/lib.py
+++ b/openpype/hosts/maya/api/lib.py
@@ -2571,7 +2571,7 @@ def bake_to_world_space(nodes,
             new_name = "{0}_baked".format(short_name)
             new_node = cmds.duplicate(node,
                                       name=new_name,
-                                      renameChildren=True)[0]
+                                      renameChildren=True)[0]  # noqa
 
             # Connect all attributes on the node except for transform
             # attributes
diff --git a/openpype/hosts/maya/plugins/create/create_matchmove.py b/openpype/hosts/maya/plugins/create/create_matchmove.py
new file mode 100644
index 0000000000..e64eb6a471
--- /dev/null
+++ b/openpype/hosts/maya/plugins/create/create_matchmove.py
@@ -0,0 +1,32 @@
+from openpype.hosts.maya.api import (
+    lib,
+    plugin
+)
+from openpype.lib import BoolDef
+
+
+class CreateMatchmove(plugin.MayaCreator):
+    """Instance for more complex setup of cameras.
+
+    Might contain multiple cameras, geometries etc.
+
+    It is expected to be extracted into .abc or .ma
+    """
+
+    identifier = "io.openpype.creators.maya.matchmove"
+    label = "Matchmove"
+    family = "matchmove"
+    icon = "video-camera"
+
+    def get_instance_attr_defs(self):
+
+        defs = lib.collect_animation_defs()
+
+        defs.extend([
+            BoolDef("bakeToWorldSpace",
+                    label="Bake Cameras to World-Space",
+                    tooltip="Bake Cameras to World-Space",
+                    default=True),
+        ])
+
+        return defs
diff --git a/openpype/hosts/maya/plugins/load/load_reference.py b/openpype/hosts/maya/plugins/load/load_reference.py
index 61f337f501..4b704fa706 100644
--- a/openpype/hosts/maya/plugins/load/load_reference.py
+++ b/openpype/hosts/maya/plugins/load/load_reference.py
@@ -101,7 +101,8 @@ class ReferenceLoader(openpype.hosts.maya.api.plugin.ReferenceLoader):
                 "camerarig",
                 "staticMesh",
                 "skeletalMesh",
-                "mvLook"]
+                "mvLook",
+                "matchmove"]
 
     representations = ["ma", "abc", "fbx", "mb"]
 
diff --git a/openpype/hosts/maya/plugins/publish/extract_camera_alembic.py b/openpype/hosts/maya/plugins/publish/extract_camera_alembic.py
index 4ec1399df4..43803743bc 100644
--- a/openpype/hosts/maya/plugins/publish/extract_camera_alembic.py
+++ b/openpype/hosts/maya/plugins/publish/extract_camera_alembic.py
@@ -6,17 +6,21 @@ from openpype.pipeline import publish
 from openpype.hosts.maya.api import lib
 
 
-class ExtractCameraAlembic(publish.Extractor):
+class ExtractCameraAlembic(publish.Extractor,
+                           publish.OptionalPyblishPluginMixin):
     """Extract a Camera as Alembic.
 
-    The cameras gets baked to world space by default. Only when the instance's
+    The camera gets baked to world space by default. Only when the instance's
     `bakeToWorldSpace` is set to False it will include its full hierarchy.
 
+    'camera' family expects only single camera, if multiple cameras are needed,
+    'matchmove' is better choice.
+
     """
 
-    label = "Camera (Alembic)"
+    label = "Extract Camera (Alembic)"
     hosts = ["maya"]
-    families = ["camera"]
+    families = ["camera", "matchmove"]
     bake_attributes = []
 
     def process(self, instance):
@@ -35,10 +39,11 @@ class ExtractCameraAlembic(publish.Extractor):
 
         # validate required settings
         assert isinstance(step, float), "Step must be a float value"
-        camera = cameras[0]
 
         # Define extract output file path
         dir_path = self.staging_dir(instance)
+        if not os.path.exists(dir_path):
+            os.makedirs(dir_path)
         filename = "{0}.abc".format(instance.name)
         path = os.path.join(dir_path, filename)
 
@@ -64,9 +69,10 @@ class ExtractCameraAlembic(publish.Extractor):
 
                 # 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)
+                camera_roots = cmds.listRelatives(
+                    cameras, parent=True, fullPath=True)
+                for camera_root in camera_roots:
+                    job_str += ' -root {0}'.format(camera_root)
 
                 for member in members:
                     descendants = cmds.listRelatives(member,
diff --git a/openpype/hosts/maya/plugins/publish/extract_camera_mayaScene.py b/openpype/hosts/maya/plugins/publish/extract_camera_mayaScene.py
index a50a8f0dfa..38cf00bbdd 100644
--- a/openpype/hosts/maya/plugins/publish/extract_camera_mayaScene.py
+++ b/openpype/hosts/maya/plugins/publish/extract_camera_mayaScene.py
@@ -2,11 +2,15 @@
 """Extract camera as Maya Scene."""
 import os
 import itertools
+import contextlib
 
 from maya import cmds
 
 from openpype.pipeline import publish
 from openpype.hosts.maya.api import lib
+from openpype.lib import (
+    BoolDef
+)
 
 
 def massage_ma_file(path):
@@ -78,7 +82,8 @@ def unlock(plug):
             cmds.disconnectAttr(source, destination)
 
 
-class ExtractCameraMayaScene(publish.Extractor):
+class ExtractCameraMayaScene(publish.Extractor,
+                             publish.OptionalPyblishPluginMixin):
     """Extract a Camera as Maya Scene.
 
     This will create a duplicate of the camera that will be baked *with*
@@ -88,17 +93,22 @@ class ExtractCameraMayaScene(publish.Extractor):
     The cameras gets baked to world space by default. Only when the instance's
     `bakeToWorldSpace` is set to False it will include its full hierarchy.
 
+    'camera' family expects only single camera, if multiple cameras are needed,
+    'matchmove' is better choice.
+
     Note:
         The extracted Maya ascii file gets "massaged" removing the uuid values
         so they are valid for older versions of Fusion (e.g. 6.4)
 
     """
 
-    label = "Camera (Maya Scene)"
+    label = "Extract Camera (Maya Scene)"
     hosts = ["maya"]
-    families = ["camera"]
+    families = ["camera", "matchmove"]
     scene_type = "ma"
 
+    keep_image_planes = True
+
     def process(self, instance):
         """Plugin entry point."""
         # get settings
@@ -131,15 +141,15 @@ class ExtractCameraMayaScene(publish.Extractor):
                              "bake to world space is ignored...")
 
         # get cameras
-        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")
+        members = set(cmds.ls(instance.data['setMembers'], leaf=True,
+                      shapes=True, long=True, dag=True))
+        cameras = set(cmds.ls(members, leaf=True, shapes=True, long=True,
+                      dag=True, type="camera"))
 
         # validate required settings
         assert isinstance(step, float), "Step must be a float value"
-        camera = cameras[0]
-        transform = cmds.listRelatives(camera, parent=True, fullPath=True)
+        transforms = cmds.listRelatives(list(cameras),
+                                        parent=True, fullPath=True)
 
         # Define extract output file path
         dir_path = self.staging_dir(instance)
@@ -151,23 +161,21 @@ class ExtractCameraMayaScene(publish.Extractor):
             with lib.evaluation("off"):
                 with lib.suspended_refresh():
                     if bake_to_worldspace:
-                        self.log.debug(
-                            "Performing camera bakes: {}".format(transform))
                         baked = lib.bake_to_world_space(
-                            transform,
+                            transforms,
                             frame_range=[start, end],
                             step=step
                         )
-                        baked_camera_shapes = cmds.ls(baked,
-                                               type="camera",
-                                               dag=True,
-                                               shapes=True,
-                                               long=True)
+                        baked_camera_shapes = set(cmds.ls(baked,
+                                                  type="camera",
+                                                  dag=True,
+                                                  shapes=True,
+                                                  long=True))
 
-                        members = members + baked_camera_shapes
-                        members.remove(camera)
+                        members.update(baked_camera_shapes)
+                        members.difference_update(cameras)
                     else:
-                        baked_camera_shapes = cmds.ls(cameras,
+                        baked_camera_shapes = cmds.ls(list(cameras),
                                                       type="camera",
                                                       dag=True,
                                                       shapes=True,
@@ -186,19 +194,28 @@ class ExtractCameraMayaScene(publish.Extractor):
                         unlock(plug)
                         cmds.setAttr(plug, value)
 
-                    self.log.debug("Performing extraction..")
-                    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
-                              exportSelected=True,
-                              preserveReferences=False,
-                              constructionHistory=False,
-                              channels=True,  # allow animation
-                              constraints=False,
-                              shader=False,
-                              expressions=False)
+                    attr_values = self.get_attr_values_from_data(
+                        instance.data)
+                    keep_image_planes = attr_values.get("keep_image_planes")
+
+                    with transfer_image_planes(sorted(cameras),
+                                               sorted(baked_camera_shapes),
+                                               keep_image_planes):
+
+                        self.log.info("Performing extraction..")
+                        cmds.select(cmds.ls(list(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
+                                  exportSelected=True,
+                                  preserveReferences=False,
+                                  constructionHistory=False,
+                                  channels=True,  # allow animation
+                                  constraints=False,
+                                  shader=False,
+                                  expressions=False)
 
                     # Delete the baked hierarchy
                     if bake_to_worldspace:
@@ -219,3 +236,62 @@ class ExtractCameraMayaScene(publish.Extractor):
 
         self.log.debug("Extracted instance '{0}' to: {1}".format(
             instance.name, path))
+
+    @classmethod
+    def get_attribute_defs(cls):
+        defs = super(ExtractCameraMayaScene, cls).get_attribute_defs()
+
+        defs.extend([
+            BoolDef("keep_image_planes",
+                    label="Keep Image Planes",
+                    tooltip="Preserving connected image planes on camera",
+                    default=cls.keep_image_planes),
+
+        ])
+
+        return defs
+
+
+@contextlib.contextmanager
+def transfer_image_planes(source_cameras, target_cameras,
+                          keep_input_connections):
+    """Reattaches image planes to baked or original cameras.
+
+    Baked cameras are duplicates of original ones.
+    This attaches it to duplicated camera properly and after
+    export it reattaches it back to original to keep image plane in workfile.
+    """
+    originals = {}
+    try:
+        for source_camera, target_camera in zip(source_cameras,
+                                                target_cameras):
+            image_planes = cmds.listConnections(source_camera,
+                                                type="imagePlane") or []
+
+            # Split of the parent path they are attached - we want
+            # the image plane node name.
+            # TODO: Does this still mean the image plane name is unique?
+            image_planes = [x.split("->", 1)[1] for x in image_planes]
+
+            if not image_planes:
+                continue
+
+            originals[source_camera] = []
+            for image_plane in image_planes:
+                if keep_input_connections:
+                    if source_camera == target_camera:
+                        continue
+                    _attach_image_plane(target_camera, image_plane)
+                else:  # explicitly dettaching image planes
+                    cmds.imagePlane(image_plane, edit=True, detach=True)
+                originals[source_camera].append(image_plane)
+        yield
+    finally:
+        for camera, image_planes in originals.items():
+            for image_plane in image_planes:
+                _attach_image_plane(camera, image_plane)
+
+
+def _attach_image_plane(camera, image_plane):
+    cmds.imagePlane(image_plane, edit=True, detach=True)
+    cmds.imagePlane(image_plane, edit=True, camera=camera)
diff --git a/openpype/settings/defaults/project_settings/maya.json b/openpype/settings/defaults/project_settings/maya.json
index 38f14ec022..83ca6fecef 100644
--- a/openpype/settings/defaults/project_settings/maya.json
+++ b/openpype/settings/defaults/project_settings/maya.json
@@ -1338,6 +1338,12 @@
             "active": true,
             "bake_attributes": []
         },
+        "ExtractCameraMayaScene": {
+            "enabled": true,
+            "optional": true,
+            "active": true,
+            "keep_image_planes": false
+        },
         "ExtractGLB": {
             "enabled": true,
             "active": 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 b115ee3faa..13c00ff183 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
@@ -978,6 +978,35 @@
                 }
             ]
         },
+        {
+            "type": "dict",
+            "collapsible": true,
+            "key": "ExtractCameraMayaScene",
+            "label": "Extract camera to Maya scene",
+            "checkbox_key": "enabled",
+            "children": [
+                {
+                    "type": "boolean",
+                    "key": "enabled",
+                    "label": "Enabled"
+                },
+                {
+                    "type": "boolean",
+                    "key": "optional",
+                    "label": "Optional"
+                },
+                {
+                    "type": "boolean",
+                    "key": "active",
+                    "label": "Active"
+                },
+                {
+                    "type": "boolean",
+                    "key": "keep_image_planes",
+                    "label": "Export Image planes"
+                }
+            ]
+        },
         {
             "type": "dict",
             "collapsible": true,
diff --git a/website/docs/artist_publish.md b/website/docs/artist_publish.md
index 321eb5c56a..b1be2e629e 100644
--- a/website/docs/artist_publish.md
+++ b/website/docs/artist_publish.md
@@ -33,39 +33,41 @@ The Instances are categorized into ‘families’ based on what type of data the
 Following family definitions and requirements are OpenPype defaults and what we consider good industry practice, but most of the requirements can be easily altered to suit the studio or project needs.
 Here's a list of supported families
 
-| Family                  | Comment                                          | Example Subsets           |
-| ----------------------- | ------------------------------------------------ | ------------------------- |
-| [Model](#model)         | Cleaned geo without materials                    | main, proxy, broken       |
-| [Look](#look)           | Package of shaders, assignments and textures     | main, wet, dirty          |
-| [Rig](#rig)             | Characters or props with animation controls      | main, deform, sim         |
-| [Assembly](#assembly)   | A complex model made from multiple other models. | main, deform, sim         |
-| [Layout](#layout)       | Simple representation of the environment         | main,                     |
-| [Setdress](#setdress)   | Environment containing only referenced assets    | main,                     |
-| [Camera](#camera)       | May contain trackers or proxy geo                | main, tracked, anim       |
-| [Animation](#animation) | Animation exported from a rig.                   | characterA, vehicleB      |
-| [Cache](#cache)         | Arbitrary animated geometry or fx cache          | rest, ROM , pose01        |
-| MayaAscii               | Maya publishes that don't fit other categories   |                           |
-| [Render](#render)       | Rendered frames from CG or Comp                  |                           |
-| RenderSetup             | Scene render settings, AOVs and layers           |                           |
-| Plate                   | Ingested, transcode, conformed footage           | raw, graded, imageplane   |
-| Write                   | Nuke write nodes for rendering                   |                           |
-| Image                   | Any non-plate image to be used by artists        | Reference, ConceptArt     |
-| LayeredImage            | Software agnostic layered image with metadata    | Reference, ConceptArt     |
-| Review                  | Reviewable video or image.                       |                           |
-| Matchmove               | Matchmoved camera, potentially with geometry     | main                      |
-| Workfile                | Backup of the workfile with all its content      | uses the task name        |
-| Nukenodes               | Any collection of nuke nodes                     | maskSetup, usefulBackdrop |
-| Yeticache               | Cached out yeti fur setup                        |                           |
-| YetiRig                 | Yeti groom ready to be applied to geometry cache | main, destroyed           |
-| VrayProxy               | Vray proxy geometry for rendering                |                           |
-| VrayScene               | Vray full scene export                           |                           |
-| ArnodldStandin          | All arnold .ass archives for rendering           | main, wet, dirty          |
-| LUT                     |                                                  |                           |
-| Nukenodes               |                                                  |                           |
-| Gizmo                   |                                                  |                           |
-| Nukenodes               |                                                  |                           |
-| Harmony.template        |                                                  |                           |
-| Harmony.palette        |                                                  |                           |
+| Family                  | Comment                                               | Example Subsets           |
+|-------------------------|-------------------------------------------------------| ------------------------- |
+| [Model](#model)         | Cleaned geo without materials                         | main, proxy, broken       |
+| [Look](#look)           | Package of shaders, assignments and textures          | main, wet, dirty          |
+| [Rig](#rig)             | Characters or props with animation controls           | main, deform, sim         |
+| [Assembly](#assembly)   | A complex model made from multiple other models.      | main, deform, sim         |
+| [Layout](#layout)       | Simple representation of the environment              | main,                     |
+| [Setdress](#setdress)   | Environment containing only referenced assets         | main,                     |
+| [Camera](#camera)       | May contain trackers or proxy geo, only single camera | main, tracked, anim       |
+|                         | expected.                                             |                           |
+| [Animation](#animation) | Animation exported from a rig.                        | characterA, vehicleB      |
+| [Cache](#cache)         | Arbitrary animated geometry or fx cache               | rest, ROM , pose01        |
+| MayaAscii               | Maya publishes that don't fit other categories        |                           |
+| [Render](#render)       | Rendered frames from CG or Comp                       |                           |
+| RenderSetup             | Scene render settings, AOVs and layers                |                           |
+| Plate                   | Ingested, transcode, conformed footage                | raw, graded, imageplane   |
+| Write                   | Nuke write nodes for rendering                        |                           |
+| Image                   | Any non-plate image to be used by artists             | Reference, ConceptArt     |
+| LayeredImage            | Software agnostic layered image with metadata         | Reference, ConceptArt     |
+| Review                  | Reviewable video or image.                            |                           |
+| Matchmove               | Matchmoved camera, potentially with geometry, allows  | main                      |
+|                         | multiple cameras even with planes.                    |                           |
+| Workfile                | Backup of the workfile with all its content           | uses the task name        |
+| Nukenodes               | Any collection of nuke nodes                          | maskSetup, usefulBackdrop |
+| Yeticache               | Cached out yeti fur setup                             |                           |
+| YetiRig                 | Yeti groom ready to be applied to geometry cache      | main, destroyed           |
+| VrayProxy               | Vray proxy geometry for rendering                     |                           |
+| VrayScene               | Vray full scene export                                |                           |
+| ArnodldStandin          | All arnold .ass archives for rendering                | main, wet, dirty          |
+| LUT                     |                                                       |                           |
+| Nukenodes               |                                                       |                           |
+| Gizmo                   |                                                       |                           |
+| Nukenodes               |                                                       |                           |
+| Harmony.template        |                                                       |                           |
+| Harmony.palette         |                                                       |                           |
 
 
 
@@ -161,7 +163,7 @@ Example Representations:
 ### Animation
 
 Published result of an animation created with a rig. Animation can be extracted
-as animation curves, cached out geometry or even fully animated rig with all the controllers.  
+as animation curves, cached out geometry or even fully animated rig with all the controllers.
 Animation cache is usually defined by a rigger in the rig file of a character or
 by FX TD in the effects rig, to ensure consistency of outputs.
 

From 8520a91cc8a3b7b18a2c63f09fc2b21cdd5599e9 Mon Sep 17 00:00:00 2001
From: Ynbot <bot@ynput.io>
Date: Sat, 30 Sep 2023 03:24:20 +0000
Subject: [PATCH 358/366] [Automated] Bump version

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

diff --git a/openpype/version.py b/openpype/version.py
index f1e0cd0b80..8234258f19 100644
--- a/openpype/version.py
+++ b/openpype/version.py
@@ -1,3 +1,3 @@
 # -*- coding: utf-8 -*-
 """Package declaring Pype version."""
-__version__ = "3.17.1"
+__version__ = "3.17.2-nightly.1"

From f113ddb4eda84a8e112059edfce596327c6cf826 Mon Sep 17 00:00:00 2001
From: "github-actions[bot]" <github-actions[bot]@users.noreply.github.com>
Date: Sat, 30 Sep 2023 03:24:56 +0000
Subject: [PATCH 359/366] chore(): update bug report / version

---
 .github/ISSUE_TEMPLATE/bug_report.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/ISSUE_TEMPLATE/bug_report.yml b/.github/ISSUE_TEMPLATE/bug_report.yml
index 591d865ca5..9fb7bbc66c 100644
--- a/.github/ISSUE_TEMPLATE/bug_report.yml
+++ b/.github/ISSUE_TEMPLATE/bug_report.yml
@@ -35,6 +35,7 @@ body:
       label: Version
       description: What version are you running? Look to OpenPype Tray
       options:
+        - 3.17.2-nightly.1
         - 3.17.1
         - 3.17.1-nightly.3
         - 3.17.1-nightly.2
@@ -134,7 +135,6 @@ body:
         - 3.14.10-nightly.8
         - 3.14.10-nightly.7
         - 3.14.10-nightly.6
-        - 3.14.10-nightly.5
     validations:
       required: true
   - type: dropdown

From 7f5879b0e8d12761add2ea5ec527259c462b567e Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Sun, 1 Oct 2023 22:46:16 +0200
Subject: [PATCH 360/366] Avoid memory leak - actually clear stored plugins on
 reset

---
 openpype/tools/publisher/control.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/openpype/tools/publisher/control.py b/openpype/tools/publisher/control.py
index d4e0ae0453..677c1da51a 100644
--- a/openpype/tools/publisher/control.py
+++ b/openpype/tools/publisher/control.py
@@ -194,6 +194,7 @@ class PublishReportMaker:
         self._publish_discover_result = create_context.publish_discover_result
         self._plugin_data = []
         self._plugin_data_with_plugin = []
+        self._stored_plugins = []
         self._current_plugin_data = {}
         self._all_instances_by_id = {}
         self._current_context = context

From 52965a827597532c7f11eee3592e51fd8473f650 Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Sun, 1 Oct 2023 22:46:51 +0200
Subject: [PATCH 361/366] Use `set` since it's supposed to be unique entries
 and is used in many lookups

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

diff --git a/openpype/tools/publisher/control.py b/openpype/tools/publisher/control.py
index 677c1da51a..e6b68906fd 100644
--- a/openpype/tools/publisher/control.py
+++ b/openpype/tools/publisher/control.py
@@ -179,7 +179,7 @@ class PublishReportMaker:
         self._plugin_data = []
         self._plugin_data_with_plugin = []
 
-        self._stored_plugins = []
+        self._stored_plugins = set()
         self._current_plugin_data = []
         self._all_instances_by_id = {}
         self._current_context = None
@@ -194,7 +194,7 @@ class PublishReportMaker:
         self._publish_discover_result = create_context.publish_discover_result
         self._plugin_data = []
         self._plugin_data_with_plugin = []
-        self._stored_plugins = []
+        self._stored_plugins = set()
         self._current_plugin_data = {}
         self._all_instances_by_id = {}
         self._current_context = context
@@ -230,7 +230,7 @@ class PublishReportMaker:
             raise ValueError(
                 "Plugin '{}' is already stored".format(str(plugin)))
 
-        self._stored_plugins.append(plugin)
+        self._stored_plugins.add(plugin)
 
         plugin_data_item = self._create_plugin_data_item(plugin)
 

From 6b3aa6a247c895507771d414c653757634628727 Mon Sep 17 00:00:00 2001
From: Simone Barbieri <simone.barbieri@hey.com>
Date: Mon, 2 Oct 2023 12:45:18 +0100
Subject: [PATCH 362/366] Added Cycles render passes

---
 openpype/hosts/blender/api/render_lib.py                  | 8 +++++++-
 .../schemas/projects_schema/schema_project_blender.json   | 5 ++++-
 server_addon/blender/server/settings/render_settings.py   | 5 ++++-
 server_addon/blender/server/version.py                    | 2 +-
 4 files changed, 16 insertions(+), 4 deletions(-)

diff --git a/openpype/hosts/blender/api/render_lib.py b/openpype/hosts/blender/api/render_lib.py
index 43560ee6d5..d564b5ebcb 100644
--- a/openpype/hosts/blender/api/render_lib.py
+++ b/openpype/hosts/blender/api/render_lib.py
@@ -116,6 +116,12 @@ def set_render_passes(settings):
     vl.use_pass_shadow = "shadow" in aov_list
     vl.use_pass_ambient_occlusion = "ao" in aov_list
 
+    cycles = vl.cycles
+
+    cycles.denoising_store_passes = "denoising" in aov_list
+    cycles.use_pass_volume_direct = "volume_direct" in aov_list
+    cycles.use_pass_volume_indirect = "volume_indirect" in aov_list
+
     aovs_names = [aov.name for aov in vl.aovs]
     for cp in custom_passes:
         cp_name = cp[0]
@@ -149,7 +155,7 @@ def set_node_tree(output_path, name, aov_sep, ext, multilayer):
     # Get the enabled output sockets, that are the active passes for the
     # render.
     # We also exclude some layers.
-    exclude_sockets = ["Image", "Alpha"]
+    exclude_sockets = ["Image", "Alpha", "Noisy Image"]
     passes = [
         socket
         for socket in rl_node.outputs
diff --git a/openpype/settings/entities/schemas/projects_schema/schema_project_blender.json b/openpype/settings/entities/schemas/projects_schema/schema_project_blender.json
index 4c9405fcd3..535d9434a3 100644
--- a/openpype/settings/entities/schemas/projects_schema/schema_project_blender.json
+++ b/openpype/settings/entities/schemas/projects_schema/schema_project_blender.json
@@ -123,7 +123,10 @@
                         {"emission": "Emission"},
                         {"environment": "Environment"},
                         {"shadow": "Shadow"},
-                        {"ao": "Ambient Occlusion"}
+                        {"ao": "Ambient Occlusion"},
+                        {"denoising": "Denoising"},
+                        {"volume_direct": "Direct Volumetric Scattering"},
+                        {"volume_indirect": "Indirect Volumetric Scattering"}
                     ]
                 },
                 {
diff --git a/server_addon/blender/server/settings/render_settings.py b/server_addon/blender/server/settings/render_settings.py
index 7a47095d3c..f62013982e 100644
--- a/server_addon/blender/server/settings/render_settings.py
+++ b/server_addon/blender/server/settings/render_settings.py
@@ -40,7 +40,10 @@ def aov_list_enum():
         {"value": "emission", "label": "Emission"},
         {"value": "environment", "label": "Environment"},
         {"value": "shadow", "label": "Shadow"},
-        {"value": "ao", "label": "Ambient Occlusion"}
+        {"value": "ao", "label": "Ambient Occlusion"},
+        {"value": "denoising", "label": "Denoising"},
+        {"value": "volume_direct", "label": "Direct Volumetric Scattering"},
+        {"value": "volume_indirect", "label": "Indirect Volumetric Scattering"}
     ]
 
 
diff --git a/server_addon/blender/server/version.py b/server_addon/blender/server/version.py
index b3f4756216..ae7362549b 100644
--- a/server_addon/blender/server/version.py
+++ b/server_addon/blender/server/version.py
@@ -1 +1 @@
-__version__ = "0.1.2"
+__version__ = "0.1.3"

From 8e1f3beff6e68ec0111ec68754050dc9768754ab Mon Sep 17 00:00:00 2001
From: Simone Barbieri <simone.barbieri@hey.com>
Date: Mon, 2 Oct 2023 12:45:50 +0100
Subject: [PATCH 363/366] Fixed render job environment variables

---
 .../modules/deadline/plugins/publish/submit_blender_deadline.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/openpype/modules/deadline/plugins/publish/submit_blender_deadline.py b/openpype/modules/deadline/plugins/publish/submit_blender_deadline.py
index 307fc8b5a2..4a7497b075 100644
--- a/openpype/modules/deadline/plugins/publish/submit_blender_deadline.py
+++ b/openpype/modules/deadline/plugins/publish/submit_blender_deadline.py
@@ -123,7 +123,7 @@ class BlenderSubmitDeadline(abstract_submit_deadline.AbstractSubmitDeadline):
             job_info.EnvironmentKeyValue[key] = value
 
         # to recognize job from PYPE for turning Event On/Off
-        job_info.EnvironmentKeyValue["OPENPYPE_RENDER_JOB"] = "1"
+        job_info.add_render_job_env_var()
         job_info.EnvironmentKeyValue["OPENPYPE_LOG_NO_COLORS"] = "1"
 
         # Adding file dependencies.

From 35b3006f29f0c5c197abb2f010a6e51f6d214c95 Mon Sep 17 00:00:00 2001
From: Simone Barbieri <simone.barbieri@hey.com>
Date: Mon, 2 Oct 2023 15:34:48 +0100
Subject: [PATCH 364/366] Improved naming for RenderProduct

---
 openpype/hosts/blender/api/colorspace.py | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/openpype/hosts/blender/api/colorspace.py b/openpype/hosts/blender/api/colorspace.py
index 0f504a3be0..4521612b7d 100644
--- a/openpype/hosts/blender/api/colorspace.py
+++ b/openpype/hosts/blender/api/colorspace.py
@@ -22,12 +22,11 @@ class RenderProduct(object):
 
 
 class ARenderProduct(object):
-
     def __init__(self):
         """Constructor."""
         # Initialize
         self.layer_data = self._get_layer_data()
-        self.layer_data.products = self.get_colorspace_data()
+        self.layer_data.products = self.get_render_products()
 
     def _get_layer_data(self):
         scene = bpy.context.scene
@@ -37,7 +36,7 @@ class ARenderProduct(object):
             frameEnd=int(scene.frame_end),
         )
 
-    def get_colorspace_data(self):
+    def get_render_products(self):
         """To be implemented by renderer class.
         This should return a list of RenderProducts.
         Returns:

From 3328ba321db903218b2c28d16676cf6dffd34573 Mon Sep 17 00:00:00 2001
From: Jakub Trllo <43494761+iLLiCiTiT@users.noreply.github.com>
Date: Mon, 2 Oct 2023 17:01:54 +0200
Subject: [PATCH 365/366] AYON Workfiles Tool: Open workfile changes context
 (#5671)

* change context when opening workfile

* do not call 'set_context' in blender

* removed unused import
---
 openpype/hosts/blender/api/ops.py             | 10 +--
 openpype/tools/ayon_workfiles/abstract.py     |  6 +-
 openpype/tools/ayon_workfiles/control.py      | 67 +++++++++++++++----
 .../ayon_workfiles/widgets/files_widget.py    | 31 ++++++---
 4 files changed, 85 insertions(+), 29 deletions(-)

diff --git a/openpype/hosts/blender/api/ops.py b/openpype/hosts/blender/api/ops.py
index 62d7987b47..0eb90eeff9 100644
--- a/openpype/hosts/blender/api/ops.py
+++ b/openpype/hosts/blender/api/ops.py
@@ -16,6 +16,7 @@ import bpy
 import bpy.utils.previews
 
 from openpype import style
+from openpype import AYON_SERVER_ENABLED
 from openpype.pipeline import get_current_asset_name, get_current_task_name
 from openpype.tools.utils import host_tools
 
@@ -331,10 +332,11 @@ class LaunchWorkFiles(LaunchQtApp):
 
     def execute(self, context):
         result = super().execute(context)
-        self._window.set_context({
-            "asset": get_current_asset_name(),
-            "task": get_current_task_name()
-        })
+        if not AYON_SERVER_ENABLED:
+            self._window.set_context({
+                "asset": get_current_asset_name(),
+                "task": get_current_task_name()
+            })
         return result
 
     def before_window_show(self):
diff --git a/openpype/tools/ayon_workfiles/abstract.py b/openpype/tools/ayon_workfiles/abstract.py
index f511181837..ce399fd4c6 100644
--- a/openpype/tools/ayon_workfiles/abstract.py
+++ b/openpype/tools/ayon_workfiles/abstract.py
@@ -914,10 +914,12 @@ class AbstractWorkfilesFrontend(AbstractWorkfilesCommon):
 
     # Controller actions
     @abstractmethod
-    def open_workfile(self, filepath):
-        """Open a workfile.
+    def open_workfile(self, folder_id, task_id, filepath):
+        """Open a workfile for context.
 
         Args:
+            folder_id (str): Folder id.
+            task_id (str): Task id.
             filepath (str): Workfile path.
         """
 
diff --git a/openpype/tools/ayon_workfiles/control.py b/openpype/tools/ayon_workfiles/control.py
index 1153a3c01f..3784959caf 100644
--- a/openpype/tools/ayon_workfiles/control.py
+++ b/openpype/tools/ayon_workfiles/control.py
@@ -452,12 +452,12 @@ class BaseWorkfileController(
         self._emit_event("controller.refresh.finished")
 
     # Controller actions
-    def open_workfile(self, filepath):
+    def open_workfile(self, folder_id, task_id, filepath):
         self._emit_event("open_workfile.started")
 
         failed = False
         try:
-            self._host_open_workfile(filepath)
+            self._open_workfile(folder_id, task_id, filepath)
 
         except Exception:
             failed = True
@@ -575,6 +575,53 @@ class BaseWorkfileController(
             self._expected_selection.get_expected_selection_data(),
         )
 
+    def _get_event_context_data(
+        self, project_name, folder_id, task_id, folder=None, task=None
+    ):
+        if folder is None:
+            folder = self.get_folder_entity(folder_id)
+        if task is None:
+            task = self.get_task_entity(task_id)
+        # NOTE keys should be OpenPype compatible
+        return {
+            "project_name": project_name,
+            "folder_id": folder_id,
+            "asset_id": folder_id,
+            "asset_name": folder["name"],
+            "task_id": task_id,
+            "task_name": task["name"],
+            "host_name": self.get_host_name(),
+        }
+
+    def _open_workfile(self, folder_id, task_id, filepath):
+        project_name = self.get_current_project_name()
+        event_data = self._get_event_context_data(
+            project_name, folder_id, task_id
+        )
+        event_data["filepath"] = filepath
+
+        emit_event("workfile.open.before", event_data, source="workfiles.tool")
+
+        # Change context
+        task_name = event_data["task_name"]
+        if (
+            folder_id != self.get_current_folder_id()
+            or task_name != self.get_current_task_name()
+        ):
+            # Use OpenPype asset-like object
+            asset_doc = get_asset_by_id(
+                event_data["project_name"],
+                event_data["folder_id"],
+            )
+            change_current_context(
+                asset_doc,
+                event_data["task_name"]
+            )
+
+        self._host_open_workfile(filepath)
+
+        emit_event("workfile.open.after", event_data, source="workfiles.tool")
+
     def _save_as_workfile(
         self,
         folder_id,
@@ -591,18 +638,14 @@ class BaseWorkfileController(
         task_name = task["name"]
 
         # QUESTION should the data be different for 'before' and 'after'?
-        # NOTE keys should be OpenPype compatible
-        event_data = {
-            "project_name": project_name,
-            "folder_id": folder_id,
-            "asset_id": folder_id,
-            "asset_name": folder["name"],
-            "task_id": task_id,
-            "task_name": task_name,
-            "host_name": self.get_host_name(),
+        event_data = self._get_event_context_data(
+            project_name, folder_id, task_id, folder, task
+        )
+        event_data.update({
             "filename": filename,
             "workdir_path": workdir,
-        }
+        })
+
         emit_event("workfile.save.before", event_data, source="workfiles.tool")
 
         # Create workfiles root folder
diff --git a/openpype/tools/ayon_workfiles/widgets/files_widget.py b/openpype/tools/ayon_workfiles/widgets/files_widget.py
index fbf4dbc593..656ddf1dd8 100644
--- a/openpype/tools/ayon_workfiles/widgets/files_widget.py
+++ b/openpype/tools/ayon_workfiles/widgets/files_widget.py
@@ -106,7 +106,8 @@ class FilesWidget(QtWidgets.QWidget):
             self._on_published_cancel_clicked)
 
         self._selected_folder_id = None
-        self._selected_tak_name = None
+        self._selected_task_id = None
+        self._selected_task_name = None
 
         self._pre_select_folder_id = None
         self._pre_select_task_name = None
@@ -178,7 +179,7 @@ class FilesWidget(QtWidgets.QWidget):
     # -------------------------------------------------------------
     # Workarea workfiles
     # -------------------------------------------------------------
-    def _open_workfile(self, filepath):
+    def _open_workfile(self, folder_id, task_name, filepath):
         if self._controller.has_unsaved_changes():
             result = self._save_changes_prompt()
             if result is None:
@@ -186,12 +187,15 @@ class FilesWidget(QtWidgets.QWidget):
 
             if result:
                 self._controller.save_current_workfile()
-        self._controller.open_workfile(filepath)
+        self._controller.open_workfile(folder_id, task_name, filepath)
 
     def _on_workarea_open_clicked(self):
         path = self._workarea_widget.get_selected_path()
-        if path:
-            self._open_workfile(path)
+        if not path:
+            return
+        folder_id = self._selected_folder_id
+        task_id = self._selected_task_id
+        self._open_workfile(folder_id, task_id, path)
 
     def _on_current_open_requests(self):
         self._on_workarea_open_clicked()
@@ -238,8 +242,12 @@ class FilesWidget(QtWidgets.QWidget):
         }
 
         filepath = QtWidgets.QFileDialog.getOpenFileName(**kwargs)[0]
-        if filepath:
-            self._open_workfile(filepath)
+        if not filepath:
+            return
+
+        folder_id = self._selected_folder_id
+        task_id = self._selected_task_id
+        self._open_workfile(folder_id, task_id, filepath)
 
     def _on_workarea_save_clicked(self):
         result = self._exec_save_as_dialog()
@@ -279,10 +287,11 @@ class FilesWidget(QtWidgets.QWidget):
 
     def _on_task_changed(self, event):
         self._selected_folder_id = event["folder_id"]
-        self._selected_tak_name = event["task_name"]
+        self._selected_task_id = event["task_id"]
+        self._selected_task_name = event["task_name"]
         self._valid_selected_context = (
             self._selected_folder_id is not None
-            and self._selected_tak_name is not None
+            and self._selected_task_id is not None
         )
         self._update_published_btns_state()
 
@@ -311,7 +320,7 @@ class FilesWidget(QtWidgets.QWidget):
 
         if enabled:
             self._pre_select_folder_id = self._selected_folder_id
-            self._pre_select_task_name = self._selected_tak_name
+            self._pre_select_task_name = self._selected_task_name
         else:
             self._pre_select_folder_id = None
             self._pre_select_task_name = None
@@ -334,7 +343,7 @@ class FilesWidget(QtWidgets.QWidget):
             return True
         if self._pre_select_task_name is None:
             return False
-        return self._pre_select_task_name != self._selected_tak_name
+        return self._pre_select_task_name != self._selected_task_name
 
     def _on_published_cancel_clicked(self):
         folder_id = self._pre_select_folder_id

From 7206757c13e29d20f74d173b05327274077aa6c8 Mon Sep 17 00:00:00 2001
From: Roy Nieterau <roy_nieterau@hotmail.com>
Date: Mon, 2 Oct 2023 18:18:08 +0200
Subject: [PATCH 366/366] Publisher: Refactor Report Maker plugin data storage
 to be a dict by plugin.id (#5668)

* Refactor plugin data storage to be a dict by plugin.id

+ Fix `_current_plugin_data` type on `__init__`

* Avoid plural when the plugin is singular

* Refactor `_plugin_data_by_plugin_id` to `_plugin_data_by_id`
---
 openpype/tools/publisher/control.py | 56 ++++++++++++++---------------
 1 file changed, 26 insertions(+), 30 deletions(-)

diff --git a/openpype/tools/publisher/control.py b/openpype/tools/publisher/control.py
index e6b68906fd..a6264303d5 100644
--- a/openpype/tools/publisher/control.py
+++ b/openpype/tools/publisher/control.py
@@ -176,11 +176,10 @@ class PublishReportMaker:
         self._create_discover_result = None
         self._convert_discover_result = None
         self._publish_discover_result = None
-        self._plugin_data = []
-        self._plugin_data_with_plugin = []
 
-        self._stored_plugins = set()
-        self._current_plugin_data = []
+        self._plugin_data_by_id = {}
+        self._current_plugin = None
+        self._current_plugin_data = {}
         self._all_instances_by_id = {}
         self._current_context = None
 
@@ -192,9 +191,9 @@ class PublishReportMaker:
             create_context.convertor_discover_result
         )
         self._publish_discover_result = create_context.publish_discover_result
-        self._plugin_data = []
-        self._plugin_data_with_plugin = []
-        self._stored_plugins = set()
+
+        self._plugin_data_by_id = {}
+        self._current_plugin = None
         self._current_plugin_data = {}
         self._all_instances_by_id = {}
         self._current_context = context
@@ -211,18 +210,11 @@ class PublishReportMaker:
         if self._current_plugin_data:
             self._current_plugin_data["passed"] = True
 
+        self._current_plugin = plugin
         self._current_plugin_data = self._add_plugin_data_item(plugin)
 
-    def _get_plugin_data_item(self, plugin):
-        store_item = None
-        for item in self._plugin_data_with_plugin:
-            if item["plugin"] is plugin:
-                store_item = item["data"]
-                break
-        return store_item
-
     def _add_plugin_data_item(self, plugin):
-        if plugin in self._stored_plugins:
+        if plugin.id in self._plugin_data_by_id:
             # A plugin would be processed more than once. What can cause it:
             #   - there is a bug in controller
             #   - plugin class is imported into multiple files
@@ -230,15 +222,9 @@ class PublishReportMaker:
             raise ValueError(
                 "Plugin '{}' is already stored".format(str(plugin)))
 
-        self._stored_plugins.add(plugin)
-
         plugin_data_item = self._create_plugin_data_item(plugin)
+        self._plugin_data_by_id[plugin.id] = plugin_data_item
 
-        self._plugin_data_with_plugin.append({
-            "plugin": plugin,
-            "data": plugin_data_item
-        })
-        self._plugin_data.append(plugin_data_item)
         return plugin_data_item
 
     def _create_plugin_data_item(self, plugin):
@@ -279,7 +265,7 @@ class PublishReportMaker:
         """Add result of single action."""
         plugin = result["plugin"]
 
-        store_item = self._get_plugin_data_item(plugin)
+        store_item = self._plugin_data_by_id.get(plugin.id)
         if store_item is None:
             store_item = self._add_plugin_data_item(plugin)
 
@@ -301,14 +287,24 @@ class PublishReportMaker:
                 instance, instance in self._current_context
             )
 
-        plugins_data = copy.deepcopy(self._plugin_data)
-        if plugins_data and not plugins_data[-1]["passed"]:
-            plugins_data[-1]["passed"] = True
+        plugins_data_by_id = copy.deepcopy(
+            self._plugin_data_by_id
+        )
+
+        # Ensure the current plug-in is marked as `passed` in the result
+        # so that it shows on reports for paused publishes
+        if self._current_plugin is not None:
+            current_plugin_data = plugins_data_by_id.get(
+                self._current_plugin.id
+            )
+            if current_plugin_data and not current_plugin_data["passed"]:
+                current_plugin_data["passed"] = True
 
         if publish_plugins:
             for plugin in publish_plugins:
-                if plugin not in self._stored_plugins:
-                    plugins_data.append(self._create_plugin_data_item(plugin))
+                if plugin.id not in plugins_data_by_id:
+                    plugins_data_by_id[plugin.id] = \
+                        self._create_plugin_data_item(plugin)
 
         reports = []
         if self._create_discover_result is not None:
@@ -329,7 +325,7 @@ class PublishReportMaker:
                 )
 
         return {
-            "plugins_data": plugins_data,
+            "plugins_data": list(plugins_data_by_id.values()),
             "instances": instances_details,
             "context": self._extract_context_data(self._current_context),
             "crashed_file_paths": crashed_file_paths,