Vh;:ddlmZmZmZeZdZdZddlmZddl Z ddl m Z ddl m Z mZGdd eZGd d eZd Zed k(reyy))absolute_importdivisionprint_functiona module: osx_defaults author: # DO NOT RE-ADD GITHUB HANDLE! - Franck Nijhof (!UNKNOWN) short_description: Manage macOS user defaults description: - This module allows users to read, write, and delete macOS user defaults from Ansible scripts. - MacOS applications and other programs use the defaults system to record user preferences and other information that must be maintained when the applications are not running (such as default font for new documents, or the position of an Info panel). extends_documentation_fragment: - community.general.attributes attributes: check_mode: support: full diff_mode: support: none options: domain: description: - The domain is a domain name of the form C(com.companyname.appname). type: str default: NSGlobalDomain host: description: - The host on which the preference should apply. - The special value V(currentHost) corresponds to the C(-currentHost) switch of the defaults commandline tool. type: str key: description: - The key of the user preference. type: str type: description: - The type of value to write. type: str choices: [array, bool, boolean, date, float, int, integer, string] default: string check_type: description: - Checks if the type of the provided O(value) matches the type of an existing default. - If the types do not match, raises an error. type: bool default: true version_added: 8.6.0 array_add: description: - Add new elements to the array for a key which has an array as its value. type: bool default: false value: description: - The value to write. - Only required when O(state=present). type: raw state: description: - The state of the user defaults. - If set to V(list) will query the given parameter specified by O(key). Returns V(null) is nothing found or mis-spelled. type: str choices: [absent, list, present] default: present path: description: - The path in which to search for C(defaults). type: str default: /usr/bin:/usr/local/bin notes: - Apple Mac caches defaults. You may need to logout and login to apply the changes. a - name: Set boolean valued key for application domain community.general.osx_defaults: domain: com.apple.Safari key: IncludeInternalDebugMenu type: bool value: true state: present - name: Set string valued key for global domain community.general.osx_defaults: domain: NSGlobalDomain key: AppleMeasurementUnits type: string value: Centimeters state: present - name: Set int valued key for arbitrary plist community.general.osx_defaults: domain: /Library/Preferences/com.apple.SoftwareUpdate key: AutomaticCheckEnabled type: int value: 1 become: true - name: Set int valued key only for the current host community.general.osx_defaults: domain: com.apple.screensaver host: currentHost key: showClock type: int value: 1 - name: Defaults to global domain and setting value community.general.osx_defaults: key: AppleMeasurementUnits type: string value: Centimeters - name: Setting an array valued key community.general.osx_defaults: key: AppleLanguages type: array value: - en - nl - name: Removing a key community.general.osx_defaults: domain: com.geekchimp.macable key: ExampleKeyToRemove state: absent )datetimeN) AnsibleModule) binary_type text_typeceZdZdZy)OSXDefaultsExceptionc||_y)N)message)selfmsgs r/home/dcms/DCMS/lib/python3.12/site-packages/ansible_collections/community/general/plugins/modules/osx_defaults.py__init__zOSXDefaultsException.__init__s  N)__name__ __module__ __qualname__rrrr r srr cleZdZdZdZedZedZdZdZ edZ dZ d Z d Z d Zy ) OSXDefaultsz& Class to manage Mac OS user defaults cd|_||_|jd|_|jd|_|jd|_|jd|_|jd|_|jd|_|jd|_ |jd |_ |jd |_ |jjd d |jjd |_|js td|jdk7r,|j!|j|j|_ yy)zN Initialize this module. Finds 'defaults' executable and preps the parameters Ndomainhostkey check_typetype array_addvaluestatepathdefaultsF:)requiredopt_dirsz%Unable to locate defaults executable.absent) current_valuemoduleparamsrrrrrrr r!r" get_bin_pathsplit executabler _convert_type)rr)s rrzOSXDefaults.__init__s" mmH- MM&) ==' -- 5MM&) {3]]7+ ]]7+ MM&) ++22 YY__S)3  &'NO O :: !++DIItzzBDJ "rct|}|jdr|ddjS|jS)N-)str startswithisdigit)r as_strs ris_intzOSXDefaults.is_ints;U   c "!":%%' '>># #rc4|dk(r t|S|dvrSt|ttfr|j }|dvry|dvryt dj t||dk(r7 tj|jd d jd S|d vrCtj|s#t dj t|t|S|dk(r t!|}|S|dk(rt|t"s t d|St dj |#t$r$t d j t|wxYw#t$r$t dj t|wxYw)z Converts value to given type string)boolboolean)Tr1true1yesT)Frfalse0noFzInvalid boolean value: {0}date+r%Y-%m-%d %H:%M:%Sz|jg|jzS)zS Returns a list containing the "defaults" executable and any common base arguments )r-rTrSs r _base_commandzOSXDefaults._base_commands 4??#444rc |j}|jd|jd|Dcgc])}tjdd|j dd+}}|Scc}w)z0 Converts array output from defaults to an list rz ^ *"?|"?,? *$z\"") splitlinespopresubreplace)r xs r_convert_defaults_str_to_listz)OSXDefaults._convert_defaults_str_to_listsd  "  !  " NSSQYYuc-BCSS Ts.A)c2|jj|jd|j|jgz\}}}|dk(ry|dk7rt d|z|j jdd}|jj|jd|j|jgz\}}}|j }|dk7rt d |z|d k(r|j|}|j|||_ y) z0 Reads value of this domain & key from defaults z read-typer1Nrz:An error occurred while reading key type from defaults: %szType is rYreadz;An error occurred while reading key value from defaults: %srG) r) run_commandrVrrr rMr_rar.r()rrcouterrrPs rrczOSXDefaults.read s{{..t/A/A/C{TXT_T_aeaiaiFj/jk C 7 7&'cfi'ij jIIK'' B7 {{..t/A/A/Cvt{{\`\d\dFe/ef Ciik 7&'dgj'jk k  44S9C"// 3?rc*t|jtr|jrd}nd}nt|jttfrt |j}n|j rA|j5tt|jt|jz }nBt|jtr|jjd}n |j}|jdk(r|j rd|_ t|ts|g}|jj|jd|j |j"d|jzgz|zd \}}}|d k7rt%d |zy) z/ Writes value to this domain & key to defaults TRUEFALSENrCrGz array-addwriter0F)expand_user_and_varsrz5An error occurred while writing value to defaults: %s)rHr r9rDrFr2rr(rOsetrstrftimerr)rdrVrrr )rr rerfrgs rrkzOSXDefaults.write,sM djj$ 'zz  S%L 1 OE ^^ 2 2 >TZZ3t/A/A+BBCE  H -JJ''(;>D../3tzz?B YY' !d&8&8&D\_`dehimisisetwz{|N|NxOfOaP]QUV]V   4:: - ;; ! ! rN)rrr__doc__r staticmethodr6r.rTrVrarcrkrprvrrrrrsr0C@$$"S"SH(5  "@Bf>g%rrctttddtdtddtddtdd gd  tddtd tdd gd tdd ddd dgff} t|}|j|j y#t $r&}|j |jYd}~yd}~wwxYw)Nr2NSGlobalDomain)rdefault)rF)rno_logr9Tr8)rGr9r:rArFrDrEr8)rr{choicesrawpresent)r'rOrz/usr/bin:/usr/local/bin) rrrrrrr r!r"r!r ) argument_specsupports_check_mode required_if)r))changed)r)rdictrrrrvr fail_jsonr )r)r#es rmainrs U,<=5!%.65(=FG6E"E9>[\5*CD  ! i' + F$(f-0 (QYY''(s,B;; C*C%%C*__main__) __future__rrrr __metaclass__ DOCUMENTATIONEXAMPLESrr]ansible.module_utils.basicransible.module_utils.sixrr Exceptionr objectrrrrrrrsfA@ F P4 l 4;9`&`R(8 zFr