Vh$zddlmZmZmZeZdZdZdZddl m Z ddl m Z m Z Gdde Zd Zed k(rey y ) )absolute_importdivisionprint_functiona module: xfconf author: - "Joseph Benden (@jbenden)" - "Alexei Znamensky (@russoz)" short_description: Edit XFCE4 Configurations description: - This module allows for the manipulation of Xfce 4 Configuration with the help of C(xfconf-query). seealso: - name: xfconf-query(1) man page description: Manual page of the C(xfconf-query) tool at the XFCE documentation site. link: 'https://docs.xfce.org/xfce/xfconf/xfconf-query' - name: xfconf - Configuration Storage System description: XFCE documentation for the Xfconf configuration system. link: 'https://docs.xfce.org/xfce/xfconf/start' extends_documentation_fragment: - community.general.attributes attributes: check_mode: support: full diff_mode: support: full options: channel: description: - A Xfconf preference channel is a top-level tree key, inside of the Xfconf repository that corresponds to the location for which all application properties/keys are stored. See man xfconf-query(1). required: true type: str property: description: - A Xfce preference key is an element in the Xfconf repository that corresponds to an application preference. See man xfconf-query(1). required: true type: str value: description: - Preference properties typically have simple values such as strings, integers, or lists of strings and integers. See man xfconf-query(1). type: list elements: raw value_type: description: - The type of value being set. - When providing more than one O(value_type), the length of the list must be equal to the length of O(value). - If only one O(value_type) is provided, but O(value) contains more than on element, that O(value_type) is applied to all elements of O(value). - If the O(property) being set is an array and it can possibly have only one element in the array, then O(force_array=true) must be used to ensure that C(xfconf-query) interprets the value as an array rather than a scalar. - Support for V(uchar), V(char), V(uint64), and V(int64) has been added in community.general 4.8.0. type: list elements: str choices: [string, int, double, bool, uint, uchar, char, uint64, int64, float] state: type: str description: - The action to take upon the property/value. - The state V(get) has been removed in community.general 5.0.0. Please use the module M(community.general.xfconf_info) instead. choices: [present, absent] default: "present" force_array: description: - Force array even if only one element. type: bool default: false aliases: ['array'] version_added: 1.0.0 a - name: Change the DPI to "192" xfconf: channel: "xsettings" property: "/Xft/DPI" value_type: "int" value: "192" - name: Set workspace names (4) xfconf: channel: xfwm4 property: /general/workspace_names value_type: string value: ['Main', 'Work1', 'Work2', 'Tmp'] - name: Set workspace names (1) xfconf: channel: xfwm4 property: /general/workspace_names value_type: string value: ['Main'] force_array: true ar channel: description: The channel specified in the module parameters. returned: success type: str sample: "xsettings" property: description: The property specified in the module parameters. returned: success type: str sample: "/Xft/DPI" value_type: description: - The type of the value that was changed (V(none) for O(state=reset)). Either a single string value or a list of strings for array types. - This is a string or a list of strings. returned: success type: any sample: '"int" or ["str", "str", "str"]' value: description: - The value of the preference key after executing the module. Either a single string value or a list of strings for array types. - This is a string or a list of strings. returned: success type: any sample: "'192' or ['orange', 'yellow', 'violet']" previous_value: description: - The value of the preference key before executing the module. Either a single string value or a list of strings for array types. - This is a string or a list of strings. returned: success type: any sample: '"96" or ["red", "blue", "green"]' cmd: description: - A list with the resulting C(xfconf-query) command executed by the module. returned: success type: list elements: str version_added: 5.4.0 sample: - /usr/bin/xfconf-query - --channel - xfce4-panel - --property - /plugins/plugin-19/timezone - --create - --type - string - --set - Pacific/Auckland version: description: - The version of the C(xfconf-query) command. returned: success type: str sample: 4.18.1 version_added: 10.2.0 )StateModuleHelper) xfconf_runnerget_xfconf_versionceZdZdZdZdZeeedddeddedded dd ed d edddgddddgfgdgdZdZdZ dZ dZ dZ dZ dZy)XFConfProperty)value)propertychannelr str)presentabsentr)typechoicesdefaultT)rrequiredlist) stringintdoublebooluintucharcharuint64int64float)relementsrraw)rr rFarray)rraliases)stater r value_typer force_arrayr$r r%)r r%) argument_spec required_ifrequired_togethersupports_check_modect|j|_t|j|j_dj |jj|jj|_ |jjd|j|jjd|jj|jjd|jjy)Nz/Property "{0}" does not exist on channel "{1}".previous_valuerr ) initial_value)rmodulerunnerrvarsversionformatr r does_notset_getr%set_metar,)selfs l/home/dcms/DCMS/lib/python3.12/site-packages/ansible_collections/community/general/plugins/modules/xfconf.py__init_module__zXFConfProperty.__init_module__s#DKK0 .t{{; IPPQUQZQZQcQceienenevevw  & 4 fdii223 7$))2J2JKc,|j|jk(ry|s t|r!|jdj |||j}d|vr3|j d}|j d|j d|S)Nz,xfconf-query failed with error (rc={0}): {1}zValue is an array with r)rstripr3lendo_raiser2splitpop)r7rcouterrresults r8process_command_outputz%XFConfProperty.process_command_outputsx ::<4== ( S MMHOOPRTWX Y #v -\\$'F JJqM JJqM r:c|jd|j5}|jcdddS#1swYyxYw)Nzchannel property)output_process)r/rFrunr7ctxs r8r5zXFConfProperty._gets: [[+Dr?rr& isinstancer,ris_arrayr/rIrTrUrVrWrXr4rPr)r7vr% values_len types_lenrKs r8 state_presentzXFConfProperty.state_presents,099??;a3q6; YY)) )  O >#j0J * $ MM[ \ && '  tyy// 6  N  [[Oae[ f Ajm GG4TYY-?-?SWS\S\SbSbdnRoG p"DII "DII GGDIIM IIMM*cllaM @  Ayy!!"iiooa0DIIO']DIIN'DIIN=<& A AsH1 B8H66H?N)__name__ __module__ __qualname__ change_params diff_params output_paramsdictr.use_old_vardict default_stater9rFr5rYrcr:r8r r sMK4M E+@)Ted3ut4%$|~FU3&%'K y7L*ABC23  FOML !(r:r c,tjy)N)r executermr:r8mainrp sr:__main__N) __future__rrrr __metaclass__ DOCUMENTATIONEXAMPLESRETURNHansible_collections.community.general.plugins.module_utils.module_helperrAansible_collections.community.general.plugins.module_utils.xfconfrrr rprdrmr:r8rys]A@ H T 0< |goZ(&Z(z zFr: