Vhz%ddlmZmZmZeZdZdZdZddl m Z ddl Z ddl m Z ddlZdZGd d eZd Zed k(reyy) )absolute_importdivisionprint_functiona module: mas short_description: Manage Mac App Store applications with mas-cli description: - Installs, uninstalls and updates macOS applications from the Mac App Store using the C(mas-cli). version_added: '0.2.0' author: - Michael Heap (@mheap) - Lukas Bestle (@lukasbestle) extends_documentation_fragment: - community.general.attributes attributes: check_mode: support: full diff_mode: support: none options: id: description: - The Mac App Store identifier of the app(s) you want to manage. - This can be found by running C(mas search APP_NAME) on your machine. type: list elements: int state: description: - Desired state of the app installation. - The V(absent) value requires root permissions, also see the examples. type: str choices: - absent - latest - present default: present upgrade_all: description: - Upgrade all installed Mac App Store apps. type: bool default: false aliases: ["upgrade"] requirements: - macOS 10.11 or higher. - "mas-cli (U(https://github.com/mas-cli/mas)) 1.5.0+ available as C(mas) in the bin path" - The Apple ID to use already needs to be signed in to the Mac App Store (check with C(mas account)). - The feature of "checking if user is signed in" is disabled for anyone using macOS 12.0+. - Users need to sign in to the Mac App Store GUI beforehand for anyone using macOS 12.0+ due to U(https://github.com/mas-cli/mas/issues/417). a - name: Install Keynote community.general.mas: id: 409183694 state: present - name: Install Divvy with command mas installed in /usr/local/bin community.general.mas: id: 413857545 state: present environment: PATH: /usr/local/bin:{{ ansible_facts.env.PATH }} - name: Install a list of apps community.general.mas: id: - 409183694 # Keynote - 413857545 # Divvy state: present - name: Ensure the latest Keynote version is installed community.general.mas: id: 409183694 state: latest - name: Upgrade all installed Mac App Store apps community.general.mas: upgrade_all: true - name: Install specific apps and also upgrade all others community.general.mas: id: - 409183694 # Keynote - 413857545 # Divvy state: present upgrade_all: true - name: Uninstall Divvy community.general.mas: id: 413857545 state: absent become: true # Uninstallation requires root permissions z # ) AnsibleModuleN) LooseVersionz12.0cTeZdZdZdZdZdZdZdZdZ dZ d Z d Z d Z d Zy )Masc||_|jjd|_d|_t j dxsd|_d|_d|_d|_ d|_ d|_ ddi|_ |jy)NmasFrz0.0changed)module get_bin_pathmas_path_checked_signinplatformmac_ver _mac_version _installed _outdated count_install count_upgradecount_uninstallresultcheck_mas_tool)selfr s i/home/dcms/DCMS/lib/python3.12/site-packages/ansible_collections/community/general/plugins/modules/mas.py__init__z Mas.__init__us  007 $$,,.q1:U  u   c`|jjs~|dk7r|j|j|t |g\}}}|dk7rD|jj dj |t ||j|jd|zxxdz cc<y)zY Runs a `mas` command on a given app; command can be 'install', 'upgrade' or 'uninstall' uninstallrz-Error running command '{0}' on app '{1}': {2}msgcount_N) r check_mode check_signinrunstr fail_jsonformatrstrip__dict__)rcommandidrcouterrs r app_commandzMas.app_commands{{%%+%!!#88Wc"g$67LBSQw %%GNNwX[\^X_adakakamn& h()Q.)rcP|js|jjd|jdg\}}}|dk7s5|j r%t |j t dkr.|jjd|j zyy)z? Verifies that the `mas` tool is available in a recent version z$Required `mas` tool is not installedr!versionrz1.5.0z)`mas` tool in version 1.5.0+ needed, got N)rr r)r'striprrr/r0r1s rrzMas.check_mas_tools}} KK ! !&L ! Mxx , C 7#))+ciik)B\RYEZ)Z KK ! !&QTWT]T]T_&_ ! `*[rcl|jryt|jttk\r#|jj dd |_y|j dg\}}}|jdddjdk(r|jjd d |_y) z: Verifies that the user is signed in to the Mac App Store NzYWARNING: You must be signed in via the Mac App Store GUI beforehand else error will occuraccount r$rz Not signed inz*You must be signed in to the Mac App Storer!T) rrr#NOT_WORKING_MAC_VERSION_MAS_ACCOUNTr logr'splitr+r)r6s rr&zMas.check_signins     )) *l;^._ _ KKOOw x $  88YK0LBSyyq!!$++-@ %%*V%W#rcg}|jdkDr*|jdj|j|jdkDr*|jdj|j|jdkDr*|jdj|j|r-d|j d<dj ||j d<|jjd i|j y ) z0 Exit with the data we have collected over time rzInstalled {0} app(s)zUpgraded {0} app(s)zUninstalled {0} app(s)Tr z, r"N) rappendr*rrrjoinr exit_json)rmsgss rexitzMas.exits    ! KK.55d6H6HI J    ! KK-44T5G5GH I   ! # KK0778L8LM N %)DKK "!%4DKK  , ,rc|j|g\}}}|jd}|ddk(rg}g}|D]@}|jdd}t|dk(s$|jt |dB|S)zM Returns the list of all app IDs; command can either be 'list' or 'outdated' r9rzNo installed apps found r$)r'r<lenr?int)rr-r/raw_appsr1rowsappsrs rget_current_statezMas.get_current_states!HHgY/Hc~~d# 7/ /D 'AQA1v{ C!I&  '  rc^|j|jd|_|jS)z$ Returns the list of installed apps list)rrMrs r installedz Mas.installeds* ?? ""44V> !!33J?DN~~rcr|jd|j|jj|dS)z" Runs a command of the `mas` tool rF)insertrr run_command)rcmds rr'zMas.runs- 1dmm${{&&sE22rc<|j}|jjsX|j|j dg\}}}|dk7r-|jj d|j z|xjt|z c_y)z> Upgrades all installed apps and sets the correct result data upgraderzCould not upgrade all apps: r!N) rVr r%r&r'r)r+rrG)rrVr/r0r1s r upgrade_allzMas.upgrade_alls{==?{{%%    88YK0LBSQw %%*H3::<*W%X c(m+rN)__name__ __module__ __qualname__rr2rr&rCrMrQrTrWrVr'r_r>rrr r ss?$/ a $-" + * 3 ,rr c Ptttddtddgdtdd d g  d }t|}|jdr|jd}ng}|jd}|jd}t t |D]}|dk(r%|j |r|jd|-|dk(rN|j |sDtjdk7r|jd|jd||dk(s|j |s|jd||j|s|jd |d|_ |r |jr|j|jy)NrOrH)typeelementsr(present)absentlatestrf)rddefaultchoicesboolFr^)rdrialiases)r.stater_T) argument_specsupports_check_moder.rmr_installrgrz]^&%)M ! F f+C }}T}}T" MM' "EmmM*Gc$i 0 I ##C( 3/ h $99;!#$$)g$h S1 h ##C( 3/% 3/#0(CM3<<> HHJr__main__) __future__rrrrd __metaclass__ DOCUMENTATIONEXAMPLESRETURNansible.module_utils.basicrruBansible_collections.community.general.plugins.module_utils.versionrrr:objectr rxr`r>rrrseA@ - ^* X 4 [&,#N,&N,b-` zFr