+
    =l j+.  ã                   ój  € ^ RI t ^ RIt^ RIHtHtHtHtHt ^ RIH	t	H
t
HtHt ^ RIHt ^ RIHt ^ RIHt ^ RIHtHt ^ RIHt ^ R	IHtHtHtHtHtHtHt . R,Ot R
t! ! R R]4      t" ! R R]]4      t#R R lt$R R lt%R R lt&R R lt'R R lt(]! RR](RR7      t)RRRRR R!R"]#R#]R$3.R%R&R'R(R)R*R+^/	t*R# )-é    N)ÚDictÚListÚOptionalÚTupleÚUnion)ÚaptÚ
exceptionsÚmessagesÚsystem)ÚAPIEndpoint)ÚAdditionalInfo)ÚUnattendedUpgradesError)Úget_apt_config_keysÚget_apt_config_values)ÚUAConfig)ÚBoolDataValueÚ
DataObjectÚDatetimeDataValueÚFieldÚIntDataValueÚStringDataValueÚ	data_listz#/var/lib/apt/periodic/upgrade-stampc                   ó^   a € ] tR t^t o ]! R]RR7      ]! R]RR7      .tV 3R lR ltRtV t	R	# )
Ú UnattendedUpgradesDisabledReasonÚmsgzHuman readable reason©ÚdocÚcodezReason codec                ó&   <€ V ^8„  d   QhRS[ RS[ /# )é   r   r   )Ústr)ÚformatÚ__classdict__s   "€ÚN/usr/lib/python3/dist-packages/uaclient/api/u/unattended_upgrades/status/v1.pyÚ__annotate__Ú-UnattendedUpgradesDisabledReason.__annotate__%   s   ø€ ÷ ñ ™Cð ¡sñ ó    c                ó   € Wn         W n        R # ©N©r   r   )Úselfr   r   s   &&&r$   Ú__init__Ú)UnattendedUpgradesDisabledReason.__init__%   s   € ØŒØŽ	r'   )r   r   N)
Ú__name__Ú
__module__Ú__qualname__Ú__firstlineno__r   r   Úfieldsr,   Ú__static_attributes__Ú__classdictcell__©r#   s   @r$   r   r      s/   ø‡ € áˆe�_Ð*AÔBÙˆf�o¨=Ô9ð€F÷
ö r'   r   c                   óæ   a € ] tR t^*t o ]! R]RR7      ]! R]RR7      ]! R]RR7      ]! R]R	R7      ]! R
]! ]4      RR7      ]! R]RR7      ]! R]	RRR7      ]! R]
RRR7      .tV 3R lR ltRtV tR# )ÚUnattendedUpgradesStatusResultÚsystemd_apt_timer_enabledz4Indicate if the ``apt-daily.timer`` jobs are enabledr   Úapt_periodic_job_enabledzFIndicate if the ``APT::Periodic::Enabled`` configuration is turned offÚ$package_lists_refresh_frequency_dayszFThe value of the ``APT::Periodic::Update-Package-Lists`` configurationÚ"unattended_upgrades_frequency_dayszDThe value of the ``APT::Periodic::Unattended-Upgrade`` configurationÚ#unattended_upgrades_allowed_originszFThe value of the ``Unattended-Upgrade::Allowed-Origins`` configurationÚunattended_upgrades_runningzRIndicate if the ``unattended-upgrade`` service is correctly configured and runningÚ#unattended_upgrades_disabled_reasonFzyObject that explains why ``unattended-upgrades`` is not running -- if the application is running, the object will be null)Úrequiredr   Úunattended_upgrades_last_runz)The last time ``unattended-upgrades`` ranc                óŽ   <€ V ^8„  d   QhRS[ RS[ RS[RS[RS[S[,          RS[ RS[S[,          RS[S[P                  ,          /# )	r    r8   r9   r:   r;   r<   r=   r>   r@   )ÚboolÚintr   r!   r   r   Údatetime)r"   r#   s   "€r$   r%   Ú+UnattendedUpgradesStatusResult.__annotate__k   s~   ø€ ÷ Iñ Iñ $(ðIñ #'ð	Iñ
 /2ðIñ -0ðIñ .2±#­YðIñ &*ðIñ .6Ù,õ.
ðIñ '/©x×/@Ñ/@Õ&AñIr'   c               ón   € Wn         W n        VV n        VV n        VV n        W`n        VV n        W€n        R # r)   )r8   r9   r:   r;   r<   r=   r>   r@   )	r+   r8   r9   r:   r;   r<   r=   r>   r@   s	   &$$$$$$$$r$   r,   Ú'UnattendedUpgradesStatusResult.__init__k   sS   € ð *CÔ&Ø(@Ô%à0ð 	Ô1ð /ð 	Ô/ð 0ð 	Ô0ð ,GÔ(à/ð 	Ô0ð -IÖ)r'   )r9   r:   r8   r<   r>   r;   r@   r=   N)r.   r/   r0   r1   r   r   r   r   r   r   r   r2   r,   r3   r4   r5   s   @r$   r7   r7   *   sÇ   ø‡ € áØ'ØØFô	
ñ
 	Ø&Øðô		
ñ 	Ø2Øð!ô		
ñ 	Ø0Øð!ô		
ñ 	Ø1Ù�oÓ&ð!ô		
ñ 	Ø)Øð*ô		
ñ 	Ø1Ø,Øðô		
ñ 	Ø*ØØØ;ô		
ðq>€F÷@Iö Ir'   r7   c                ó$   € V ^8„  d   QhR\         /# ©r    Úreturn)rB   )r"   s   "r$   r%   r%   ‹   s   € ÷ %ñ %¤4ñ %r'   c                  óÜ   €  \         P                  ! R 4      p \         P                  ! R4      pT ;'       d    TpV#   \        P                   d   p\	        \        T4      R7      hRp?ii ; i)zapt-daily.timerzapt-daily-upgrade.timer)Ú	error_msgN)r   Úis_systemd_unit_activer	   ÚProcessExecutionErrorr   r!   )Úapt_daily_job_enabledÚapt_daily_upgrade_job_enabledr8   Úes       r$   Ú_get_apt_daily_job_statusrR   ‹   ss   € ð8Ü &× =Ò =Øó!
Ðô )/×(EÒ(EØ%ó)
Ð%ð "×CÐCÐ&Cð 	"ð %Ð$øô ×+Ñ+ô 8Ü%´°A³Ô7Ð7ûð8ús   ‚4< ·< ¼A+ÁA&Á&A+c          	      óâ   € V ^8„  d   QhR\         R\        \        \        \        \        \        ,          3,          3,          R\
        \         \        \        P                  ,          3,          /# )r    r8   Úunattended_upgrades_cfgrJ   )	rB   r   r!   r   r   r   r   r
   ÚNamedMessage)r"   s   "r$   r%   r%   œ   sR   € ÷ ñ Ü#ðä!¤#¤u¬S´$´sµ)¨^Õ'<Ð"<Õ=ðô Œ4”œ(×/Ñ/Õ0Ð0Õ1ñr'   c                 ó`  € V '       g   R \         P                  3# \         F‰  pVP                  V4      p\	        V\
        4      '       d-   V'       g%   R \         P                  P                  VR7      3u # VR8X  g   V'       d   Kg  R \         P                  P                  VR7      3u # 	  R# )F)Úcfg_nameÚ0)TN)	r
   Ú(UNATTENDED_UPGRADES_SYSTEMD_JOB_DISABLEDÚUNATTENDED_UPGRADES_CONFIG_KEYSÚgetÚ
isinstanceÚlistÚ(UNATTENDED_UPGRADES_CFG_LIST_VALUE_EMPTYr"   Ú(UNATTENDED_UPGRADES_CFG_VALUE_TURNED_OFF)r8   rT   ÚkeyÚvalues   &&  r$   Ú_is_unattended_upgrades_runningrb   œ   sª   € ÷ %Ø”x×HÑHÐIÐIç.ˆØ'×+Ñ+¨CÓ0ˆÜ�eœT×"Ò"¯5àÜ×AÑA×HÑHØ ð Ió ðò ð �CŒ<Ÿu™uàÜ×AÑA×HÑHØ ð Ió ðò ñ /ð" Ðr'   c                óN   € V ^8„  d   QhR\         \        P                  ,          /# rI   )r   rD   )r"   s   "r$   r%   r%   ·   s   € ÷ ;ñ ;¬8´H×4EÑ4EÕ+Fñ ;r'   c                  ó¬   €  \         P                  P                  \        4      p \
        P
                  P                  T 4      #   \         d     R # i ; ir)   )ÚosÚpathÚgetctimeÚUNATTENDED_UPGRADES_STAMP_PATHÚFileNotFoundErrorrD   Úfromtimestamp)Úcreation_epochs    r$   Ú!_get_unattended_upgrades_last_runrl   ·   sI   € ðÜŸ™×)Ñ)Ô*HÓIˆô ×Ñ×*Ñ*¨>Ó:Ð:øô ô Úðús   ‚#A ÁAÁAc                ó$   € V ^8„  d   QhR\         /# rI   )r7   )r"   s   "r$   r%   r%   À   s   € ÷ ñ Ô.ñ r'   c                  ó(   € \        \        4       4      # r)   )Ú_statusr   © r'   r$   Ústatusrq   À   s   € Ü”8“:ÓÐr'   c                ó0   € V ^8„  d   QhR\         R\        /# )r    ÚcfgrJ   )r   r7   )r"   s   "r$   r%   r%   Ä   s   € ÷ _&ñ _&”ð _&Ô<ñ _&r'   c                óZ  € \         P                  ! R4      '       gO   \        RR^ ^ . \        \        P
                  P                  \        P
                  P                  R7      RRR7      # \        4       p\        4       p\        \        \        \        R4      ,           4      4      pVR,          ;'       g    RVR&   VR	,          ;'       g    . VR	&   \        W4      w  ppV'       d#   \        VP                  VP                  R7      pMRp\        T\        VP!                  RR
4      4      R8H  \#        VP!                  R4      ;'       g    ^ 4      \#        VP!                  R4      ;'       g    ^ 4      \%        VP!                  R	4      ;'       g    . 4      VVVR7      pRV/Vn        V# )aÕ  
This endpoint returns the status around ``unattended-upgrades``. The focus
of the endpoint is to verify if the application is running and how it is
configured on the machine.

.. important::

    For this endpoint, we deliver a unique key under ``meta`` called
    ``raw_config``. This field contains all related ``unattended-upgrades``
    configurations, unparsed. This means that this field will maintain both
    original name and values for those configurations.
zunattended-upgradesFr*   N)r8   r9   r:   r;   r<   r>   r=   r@   zUnattended-UpgradeúAPT::Periodic::EnableÚ1ú#Unattended-Upgrade::Allowed-OriginsÚ ú#APT::Periodic::Update-Package-Listsú!APT::Periodic::Unattended-UpgradeÚ
raw_config)r   Úis_installedr7   r   r
   ÚUNATTENDED_UPGRADES_UNINSTALLEDr   ÚnamerR   rl   r   ÚsetrZ   r   rb   r!   r[   rC   r]   Úmeta)rs   r8   r@   rT   r=   Údisabled_reasonr>   Úunattended_upgrades_results   &       r$   ro   ro   Ä   sã  € ô ×ÒÐ1×2Ò2Ü-Ø&+Ø%*Ø12Ø/0Ø02Ü0PÜ×<Ñ<×@Ñ@Ü×=Ñ=×BÑBô1ð ).Ø)-ô
ð 	
ô !:Ó ;ÐÜ#DÓ#FÐ ä3ÜÜ+Ü!Ð"6Ó7õ8ó	
óÐð 	 Ð 7Õ8×?Ð?¸Cð Ð3Ñ4ð 	 Ð EÕF×LÐLÈ"ð ÐAÑBô 	(Ø!ó	ñØ#Ø÷
 Ü.NØ×#Ñ#Ø ×%Ñ%ô/
Ñ+ð
 /3Ð+ä!?Ø";Ü!$Ø#×'Ñ'Ð(?ÀÓDó"
ð ñ"ô .1Ø#×'Ñ'Ø5ó÷ ð ð ó	.
ô ,/Ø#×'Ñ'Ø3ó÷ ð ð ó	,
ô -1Ø#×'Ñ'Ð(MÓN÷ ð Øó-
ð
 0à$?Ø%Aô5"Ðð8 (4Ð5LÐ&MÐÔ#à%Ð%r'   Úv1ÚUnattendedUpgradesStatus)Úversionr~   ÚfnÚoptions_clsÚintroduced_inz27.14Úrequires_networkFÚexample_pythonzT
from uaclient.api.u.unattended_upgrades.status.v1 import status

result = status()
Úresult_classr	   zYRaised if we cannot run a necessary command to show the status of ``unattended-upgrades``Úexample_cliz'pro api u.unattended_upgrades.status.v1Úexample_jsona@  
{
    "apt_periodic_job_enabled": true,
    "package_lists_refresh_frequency_days": 1,
    "systemd_apt_timer_enabled": true,
    "unattended_upgrades_allowed_origins": [
        "${distro_id}:${distro_codename}",
        "${distro_id}:${distro_codename}-security",
        "${distro_id}ESMApps:${distro_codename}-apps-security",
        "${distro_id}ESM:${distro_codename}-infra-security"
    ],
    "unattended_upgrades_disabled_reason": null,
    "unattended_upgrades_frequency_days": 1,
    "unattended_upgrades_last_run": null,
    "unattended_upgrades_running": true
}
ÚextraaÈ  
- Possible attributes in JSON ``meta`` field:

  .. code-block:: json

     {
         "meta": {
             "environment_vars": [],
             "raw_config": {
                 "APT::Periodic::Enable": "1",
                 "APT::Periodic::Unattended-Upgrade": "1",
                 "APT::Periodic::Update-Package-Lists": "1",
                 "Unattended-Upgrade::Allowed-Origins": [
                     "${distro_id}:${distro_codename}",
                     "${distro_id}:${distro_codename}-security",
                     "${distro_id}ESMApps:${distro_codename}-apps-security",
                     "${distro_id}ESM:${distro_codename}-infra-security"
                 ]
             }
         }
     }
Úextra_indent)ru   ry   rz   rw   )+rD   re   Útypingr   r   r   r   r   Úuaclientr   r	   r
   r   Úuaclient.api.apir   Úuaclient.api.data_typesr   Úuaclient.api.exceptionsr   Úuaclient.aptr   r   Úuaclient.configr   Úuaclient.data_typesr   r   r   r   r   r   r   rZ   rh   r   r7   rR   rb   rl   rq   ro   ÚendpointÚ_docrp   r'   r$   Ú<module>rš      sð   ðÛ Û 	ß 5Õ 5ç 6Ó 6Ý (Ý 2Ý ;ß CÝ $÷÷ ñ ò#Ð ð "GÐ ô zô ô^I Z°ô ^IõB%õ"õ6;õõ_&ñD ØØ	#ØØô	€ð �WØ˜Øð ð
 Ð2Øà#Øgð	
ðð Ð<Øð ð" ð ð, �Aðo8‚r'   