From 8696821442e778b3f8d003cdb9d44efcb887e6b8 Mon Sep 17 00:00:00 2001 From: gwen Date: Fri, 5 Jun 2026 15:19:18 +0200 Subject: [PATCH] docs(VaC-Concepts): def of VaC --- docs/concepts.rst | 7 + docs/images/dessin.png | Bin 0 -> 24338 bytes docs/images/dessin.svg | 385 +++++++++++++++++++++++++++++++++++++++++ docs/vac.rst | 41 +++-- 4 files changed, 417 insertions(+), 16 deletions(-) create mode 100644 docs/images/dessin.png create mode 100644 docs/images/dessin.svg diff --git a/docs/concepts.rst b/docs/concepts.rst index a4fd13a0a..60ef0c3ed 100644 --- a/docs/concepts.rst +++ b/docs/concepts.rst @@ -399,3 +399,10 @@ This property is generally used dynamically to remove access to the variable dep - Read only - - disabled - mandatory + +The lifespan of the variables +------------------------------ + +A picture is worth a thousand words: + +.. image:: images/dessin.png diff --git a/docs/images/dessin.png b/docs/images/dessin.png new file mode 100644 index 0000000000000000000000000000000000000000..03f58659e788e706c0cb6b96aa0458dc70ec73ec GIT binary patch literal 24338 zcmdRWbyQT*_wUe1NH@{~(%mUTgEG?H-O}CNAYC%3AR$si2}n1H^w1!obc58p=4d+*QQ$2g5winv&mSRfDxS6K=C1_VNegFr}jnCQSK z_NYcbfWPQ0mENd>K>o}iP-r9w^cVOjbQc8j;sJsFn1MiIIUo?3TR|&C0{8;mLRAqA zdPMwr-(HpheDcIiN#6qmdfJ2dK^kx^w*rAo%$32iTE6guWj{AYdw-g17Jhd^y6?9g z6?#`eUb&c9u|H&XB4UD3jJ3fp>Hj99~hu z7K^y-zA^C@#&y$E? zD+Z8@UBnQ{R}W(;X+4%?%Qa>OgPixId>>`O;5`GF>CNZtu}&#LHCyaioJBCW#a#h0 zKqd0eO~{0_O>oYud$Gj}Fqn7%5L<(+Rep<(w%}f;=9BQRYfeHvLIeVl#d+TxTTcEHK>Jdm!UnxKMT6~Qkz33A?l8i7QBI8nC?#bo=|mn!zuOz)C7Ab}1<40?0qqCPt;i zBa^TZ%O_zt>nA@}v&Fu4sQj8c=9UFF6QWE<3V0}XvVIO~ORH)qDslHbPYUIpZW^owjL=}AuV8f;lx=9iSwD*) z!!mY=H}TcjcPkzS>LdorBnHxi=W@b5u*>c=*29aWT}d1UV|gg=(!sOY0CLrCgys+Z z-S_p)vbBX-gBc--YHHmMLX3Rec4gyk{7#ORz82_pRfu8BN$M?gTX0msNT9fE?buJY zhZW!0z_#>ornrP9q@=5K*t=ht2Ly{g>A4*C2te`23$s(#&?a$N{d?<&ust~FbXiK0 zAbm4|(RxtjTcVYjC$Wb1e3cFuT5Cn2{AU!#F@m$m&OvAx!tV<!Q=~4cQ7ri@2{~$L3a=0gfqB3aE3~ zlW=^z)1J`0ow}3Nmle|#q@y%6_s@U#j`zFy%&>mU+zIBJr;5mDUnK*O{~SC zFn2mrw~b(r121RuW>FVimySi)g4OhG2>}V(_&@7IMm6)+F$@LC65Ddiy%ip8abY?! zlMs`Ni-uF`agxSDbA;*(D+MC?7vVhlxOU}SF>Ad9;2$v6sBx!?EE2hVM$bwo2B z@zRuVdWiUA6}B2S*$TY1vKCUy8BZ~K$P3-vD}A8WYk<%u(bJq~#ZHcTxl-bu(Q2l= zcABCA^rC;;rZLPnmaB1*Ag+(^uak$3p*V8r-#>L$gXo|LCg_(|9E;(6vIwRUSOv$y zSn`mSjPpnSgFu~xCz)H`A4vBWt8BF1EnEbbgZC%_2%S_AY{Pu}CD6*n`~%%+y95*b z;j>EM+~E2oB(i(`-4v$V{6TEruSB$T9AH(H&&hFfX;rA0o_u;&hgaE`)A*s+;#KF8 zji7BiZT<}OO76MA+&^_roz8WlGm%O!m?7P$hj;JqUoIuW@|G%$vq-=UyytjNtqbOC z>gfsNc${jGt-~ap2orQS2dqO(v_YSBx5QpSn)RPfzWopCosB4_131v3=}Qh)pyt6&Kj zqc`JZ|6nAQNr;^gcjYn0OL7Vy`U?szViLJce#}UQdTc}O=5I)9uL7pVNs{__B%~q+ zos_bz(K4n?4%L(!)b_<*f*ZP+#NwGAiwe7<>12p^&<+<24yMftFo%O8BFZa2kBf9N zDSyp|uV47ruY@qD)l&_fvc`u`J|WvclVN+?E*}TBB&RGaGTveR706G7BmYBK;t7O! z-agVU>YsefK9`6uY`?~*i+yQu?=5ltso_>rJ25#K5bk#?K0wYq;`Ik7{`}#EOk-Zd zgCwxe_$_kYa7aD>YJ&M7vw)V6lw zNk8*|l4PbQfct4!sr8JEwL?*Tm(27a8RGtd70W(92UL&b3)2bkwep<2<)Os=x_EGG z{en?BmFY=5)M|kv<^m3G2>y@XQXMrb3o6{gOYJa&Xlq|1Bl&*okU#3N66m&RD$7h8 zU6tqaDtT@Tiz_F00~}o}$Z9oD@`BII=FZ(_y7ZzVRpOG(E3mdpB_qFFJIeIjw=;aq^&TC4wFZT0US4hU5$c; zuSq;u2fb1f=tBU!{dQ~0hr7avii+c3y!?epGZxVmY`|#lPovuPh0U(f&NAs>Es+D( zMtwTveRr8XRT09zL>5pDclniuKo`QzcYU03*lCt>OoCM)YY;qD%nDq6uEP#8AL3u6 zDqOGv%Q;ivyl8VKtY)#vAn?+D1^CfK_2yIfmZzjSU@%ae&j}3tA2=-3_6c8%yoJyH ziDIoa0F@u#24Y_>ylPLzX4>Rmz**4ZP;n+@jYrwkq-l?-gCfL>DWmeto2E<9OZG!W zMJ%}VD;MK&re3uM2}xLJNY^G|Jsi~IZJk?4pC2Dz-+=1k3R+iEJ1VInM+9>Q&4E^v z`pzV^cEn%xvINodt5MlPLsy&3+-&BPU7u+=n68|uH;{_%KhMeGD$;jGj2TXy3}foM zdzh=Jc&VfF$s=@G2U%O201KT|!lg9ExpWc)S?gA0lOpwSm!I137XX7BprlV1>#-Sh zMb@(5&iJTwJ>GvTS=gANdPZ9sh$!@3r{C7|IQ@gnBICwICkbq&_N zi#VQkNRM}#v;-9TPu5|avvBVG7Wvfr$7n2w(aoUvW*G}+uwVCk=pQj(W(3+m-ZC6i%94UC!EK&4p)Z4+>Z)0`gB_eLD7Wyat7eQo$3n3G2 zPxbEmVyvHH*cg35vxSAVfCgM7H3iAmcJoxttctAH&CYMX}?fpvO9)u!`tP<=9MRB2XwLkO_=lu;P0@;aIDe zzN3ewX#YaOgc~|(2iMbld{r1_3v6Zezjt=ML9rJh?AkFch=Q_d5I>i)tg`WD%?$~V z#ZOh5iVL2Lli`kM;Lu?&NPYt>7@}_ymiNbDdRD8)qLxDp2A)suv!I}YGw}dBI{R-& zBj~JLGs*CJlor!?ZxoX-tmGl@Erh;S{NAFp-yz;E#CXvrfrZ??&cj^Bkds%Wkn#gV zmY6=C!J(pZ6226fwau)hqxFkCM8fGdu%qE?A-iW;FarMA|FeHtIAy=hMWnDfUlNm) zS6~u^LRp6nCbYHH$MslLzU^?oQHwUg^k@@do+zgIM)X*eSJa<461CUlQVNA48wxd= zYZ|hTzSv@kI|K0Z`aXEDPD0pG>XwC92i=L`=WretJRaJ;b;i=kRhwhZOL0L%N-!Cn z=9nc+q0#3{m;6XzBiD$jjYbUmxxeqlXUBN^a=4dS*uH+$zJ9!Zi|NGv=-sUv-Uv+% znXco1H9pl^)Gr9O;2rJ4VDQ9|%`S!! zV$?jDdFLNshytgq_|L2Pq>Wg*of-77fh;7QZkUisS^ebfwb>4)V@nFhB=tkb2N_@6d zk8~M#Bbrpv*96Q$h>HaDZW`vOXBf08L~g#aUq^?P%Jkx9fKFM1=>>&?wSM$_R(yF9 z4efFbGGm4vh@d zaWYyP2|^_D$^iv9v*3oGfRfm$$3|N2(&nlK8yjv#_PERh=uyoYU8VTuWHP;wO5jxC zA;$qwu75g}vzO}cbDM^+sJ3K~{_qn zC=gwY$5*`6egnTP`TD-_TKpndQ@p?`@?hcb!E~OxaylI*1Cu>hWDFz0(!rs;wzX*9 z-kw?Nhn8{Hvv6-%>evr;@JMY*xHk`RcjICqW>k+q-pBG-XlPcne}mA>o+L4Y0g^qv zA-?U1JXi_+3Hm|~&N!6yCF#eOhlR6l_Ed4JvK8GwLCoCwrc!)V75sbs@}TaejnM@< z&NxEwi-#t>?ScHQ~Tt0&WEiw|R&86QSHC&u4WF`=MBBD?Up{UF*T5t~HiZXz1ShmlpRsoRZ= zzxD+Qsz2b8G_aHz`Qw$?eXfWf`b~lE4E1sdF2e;fX10?z+-rsp(LW5Oi_KjZd+y5#qkDUq&@l2gYPYv`K}9XSESGF_XIRC?wl&IE z?+U#qcKBpK&!NedmW*JM5MZ7llY6w}{ZS)x=QIkF@xyFFf^)WoeOy*q{Dx%dy{jJ8 zkEx_k&6O=_!owQW&3;-nIvkr5gJ8rIRaDy1U5xT&aTJrQiyeO7aRu$ncb3@x;f|#g~8P zi0N~h4Pey*SFk?=!u2yT9U~^{%uLbaJN^^~>g3(~ukp!~R*^%^QY*bYU?5ak1c2pN zOTu-!v7&%EZ~k$Fu1Vxnmzcf*1(Z&PP?w9G0w>za7Kg#WuR{j2#O)zrgVTm_l=(sJ zjr*d;>iRRuAOt2vbrYQ9;#wA4=C8=nGcY_;YYRksX1dy-6vC z@8sq=12nVFL?wNeJtJ=7$YEZCAIQbr(d6iT+oQ&sCpS23_^Fr9!$CP?{ql3FANVNA zxcC>Q;gR;)RKcC5M=?5{Y6?W&2Wu=pD#HMe7Qb?yNW~&8jUhUL>sHQld%6D|cB$@< z7vZU6_}geQ&#`ne)>82)u<+O{Yq`v1{KN_XYWl+!Mew`jyrRh>?^`VR-TQ9) zm?;zJ)z>(?B#3sj6KC}rjUX5-Z>^4T5J!Q>Y;(F8P62{7&hp#s#c?_ynBnwU&mSiC zjWd~Ue%}Bkv76D+{v(OXz`(|^+>YYbBB6m6>{OQyEC>c`s;wVk)0>iQYv>IpbbM&T zg;!;v)r1_@64^OA$gon+-j24#gW@ z1IXVF7#WoV+mBg|c8eW;O5FL*gafD8S(Ff-$Q+IxuPUZ^x2!s+#PXc$`PtW+CbY$? zGyfFL*+?pcTq-2ESSnX78Z83$9Ss#Af>B^sj8LeqiO#1h{CER-zuXl$ItGIb1k>f1 z-scoKnYvoT8ezUJ8qo@8lX$zqYGbp6)`;`5PrsT}KzQ~y!1_T2?R(G;icVzJ{EPt^ z?9Pws?AtBjl!PAm#F1`raEA4`7}uU@>*~C3t$TSCBM$~s4FdMwgf4zkKd}mMjPiT6 zl8PtuMSz(_#KwB^h^@2P)%DrE(=avu1Z;*tV@des+I0Df9IFG0s&DXs4f9DUUU1mo zVamXxq3pAcLMU7F)M`}gse_it@M*{LMUlAguOwCvP8kvfmCNO(vFL9x7_XF zz+@qYU=U4Q>};u$fXh$9)yBTLi5 zU3|(qu{$L$xPpW0zP@I)(pO+5RM6tuN26yRz>kll-&t@;2J)=3+7eP7kB0zzjR#cO z-cPfn?J>3VPURHNY&6M);!F^*-)GIE5_|%J(2Dpsdhcdo7|D8tOVT&>)f3R$HX;X+!+CQ^OQH{PyWEyHYV~u+V4XXKwwB|m@%NZMQ$V| z%(gvaS6LAsB63427W3DPH@CJkhy}owe%nvSBbrCh_7cIpd*IgKyLE0}F-fGhndk_^ zrk8~BIO@q8uG0Rv&R*)G{ncw_w4Ko_ld|u!#oXQYXjm)4i`Ih!15Z2>UnOmB#dKtO zQ)N#iFZ>3%^-f0pnWuQTiX}Dx zqSF{{ji{aXOFrwYwJbGlD;^j%ArG>%i-j%0NTpLm$ z?+WmRX<;y)=}Jd<%;mEvrnfpkZt*2~(&hZsxd-PjEFv(Hp`&m~bzY%j1ME}8z;-|C|YQHzW3UGQUbY;y7khb!yG5*yWDN^rzj`T5HD&^Ny7+< zc9*VCjVwN@gwOs-Lv4N{Gxcf^xogoqrf!?7Evhp}1Sam0*tQ5;&rr2pyA0sn^eP!1 zD#VGiv&2$(c@5p{hTg;M?GEPNE~a%r?~H^N87#6SIOO_kg$o{1R_3dmZc>MTxA90`;Sd5hDcBB)Yd zFtL}y9a!L|zW(@kvU5W8OKsW7hpJt1;0??n#}tS{TXGMa?z%=7GjlfcS;=wHCERyq+i9hMVrn%n6`x%|M6fRzrgnqC zmN!Nf^T_Gz2C%|VC|?^2zlm@(vts?M%)YPb`P|BUBXqwhtuuDY9qY zX#=J=>T4_-AqkWg*0FsF;(x6w=n~7n%lfr?9BL;Ccay#Kf0Vr2*bmUqdu-iEOh=OT z-M4Pg65JJvJ{Ze)Kb*BL=nO*3-!uH_Uv?WFy!7W_usMk-e*S0k6Q950CtC+2zK6S; z_H!w(UYnT(ifnp6CuN5TICn2Ua0Pmvcu0iopH#KONwn9u`GH*FuR;Jld)l`YVJh|c zri=G0J<_GoRikCrPkQPs)d-*a>v*0&BF5$?fE`ygO@?Ak}N=pHZ5$KN8mZ#6(xg#DAi$` z9#HT|$~s@c8MJxPbyXBdfpBJrxSpFUGCrrRlKHUB-j&;9UDrEc!86vG*W;Gl8%g}M zYbrbHM!yrUHc3&D6n$u90_3QIPbX{mTy|J%H=BxsNL&l=$=gdKcB!aT+5o%$ZqGh* zAxh6+fNPUMQIYpp=A#f{-?itwO}Ov85|>;{QyyQiqyK^y%4%-gBa}mWBmI7hXj*Vu zj)OdYZTjQlP)$>l;QQ(lfBB)a%j-1lv<{PEumez$__@*w0=1c!r+6q5^&LyY ze1At{kz9}n4vjEOVt)F@m4nL+xPLyE(sC^H0Y#nzFIi%F0iBtWpOB~8+Pq@?K!sP( z5tKZ{_je#>?a~im1?;LF!%KUUb2u!!C8OR{a@w+YQ`AraAc-me5>Rfpck>7nhY0cU z2|mSC3Xu5xNs=qll0ZvzSob4;+#G=00eUo8xJ#PRc>p8A|NQ+w_o^l z#RK$RC^g@?1bS{V$-xxR%M_09y2^kQ7-9%Kpc?|)IJjqmbf;ZP`b!G{b1;Y$-!&hc zO=Vxxe^9oQMU=XL>;LS(FjJoccvxV;@5|XN>WqFkgOTv%m5)k@?4yCy0Eo(*-`Y@@ zPDP+C_uF&#z_Jef@d}mr5k)B=po*(sh7-!m9?=s^B6wvW?sa&k?WU&+(MjAdpbR#>T(W_QR!gaKQdH(|s1i9PwmT zQCB7~E-FJ7>P)4gx3 zrNMh9i7LAmjswh}jmuHYZcaP11hApWO^J@sPqMf78K!0q{nb}fkar6GER#R=QefNY z?J+MM6DMe2GSwYVc&TL(Bn{!CzF)GB8FQEomxV0RJ6xcI ze2j7SxWJ#!fFS%EK7B>h!Vujv1(VEB!Oy)G;r3}yU#=_Rbba-9WMP;j=Q3@3Qq28$ zsQ8YyejySiz^BW_Quql2n+Y(!fjJXi?KV$lf^%?+Du4@LmJA{%2Xdg#tOiYqh0Tx0 z!R;}!;12-F!~ms+QgYQX(-Fo2sg;2&P#hgB3wZ~v&>$uW2Wg2om9y6GNqRDj5gY&L znBq^&ff9S>SC4s>v+a=90BccwKJY6%Sy!9*&R@M@1-R*HWDjN(cK-9YUecmQK8hqv z)CCGTcIHyZ5j{Qugdoitjo!P#z@0gRK%v8i?89z2jFd(^m{v;smL&YH#25l)g;sw? z$~UCEpuqx|dQJ6ABIbyOU3aMvOfFZMdiUlfngR(Ann_mG44pi>*yhKmDmED3@`yc3dM$RJvB60gb_j9pC|&9Y97a~kWIpq#>}VfF|WYvO4|BY)z9U%0b-%` zji;<3JHHE_gvsSkV|`?xpW*AGN>&IP{8&p~zWF;BeR{)jkumz_25rRDPl_{Eejw$W zAa6KxJMhL>x!q4(>0wn#XWf_~E0Xn)s|ND<;jb-?Xqr>}$A23tS(eL3nTfnzR-p)^ z2FizpG08>1ZfP`F$;;}l0Uo3r{uN-58PYI~Xj}t*a1D6VyF%mn zSWxMU+fhI3MKSW8KP835E;#U(eE#whF!n7(!GJYJgEbOQ>V}#ChBXD`UpCZIUlotc zHPYPYTRygBsi->pXP+IUTXA+O9f^b)@#kAzGN4BmryJclVX5l z(DeioF`=fnrfDw$l{uuKH1!Od3gqlo4Vj6<8eQn6^0oe3d>?f ztT7ZY4k9jY3*MIZi(1)0e-VNuu#+b-{xSQ~*^8w0HU>faRa62gJ|>XjgQKGrd8K%9 z(eAVyp6B8yIJr26C1qszvB$q}Z)}uWpc$mal#@57RfJbim#iu&&5}M zsrtU1rGT&!u)Ib8R@VY{HUhWua`L)2@o0fwq&)=)>On=_8}$ipOk{7D<*KV5CMX)X zls8em6}vU5&nj{XGS4gwZh+k&FAZs{F1={tktYBqY*B|C!UI4laXuCcDJC2Ud3dEd z!CFgLjuWy#|I0hkXZWZOdDAM^Et&|Ev5!aaH!cA8$wNMj1gc|@OU}h^ZJ%s7uKE6^ z4fnN_KlRiU7s8VhJSPAsEku^D1ZV;`F?rGQdG!nqme`QC4-wedb z?<-xa-Y>p;mjgi%0YBnS|Men)|7sw8{Qm4EnYhsggN?c}!(26S_yj2sVUi@}Rj6bI z*p~-+RIbSB=^{uBFu3y5C?vdY;o+jLN+t_?u^nP$r7&YAu=aW26&*Q_ETozLmkM8Q zA`fMfKc3}3^x-jnL#DPZ&KkIwtAO1%@= z_s5Gu?C;n-k8HqOH&ol;lOn))3^L?OeK&4brvu1=34k5@qxErq7ry;1842y*$p!|n zE=NBBFci2dfV4RB0 zLbQ{&3xS-S4_G(ADBx;|F;FrAMmXKzA6y!SFCj;S+4{|28r=Jmz&Dy1Kj$r(XIrc^ z=EM)wmt4i$mgh+m-}wcQo>NZk*&`mVPsMCE=j`zi26)mpi?fli=szT)*$WO`XPu8!n7)A;B=P{Ir=_NYtwwrQ zv9c5Ocq!H@b%Uj%)*tcsYwkQ43m6^C2gD?tn8>KIdXr}h1t0yTISi1-6tB$o70B`q z7pt!{5I5BsOv&c6W*c)$B?3QH2z-i-eQWXKlOQ9{L0DS|F;w=Yd;n3R4*%Pr_XOCA zbc#?Oz0uUf+|~XtWnqcZjL?d16T>Hl+7zg~w?kU;VU@1L^fk1zb#LCy>RL zH)*a@lFJVs$SHp$8t>10E`1rxjXC$7^_Lxv^;qNAEOAl^6KyTED;#=(O?hQ6iebaO z#)l(BxPi=TmvI=*#r^7GgciCp{k%LL3&dkEHvhO>2I=@rzvtX>H__QWQ{0h46mq^d zfAuG0Xe5Sfxhp&520L+OS4F(z!_PR$)j%A@;M=}m)`wm0MmIwNyVtv_;J~h5Tj@iw zlHAhq7!Swd_#a0vy3y;O+}qY{PMh9g7OfBc+R8M{J02{40C@$#&w}?S&B$#ZR*TmU z#ck;(ys-$tNX{%zH`1i zn{0rM74k}MH@tpwLrsVOkB}f)ptvYuA63Y84eyL->?zEDKXBbVM};Hj4`pv=aR;8Q z=0kn&mj}qVi`NgFAhV;UV(Sp1x_u z7;wL*mFk-5yv3iz!gw0=c$0XWyT7YAXG=Eu)(P*j{Vy>pXztw0G=@tB117E1Y&A`#j)?$S`hKgy_|L@HS>>ANa|uJ=R;U&Pl#q z**+3fR9M{B4?vn+u`Nn4TVI=W?>(M%hBtQC?%opu5#}GD02lC~60i8a`jT^2sG>cE zrl%<8kbPHZF8IM+!m4R@GqdyItU;sYz!7hatn+r_OiK6YH+yO+@6u!2s#1OndT7kU zoM{YU#uQg293Fnuc}ezFJG;!-q^<0k>*Gmh4`4*rxN!bD+?zM;2Aiu-fkXz+~ z$C}P=-H?0cSC9F{Yx$2`k9wZpvP15;`dzQg&ProWMx`HvFrhgTbGMJ@(j|KtHEvrh zN9!G{eosK}2eDq=_ocjN!=kw}?MS#^4HEPF0{o_=eYgox7>F_bG8)1RAPDDT^zTw! z5YatQ(kv-Yx_U|)m_NQ?*8JG^x(uLJ%9q|1b>uJbsso z3rdRd0fmE(2AS&864Cc>FEuH$Y5zW)@nq@o__y;{e_+ZMcP&H*NgQLWzKY(Dyzjik z0ewK*NvphCqbd&TvmYpOmCADOi0C|V>Y9)SCSz|ahvuwp{2*$##ab8s`HQcJt7r%J z9xrapDIPqZRvbBDDmmb&xToe}AS7&MO84|I_sbwwprvL`^Hf4yTTm(v;V(b_wI}1- z271H$6xmdx%vvyEBoOn_1*dPw%H#{*Xclv>M*0ox-Xr0y6zXJTkc8ak&;ZW@F9>8O zR!5XRl;b{L;mpaiP|bcti@@oTx)K#dJLkA-WDN^GR0vr4BmW+63)e)yj&^kR&2cW>)(a;A1`dz?8?I%tBAMX02%$C;;jy%=U0l14n?&2Ov&t@-)=lSu2W&t zI11$dEarZ3g#khLFrOepYz)vD?rB+gfK?^d&x;(cO`2xAgDsOWTyqIO)g2hDC)4b0F+93P?x)>q=kNO?!$sCV#4RoIbIHLtxPLX#mC*&FD zlLm2U8ybQ@J=sSuQ?tyUOdQRY z9b$ltZWgcbu@!%Q$v>odIWeT_S3Dy9d)RIr15~R){#F2elCH}tftytA?tmgsNn9tn z-);RdAgJpWVud#MaM+VL!u@#tY;cnN&y};hz42D}>r7Urrc~*hn&8;41I6x%6|6%B zE}(Mhueh)ZzH1ia=KJm6iJROHV}?d2sz9O^UG>)@96oMgjIGH+ayKTvMzB!(Tc-mc=RPjN^X%Lx!o=0-1e-0l>lGHxG2?d^BrL zuj5~KN4oX(xCqetB!=dpIjY3NZ-E}xgeA79&CI%ec+-f zKrQ>Y;F$AGI5d7N>4d@$2yK2Y13Hs=A!x_(ey`VJ@%5auLx26__1t<<4x-}rtg;<- zh7%WUb=-`1o$B%AwcDxbBc>z^_vVu61F}qD|IM1KR6?O?2xiFHh4k>A(Tw<_nfJWg z-bIFecD|~!$aVh2`tDIMqu;_|Hm#f)Jfc!Mh&DU;S}63Iia=%k4Nn|@;YvRSMN}ROpR1cOd1=}Qtp0VLE1|>Yfj?PpKw3iKH{3*kL5RCz=8eQ zJ3Ak!FU7sMg?%!H-AwlQZa+St6x{eo_qAV*Z>$8^W(;(k(>|gW(gqD7IyoB@F#k~I zt>8v8hKHWQT#1Yd1uVcx+ge|^5@`dQb~(Z_wFe@S=U~Rkj)uQVDMgz6-N-?e zrn1)x@Zvd6&+)-X70~V(>G;%bO^iXC*Q2|4yNi?qD{2(`5e6nw0#$BMDseSJe*0x)YB zx8WI2_jRxxhR=$BP5#WD6JI~I$;#5_WEPmw-W3x{;f}3+hc?fNtId-?dw%z<8YQhf zvBS^0@JZWZ{-jpr(N$0hz^ge%e;iHzTUSkyT^7BJ8nJ*HAsS%E`Pp-OIb_jJkcEum zQ@UDzqPjUa;++twEV0Il4&M9VuG`ea=tNvk`L!QgzbIPz^4j>Hv_Q1OXk7P(fLIPzL1Zzm$YM`Xl4NhyAY; zPpXOlz?PfoBoH)ekN=ueK-oEr-9~guGC;!-Y1%;|0T_FI@ipRw|9y`?{lCv~*|kHo z+ZAO#Br)8s*dUf}U~2*NNaM!}5M)@l$9(4x&H-6Hy9z|hH&7O+{{Gkf^x49(GCYWML}&E+9o5^kO!afEK*&%H@vf8y^7Lwoy^|e8zeKEE zQbi3LVy2GaJuXoQ&W{}J-%cBpQhT#gR#3p~Es0Q(78fbcY5LO(E5gGWoRs8n^38bFLHYiQ7jm!}DIgEY2T zX97fkxegZ+^W#Zg4$TK+olT{Xl<~=_-m%#1r4EfZAZx79xG`E0ZtU1G9kbkF{NpX zfNz@pYOn#WcBt8iP@X(V;hpGyc};bH@}_Z)@lXB~;D8OoPAyF_t#rV>BV5!k&6N#EviQLjIzjtAJG-W|-UsAT!|m6? z8qew@_G1Me>6~vksbL7@+i|m1N=#VU1NmovC*zcte*ftk@*q3;UJ~Sc+=1ec=clbL z@~nAo86$fDyI2|&kesBcrQKJZOoJ*%50bHc{TMFW7GlSA^G#QGTgrugGN<75Xupl< z^6AqaJD&HoUlfkY(n$dhGV4>T zqO}n1UsngclPCe^JWBp}xw9bj0|~Dyy!9kJDLE#}vF2A0Vqoid1UI`g^L8(Mba}e@aUL89q6a zz$`Z>>e15AXo@DP(9mawLe@sKaSA6RK2kvcEK0}CK9Rq4<~x>*NlZv$Cs!0Bgz2(2 z-@C5=ZxrAS? z^Nbrchl>}sUtgZR?uIzb1?+y{2jtK!DfR90fdyDtPND+!LML{99+f$JEznsy+AK*< zPSdme#RO>Ov5s^CiTGWzBeqidrtqlCiX%BU%(UZ-7trb8y_xKD8mwx~gKBks(^#7& zn!EFhtFx5J-;)bO@ayFYAXQ+m4CK-rdgWS5q5h@zp*R#l;bZJ0;&pnJZT_?uM7 z_}l!465k&#d6JKBl+q((4yE6n{apz&@3m?P<^O4LTu4?d8>CJWdff}5Bk!J0#LjkE zl2v>y{Y^@G<$8_(Zf%j9cnl1o_x~GnyscRFzJe_g9fd~Z8y<$YZPt6=z~F**UlLu{ zrfKkTT6kAArZ(+3v2%I7mdokm z=M*fBHnhUv%(JmicCnnrB0#k1mNn__vAMj*?BPL z2mW!p9rHj3N}0R9kXo|OPW3bQ5sX0Nq+YTaD^3JcwZUAth6qlC)u6uR?BrAv+oqnH z2z3}8X2L8Ux}15AdcU^ehnFL|ru@3;zl_(^mkY;fjJ^d^m2PGXr5Z!Fzpp%7bn{&u zFQ{*-sDS#IkqaMsnVb0%ONG$+8MjP@6&eb!?{>B8OP8qRyan{Ro5b@1myR+i@d<_Wb zzxf-Z_-5R=*n2r8QD3W0 zd4&Wr3H%G0*49M^wf;qSdl*i#!r!B!?h3gX;{JKKgHiJhboMQ`-98(G>kDl{(@vf=2+VFt%pP2r`+8CX@Bq|`NUUE8 z%*|~JV$&q`^YBT<**8(GyP?|DKS6x4)zZvEn1qm!OAQ{-ps(*R@M&9t9Oq}9&3et! zH|!7|Opr+MFHjzp16li6+I`!kBoFc9{o5uYJnEI~$rTR(v_%NzTj~W`cBi*aEC3mY znPH+Uzx>yt?uhNbj1|@6=C|Qmp*c}F(lC;wB!I3=3^5)m7Utx!+o9*}v1a4>)ha1f z(CLpNeCWx{eY-ff5|wi*7jnL4;^gXzf`8QSb^_;YXcFA)V#L6Y18-iqH;Je7Td(>b zK51wYLW%8^VT%u!6o;+-C@K^kaR0L;fBy7o>C*4-*smqiFUSGs3Aj|3mA&46OU;qypm67V?HK;c%}6>7$sh^^}iEiI#sx!l+LY3b@*fZcO1S2|yBsoEce z5(<>TtzukVg;P>!$f$P072#ft-rgc1(a zp4`;t6c}l|D0>(C?QCdgD0p2au;kYrS`FKDLrvRX^yBTAvh+O@!VF@-F$o`et-Ap8 zf9UPmcY^XO{x*8?Mr45HDWDs)MN%;V%R%RVS2aD$&*|=?YI1L? z6uz+$%v{z9x1|wHzMTC8$lmvW^i^?ZL2dM~h0tak(G_=PfXaq?^pI6=T6-JNR*4dG zSpsM<&;r(9_^P1!(F}e;TO<~<(q%4jHt6o;VBd?uGQk}3MKcrb?0Z>@F`2c)0$Eog zmj2sk2psYrczV#&qv(J5jfR2^aKvGAQMe- z0bnk2>LlvD4p%qoaA!HFI~n@jP;=ka(x>(ygI`Ld3HWAwoT%d~*Wl1vzX9=m4{m<| zGg3*cCuwD}=VB%oEbC7&B78R^ChCGY$T6dTOi4$=D^vhg?@=u4?A`6PI{mAs*1x+y zYH(Wj&NNGNic76!DZyoS{cM0X0QMS{A&p#t<O$lNKi68|9RWaY$gb2MC6m$)Y_?nBTd)=H0w{A$Su zAJCD|1*ey4S?+r#!ct;EPZ>8euGgj)s<`ReU@i(it8|wKOYzS6i|N?yfXjO|UK9Wb zqX~f2qvUG)Ca-`XU^y9p8`m3UmT=!-^=@dAO=kk)sioGrB+VV}^Q)!`OvaDwx2T^8}wL!x}JJ%e_xo4Vy&R^kfE!%M0S6l}(3TPJ94T zOWN62#mJ`fg=-3RUhS=hW33&n-hoPqGUlg$#*!7Og=iKVl!*cU-0>&~OCRz>%QS)I zHMRWMK2_++XZvrD3uNRJ#l4HP#R}@$Xu`LX5FU{$^x?cM+{(F~f!C%Xcw8xDP*w{M zRU)=wYRu^F-QTp~Bb$BF-|h)a0{^7_`tYWrcIfjjD=lL$5{F85GXZj*gVXo6W|)9S zsA+$E(eYSaV_WDh8T3FnZt@MC?jaypQ(>AlUEOJKM}Y z3QRoeJiYiPwH`O|OZa_T2qwbHN^bGEuKA07J?d<4v*ah#ReON4_cKGd8;~#n3cRf0(_kM9*h^)Jm(3p6nP{!6<$ATy!D7b>bS-s*6s@^ zF6?SQl+wz|UJu}w&h~y)ui*SXyoBdfklz!ZHh+kzW)$PCcS&m#jURUN;fqX6V>?I{I%Fe5HSL-F8&&$y}#lDy* zjF!iL?{*JqhcV$hT*j&$GVRyrrS`7g)uh-@j~3A?XVN+9S>MrN0;)F9e%O&H<_sv3 zFgZ8cf`s^pEq5*OpA29D8n?UuOzD4=^X2hS?$Q6c5`{=b*(;=L8HC7|E!+rKcG>rl zea#k1cExRwEriOJb*y9GDuk?Km#Z+wSjRfwGxzoT`}fcH&#yndo*AC!IiGXh%Q=U3 z^0upX#kPIUou!o0*~nq5?y@Fgb+`;K&tFPRnF2hzX6~oPUltB18eEcElMFiCFC4O; zL;fkS(YKt{61q=7FvfSf1BmuNA-qIw%MNYkqt4n3r2CV8vOv2&WRQ&&TJ1c(d>>mL zrp|%c6Gr8{ML3YsP~2OcH5gW9&@PeK)$SP%Q?VHxdcYEeWlglkD3ARv4%y=#N~bY~ z_=Lr&d?G%&e&sJR7<0-tr&6|RB(ys8_Bo%ESls0yW%4I~N#UmXP*SR*O=2u?n37Ix zn4X|a9*i<2e=E+N_YDryhMng{NwE5o;Y3{$f$Rh9khY_Zj3vylxq~TJG)o2H}^MKYOj( zKhpoFvs*^yw%lSCaxT<=R#-M@&3%)lOfl&*Ks{M8)3%{$g@5+0%M5jOY|}wEj#nXeMAG7j2gwX}LE6*xWAys^R+8!NYjc?5W%()xwavrrhhd1S zaBd#T_9NA1s6`JQ5YPNKdM=y$J(+GS9yO0PaV{Ik-VIlfl6_0Jj}!9ZDnz3@Nz>DJ zQYC5SL}cH3^qXY`u08)3*E3~q;i=i3$lg=G-eF&Dy*x@3v{lm%HAy>Hl7-Eb>z!E8 z>WlwS^f0t?Qb9Im{e-AQQsb&c2-#8+#$s>Uvz;dA-j$vsX>nG1|6eB&#tPMrA4(pU z#sX#NsXbY!CYQZj{)HEXoW1-PDowr-5A+xib=f}LOBWrMnL>n_va2F*&>|}2J!Zq= zz(@n(;pXhr`xACVK~wduiBQr(W`}z}{S@ZjAfaibj-{d5}KB(1ns=8!M z10`k-PV9A`IGPkoYDk_m2lsuth8egW6w*RrMX`SeT?sREe ze=>p98Pzw;&HWYzfc`NMhsHa5Pjg+qWD@WbKO`vb9nrhxrW=~-Dfi)(YD7B5v5gha_Z=Hz)&2)cdUjgb;i{lauxW30I zXt|)uo0{mM!Z`M00~!ewkh|ZMU%8{d(AmpHW8Wmt8cRlIfG6Ao8)+ijf#Jb?_mjP` zs>9vB$C&Y_@k2>Wg8Hgyl)w`~R3gh2%}6$icMS*(W58D9D+|NNXB$dRLzxAp<)s+t z%jZ%)v6jEiZ2X~v#6i(m-qQcPb;IoQCUrR7Bx`*DT3~f4-;(Qkg4mbh_jRmHxi5lcH6V|mdj^`^#*z@W$j;yW`7JZ63tiwi<0uw3HB~F}5iurZ)CGcmPf*We)*Yc6C?5;wf-)7~T zdi(gNv4v@-k647k`3T>zjPo*CLBIGp8}SsSGnkiO@2t11ZVgBlhB6Gug?m>a^CBg!J=EyQ^aRIT5xpz`|x@r@o4whm20QuvE zKZMPi(ke??qY%Ug|2#Y$o>OI9Xl5(DrMh|ahD|DvU~(UiOzx%8W%R;)E~r_lLNL95 zfT|m>ss4Bh0)R(B(l?+n)wlDjx}?MJw$F9>XUAM;l>z2)%0Hzc>ur5q*0BX8MOD{y zR!C#kOMYhsIR-~ZwS=7PSfWRha``RQ0!{nfQ;fbTh~Lc`>=#YHCz7$V3C(s>>%Y1- zh_;)4MC-pDYA@O`)d~6x2CjHj{KJWlz7q?5p&iz}PvfQw`oe==PDl0$#s6Ai>wrA( zq=*If=qi zq}*kTf4i-p8oBtjw5%a4vK3y9sXdwabH>P}JnK2fs^xXPYiV~g!ZD@bSh6d-&uRWuW< z6a&21jMR~Oa;3AsL4tgST~sFN1j)VVwN=pz{0Sx6-R&oDw6i2)N0faDmU3&>5?G% z@G;WO8{&h*a|Q{-o%=Udke_s%(K!%-fYC|cX&^J*?tf!4R6X7wJIag6Dmb&<>txu9 z))ow}dSm2;F*bg<+S&;aj^lA~#1)`b#2?-jk@DpJU#!b(qTgHA^%5?L@Jx&E z07yP>^Kt`-D;cUmSlgaugeT7DSl3rf2biyyl9M|W9&aKAg+ zmwpugK0oKY%p}&mu!vw!Kt$(MkY}rM*y9|p`6yv?@s>$|=2Zb(2zgIF!D{6eXCs$>LBlKR$41{) zhtbd5RxQ$SQy00GzQ%;tuY6G@x!)|Vb{NSZYa?qf$^6wQvsL*zHB89OKyQ~C8QNFI*_oE&tVy(VFV(t}yAcN2O+(BF z2n`|93L9(hqRac2YKgPdd94)2x*LNZy^Iqz8lB$y*3n8!P(U|z=9<6HEatJ)XJp`L zsma!z9E}-t@VcH2{<@og%E192jZy_}dalPvQDMOEZeTL6_SWHK8M7keXSW)O-=Lwv z*@*s__LDTmDI9KgnQl@*h4HldkjqyY#f;E=zP&VJzIdpF@1Lr=bDQ?0CClp6WUD}H zXVwShMqRxQaV=k(q&1!=LEQ2RnO{3T8~*Gj*WELUj3C+&ey43+?OvN=#k&J@_3+xY z`5u%XVquHrJ{#p$BLCKonLcWu{^kq~U@k>*R8tVorSo}ymi`k1YSspU-qvFKUKKh6 z*pB{kpxCKzkAKxm3_M;!2@pj6xl;rAnoH_LjsMsMPl2jgH+N+IGuC}u=SZ&=lk@tg zpyQ_w*F>A-VXEejn#Y;5M%fL~_e$@EK#3ii@O;y0G8>N|?9i)+-aY|waW365mBWou2(&m#<$)qE_q5`ShoA(Vxs_ zlu6^Co;rGyRbFll$4{nduIjNGRc!3(84n|m_IY$W2saK-b==_zSX~^Zc~RMXfs6gB z@|a7?Ws_h?5Xnah$J?>AS4}_Tr|PBa%op;8EttjYUe_C&igd49=VGK%IvzrY>0beVfrPqn&DRm^7bCAO1q(YbOkCx*g!8SZ@0!G?`OK_!&PsnS^KMRU4pd~p|J5g zGT-580H!QYrNgfc9Oom^Np5QlYm*qhFSmE`lgy;YBNNFk?L9LSMK2WtFT{LW_;*@( zsu4>Cy0yM8Y^$PAf(gL$?Mu6S%^tkE9bSpqJ>%9jA2H1Rf6GjnbCK^FM5jlFs2i8g zux}W&4~6-I=pMJER?6z*{Gb6Am}# ze|x27WVMDKP9PmWm8qt+lRc5du|)V%_NmGnLXLQs+2;ceckug5GF&!$HNN9G0w<;c zU7c4hjIrB2$;57qjHHA8Lp(aN^WLK;3l|U-u<7#YnMm%h=Ro$JcQwRUkec65aI}RS z90Y>e>wma7Ok5}`a{N#fIpL_p4V~*;E#QvjmR|{3Odq)ISf(pkbeVxu`k8if?K2=S z7Ur1O8E2^$*ou$lMpy{*A1ldm7>7;X(MyY*T&Z%E29oOl*A zE&utCY80oWBP1yrx4+pCx4#9LVFFk{YEN;S(J*%qO(zTuC+6mq+D|CT3`SqmHN^zH z*7AJjzpsAXvCLqChB5TwR!@1m)Xoy`^R^3S^&T<-(_l*sB?QA4e+SkD>u1`z=BjD2mE| zln233kx@;g3(`xn24d<4Qt}X#NYYepaJ?%_YK-_O8IQYWq z>gBjkl=e%OvpUkbvYvM@cW;cVRD?PlH5$kscThsZfgz9MP0l@qgWXu-#SsO?Q)aYpNvjas}lp>x{C0w+H(11%7cb<+nqWFF<&lhja_?#XlI<$LglWosr_m zcXayj)x`cak@GhfXXlS9T1aOGMN~c`Z{Rd&g}gt=WXXyYRpUVO#Q1OK*wm8d%(u50 zS{Jw4xuZYud*wD&OH0Qd!9}Ou2_p^mk%{s&*`cl}m`?T?^u?0O*y}9VsDC>PIl~0M zeqJ8TDuI&-Mz#~hJ^chN;RMd9ScsNE8L89R2nrYuTlo@GoNf&trKR3miy|p}tA&IO zy7?Nf!H-A!?{aG1a=9Tp9L4$C4QjNV_2fJjPJRlPl3{A>t#l1C1bWEciK?+D2i|mW zL{zV*nC*kysK|O&7wnIu!E3)dj;XCGjR_+orl}r*NlVONu|gJ#q&|;}IQK61TUzA{ zi$LVm2S)N}4YiQQZyd!wi`(nh@Zn?x({Q(0|(#qw%j_T$qMmJEfgK@ms zi%q`S{VK(0zr#^pIqE9$@Go!p0|;OQrKg4?81IQ(x-ZTe!4u6dAf##&tYzMSdeMHt zdzapFaw(GHRKnjfl4xDJ}wwU{VF!UBq%R1*}^1)sXeU zf&?)YW?N`6>Y&(#&5LSkYPECGv^k2u`{AnWrOc5bZ67RW&Q*UvJx@5W62GEjyxviO z>WWjfkI8-K=YASo6-~6mzb%#4dFg}~GHQ79^ zu8Er8qUMgi?!s%(=O?pE6%P9Y!3H;oH6G3y|LOx)V@5*|2N<%XVFvTQI>rnGPV%C! z3%alWzC;zepO+1HWDO<>*>&3C9Exm%oy_o~x-#12N_1GAfisx1=Pt?q-;ihS^`E;3 z?weDp6oiw*7whjIeC_Uh_21>(>pQ)8IH>>kufTzb?c~)C)``Ju8_SJtQ zn^7_Mq?mfgTZe$185`|$u`9aaOP)0) z?-XZIhHk9?n_I{K|7~~wyAAAfBr4d*w{l literal 0 HcmV?d00001 diff --git a/docs/images/dessin.svg b/docs/images/dessin.svg new file mode 100644 index 000000000..393c86364 --- /dev/null +++ b/docs/images/dessin.svg @@ -0,0 +1,385 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Read Write + Structure + hidden + disabled + Read Only + + + + + + \ No newline at end of file diff --git a/docs/vac.rst b/docs/vac.rst index 64e920008..69dc29b5b 100644 --- a/docs/vac.rst +++ b/docs/vac.rst @@ -1,22 +1,15 @@ Variables as Code ================== -.. - - To do this, we need a typed variable definitions with defaults and validation. - - Once defined, variables must be able to: - - - provide useful information to the operator to make their choices - - load user values from differents sources - - validate the context - - display and archive the final values in a readable format - - allow other applications to use these variables Definition -------------- -**Variables as Code** is the practice of managing configuration variables the same way you treat source code. +.. glossary:: + + VaC + + VaC stands for **Variables as Code**, it is the practice of managing configuration variables the same way you treat source code. It is a concept that extends the Infrastructure as Code (IaC) philosophy to the management of configuration variables, secrets, and environment-specific settings. More precisely, this extends Configuration as Code (CaC) principles. @@ -24,24 +17,38 @@ More precisely, this extends Configuration as Code (CaC) principles. The idea is to treat variables β€” not just infrastructure or configuration β€” as version-controlled, declarative, and automated code rather than manual, static, or hardcoded values. With growing complexity of the infrastructure, it is difficult to manage all the variables. +Due to more and more available variables required to set up the infrastructure, +it became quite annoying to hand the necessary variables to where they are actually used +and even more annoying to add new variables. + Variables can be redundant and sometimes are defined on several places. +Ansible collections +------------------------- + A typical example is the management of Ansible collections. Currently, when you distribute an Ansible collection, you distribute the recipes that allow you to deploy a component, the default values ​​for certain variables, and possibly variable validation. However, you don't share the variable declarations. Therefore, each user would have to rewrite the user documentation, define the global context themselves, and so on. It is therefore the user's responsibility to maintain the consistency of the variables with these given problems. -And I'm not even talking about managing variables in a multi-project context. +And we're not even talking about managing variables in a multi-project context. It is often necessary to recreate the same variables with the same constraints over and over again between different projects. +Variables as Code with Rougail +----------------------------------- + For this, we thought of a solution and came up with a concept of managing all our variables as a code called VaC (Variables as Code). -Often when we talk about VaC (or CaC) we think of the different environments (Development, Staging, Production). +Often when we talk about :term:`VaC` (or CaC) we think of the different environments (Development, Staging, Production). -With Rougail, this question does not arise. Essentially, Rougail manages this with user data. Here I'm talking about sharing variables between projects. +With Rougail, this question does not arise. Essentially, Rougail manages this with user data. +Here we're talking about sharing variables between projects. -To do this, we need a typed variable definitions with defaults and validation. +Furthermore, using a tool like Rougail allows you to use variables with different IaC deployment solutions without having to redefine those variables. +It can be said that Rougail allows you to use variables not only between projects but also between tools. + +To do this, we need typed variable definitions with defaults and validation. Once defined, variables must be able to: @@ -50,3 +57,5 @@ Once defined, variables must be able to: - validate the context - display and archive the final values in a readable format - allow other applications to use these variables + +