VhIFddlmZmZmZeZdZdZdZddl Z ddl Z ddl m Z ddl mZmZmZddlmZdd lmZd Z dd lmZmZej6d 5ddlZdddGd deZGddeZdZ e!dk(re yy#e$rdZeZYQwxYw#1swY?xYw))absolute_importdivisionprint_functiona module: dconf author: - "Branko Majic (@azaghal)" short_description: Modify and read dconf database description: - This module allows modifications and reading of C(dconf) database. The module is implemented as a wrapper around C(dconf) tool. Please see the dconf(1) man page for more details. - Since C(dconf) requires a running D-Bus session to change values, the module will try to detect an existing session and reuse it, or run the tool using C(dbus-run-session). requirements: - Optionally the C(gi.repository) Python library (usually included in the OS on hosts which have C(dconf)); this will become a non-optional requirement in a future major release of community.general. notes: - This module depends on C(psutil) Python library (version 4.0.0 and upwards), C(dconf), C(dbus-send), and C(dbus-run-session) binaries. Depending on distribution you are using, you may need to install additional packages to have these available. - This module uses the C(gi.repository) Python library when available for accurate comparison of values in C(dconf) to values specified in Ansible code. C(gi.repository) is likely to be present on most systems which have C(dconf) but may not be present everywhere. When it is missing, a simple string comparison between values is used, and there may be false positives, that is, Ansible may think that a value is being changed when it is not. This fallback will be removed in a future version of this module, at which point the module will stop working on hosts without C(gi.repository). - Detection of existing, running D-Bus session, required to change settings using C(dconf), is not 100% reliable due to implementation details of D-Bus daemon itself. This might lead to running applications not picking-up changes on-the-fly if options are changed using Ansible and C(dbus-run-session). - Keep in mind that the C(dconf) CLI tool, which this module wraps around, utilises an unusual syntax for the values (GVariant). For example, if you wanted to provide a string value, the correct syntax would be O(value="'myvalue'") - with single quotes as part of the Ansible parameter value. - When using loops in combination with a value like V("[('xkb', 'us'\), ('xkb', 'se'\)]"), you need to be aware of possible type conversions. Applying a filter V({{ item.value | string }}) to the parameter variable can avoid potential conversion problems. - The easiest way to figure out exact syntax/value you need to provide for a key is by making the configuration change in application affected by the key, and then having a look at value set using commands C(dconf dump /path/to/dir/) or C(dconf read /path/to/key). extends_documentation_fragment: - community.general.attributes attributes: check_mode: support: full diff_mode: support: none options: key: type: str required: true description: - A dconf key to modify or read from the dconf database. value: type: raw required: false description: - Value to set for the specified dconf key. Value should be specified in GVariant format. Due to complexity of this format, it is best to have a look at existing values in the dconf database. - Required for O(state=present). - Although the type is specified as "raw", it should typically be specified as a string. However, boolean values in particular are handled properly even when specified as booleans rather than strings (in fact, handling booleans properly is why the type of this parameter is "raw"). state: type: str required: false default: present choices: ['read', 'present', 'absent'] description: - The action to take upon the key/value. z value: description: Value associated with the requested key. returned: success, state was "read" type: str sample: "'Default'" a - name: Configure available keyboard layouts in Gnome community.general.dconf: key: "/org/gnome/desktop/input-sources/sources" value: "[('xkb', 'us'), ('xkb', 'se')]" state: present - name: Read currently available keyboard layouts in Gnome community.general.dconf: key: "/org/gnome/desktop/input-sources/sources" state: read register: keyboard_layouts - name: Reset the available keyboard layouts in Gnome community.general.dconf: key: "/org/gnome/desktop/input-sources/sources" state: absent - name: Configure available keyboard layouts in Cinnamon community.general.dconf: key: "/org/gnome/libgnomekbd/keyboard/layouts" value: "['us', 'se']" state: present - name: Read currently available keyboard layouts in Cinnamon community.general.dconf: key: "/org/gnome/libgnomekbd/keyboard/layouts" state: read register: keyboard_layouts - name: Reset the available keyboard layouts in Cinnamon community.general.dconf: key: "/org/gnome/libgnomekbd/keyboard/layouts" state: absent - name: Disable desktop effects in Cinnamon community.general.dconf: key: "/org/cinnamon/desktop-effects" value: "false" state: present N) AnsibleModule) has_respawnedprobe_interpreters_for_modulerespawn_module) to_native)depszgi.repository.GLib)VariantGErrorpsutilc"eZdZdZdZdZdZy) DBusWrapperas Helper class that can be used for running a command with a working D-Bus session. If possible, command will be run against an existing D-Bus session, otherwise the session will be spawned via dbus-run-session. Example usage: dbus_wrapper = DBusWrapper(ansible_module) dbus_wrapper.run_command(["printenv", "DBUS_SESSION_BUS_ADDRESS"]) c||_|j|_|j#|jjdd|_yy)z Initialises an instance of the class. :param module: Ansible module instance used to signal failures and run commands. :type module: AnsibleModule Nzdbus-run-sessionTrequired)module_get_existing_dbus_sessiondbus_session_bus_address get_bin_pathdbus_run_session_cmd)selfrs k/home/dcms/DCMS/lib/python3.12/site-packages/ansible_collections/community/general/plugins/modules/dconf.py__init__zDBusWrapper.__init__sO )-(G(G(I%  ( ( 0(, (@(@AS^b(@(cD % 1ctj}|jjd|zt j D]} t j |}|j\}}}||k(rd|jvr|jd}|jjd|z|jjdd}|d|zdd d g}|jj|\} }}| d k(r"|jjd |z|cS|jjd y#tj$rYtj$rY+wxYw)z Detects and returns an existing D-Bus session bus address. :returns: string -- D-Bus session bus address. If a running D-Bus session was not detected, returns None. z9Trying to detect existing D-Bus user session for user: %dDBUS_SESSION_BUS_ADDRESSz1Found D-Bus user session candidate at address: %sz dbus-sendTrz --address=%sz --type=signal/zcom.example.testrz>Verified D-Bus user session candidate as usable at address: %szDFailed to find running D-Bus user session, will use dbus-run-sessionN) osgetuidrdebugrpidsProcessuidsenvironr run_command AccessDenied NoSuchProcess) ruidpidprocessprocess_real_uiddummy"dbus_session_bus_address_candidate dbus_send_cmdcommandrcs rrz&DBusWrapper._get_existing_dbus_sessionsqiik UX[[\;;= C  ..-18. %#s*/IW__M^/^9@9JKe9f6KK%%&Y\~&~$(KK$<$<[SW$<$XM,n?a.acrtwzLMG'+{{'>'>w'G$BuQw ))*jnP+PQAA . `a&& ''  s CEE3E32E3cx|j{|jjd|jg|z}|jj |\}}}|jT|dk(rO|jj d|zn/d|ji}|jj ||\}}}|||fS)a Runs the specified command within a functional D-Bus session. Command is effectively passed-on to AnsibleModule.run_command() method, with modification for using dbus-run-session if necessary. :param command: Command to run, including parameters. Each element of the list should be a string. :type module: list :returns: tuple(result_code, standard_output, standard_error) -- Result code, standard output, and standard error from running the command. z4Using dbus-run-session wrapper for running commands.zMFailed to run passed-in command, dbus-run-session faced an internal error: %smsgr)environ_update)rrr"rr' fail_json)rr1r2outerrextra_environments rr'zDBusWrapper.run_commands  ( ( 0 KK  T U001G;G;;227;LBS,,4s %%*y|*%A!;T=Z=Z [ ;;227K\2]LBS3|rN)__name__ __module__ __qualname____doc__rrr'rrrrs d&(Trrc6eZdZddZedZdZdZdZy)DconfPreferencecd||_||_|jjdd|_y)aG Initialises instance of the class. :param module: Ansible module instance used to signal failures and run commands. :type module: AnsibleModule :param check_mode: Specify whether to only check if a change should be made or if to actually make a change. :type check_mode: bool dconfTrN)r check_moder dconf_bin)rrrEs rrzDconfPreference.__init__s- $11'D1Irc|y tjd|}tj|j|}||k(S#t$r||k(cYSwxYw)aCompare two string GVariant representations for equality. Assumes `canonical_value` is "canonical" in the sense that the type of the variant is specified explicitly if it cannot be inferred; this is true for textual representations of variants generated by the `dconf` command. The type of `canonical_value` is used to parse `user_value`, so the latter does not need to be explicitly typed. Returns True if the two values are equal. NF)r parseget_typer )canonical_value user_valuevariant1variant2s rvariants_are_equalz"DconfPreference.variants_are_equalsb  " 1}}T?;H}}X%6%6%8*EHx' ' 1"j0 0 1s>AAAc|jd|g}|jj|\}}}|dk7r!|jjd|z|||dk(rd}|S|j d}|S)a Retrieves current value associated with the dconf key. If an error occurs, a call will be made to AnsibleModule.fail_json. :returns: string -- Value assigned to the provided key. If the value is not set for specified key, returns None. readrz3dconf failed while reading the value with error: %sr6r9r:N )rFrr'r8rstrip)rkeyr1r2r9r:values rrPzDconfPreference.read&s>>63/{{..w7 C 7 KK ! !&[^a&a&)&) " + "9E JJt$E rc.|j|j||ry|jry|jd||g}t |j }|j |\}}}|dk7r'|j jd|d|d|||y) a Writes the value for specified key. If an error occurs, a call will be made to AnsibleModule.fail_json. :param key: dconf key for which the value should be set. Should be a full path. :type key: str :param value: Value to set for the specified dconf key. Should be specified in GVariant format. :type value: str :returns: bool -- True if a change was made, False if no change was required. FTwriterzdconf failed while writing key z, value z with error: rQ)rNrPrErFrrr'r8)rrUrVr1 dbus_wrapperr2r9r:s rrXzDconfPreference.write>s  " "499S>5 9 __>>7C7#4;;/ #//8 C 7 KK ! !fikpru&v&)&) " + rc|j|}|y|jry|jd|g}t|j}|j |\}}}|dk7r!|jj d|z||y)aV Returns value for the specified key (removes it from user configuration). If an error occurs, a call will be made to AnsibleModule.fail_json. :param key: dconf key to reset. Should be a full path. :type key: str :returns: bool -- True if a change was made, False if no change was required. FTresetrz5dconf failed while resetting the value with error: %srQ)rPrErFrrr'r8)rrU current_valuer1rYr2r9r:s rr[zDconfPreference.resetcs #    __>>7C0#4;;/ #//8 C 7 KK ! !&]`c&c&)&) " + rN)F) r<r=r>r staticmethodrNrPrXr[r@rrrBrBs,J 11,0#J$rrBc ^tttdgdtdddtddd  dd dd gfg }tUtr*|j t dt jdgd}t|t }|r t||jd et|jd tr!|jd rdnd|jd <n't|jd d|jd <t|jdtj |t#||j$}|jd dk(r2|j'|jd}|j)d|y|jd dk(r?|j+|jd|jd }|j)|y|jd dk(r1|j-|jd}|j)|yy)Npresent)r_absentrP)defaultchoicesTstrF)rtypeno_lograw)rrard)staterUrVrgrV) argument_specsupports_check_mode required_ifz$ must be installed and visible from .r5)z/usr/bin/python3z/usr/bin/python2z/usr/bin/pythontruefalsesurrogate_or_strict)errorszWARNING: The gi.repository Python library is not available; using string comparison to check value equality. This fallback will be deprecated in a future version of community.general.rPrU)changedrV)rpr`)rdictr rr8glib_module_namesys executablerr params isinstanceboolr warnr validaterBrErP exit_jsonrXr[)r interpreters interpreterrDrVrps rmainr}s y2OPdu=t%@  ! i' +  F ?   !3>>3  4+ 4 *,   ; '}}W) fmmG,d 3/5}}W/EV7FMM' "%. g&/D&FFMM' "  K L  MM& FF$5$5 6E}}W' 6==/0e4 w 9 ,++fmmE2FMM'4JK) w 8 +++fmmE23) ,r__main__)" __future__rrrrd __metaclass__ DOCUMENTATIONRETURNEXAMPLESr rsansible.module_utils.basicr#ansible.module_utils.common.respawnrrr +ansible.module_utils.common.text.convertersr :ansible_collections.community.general.plugins.module_utilsr rrgi.repository.GLibr r ImportErrorAttributeErrordeclarerobjectrrBr}r<r@rrrsA@ ? B ( V 4 BK'2 T\\(b&bJJfJZK*\ zFQ G FsBB BBB