VhfaddlmZmZmZeZdZdZddlZddl Z ddl Z ddl Z ddl Z ddl mZddlmZmZdZdZd Zd Z dd Zd Zed k(reyy))absolute_importdivisionprint_functionaq module: ini_file short_description: Tweak settings in INI files extends_documentation_fragment: - files - community.general.attributes description: - Manage (add, remove, change) individual settings in an INI-style file without having to manage the file as a whole with, say, M(ansible.builtin.template) or M(ansible.builtin.assemble). - Adds missing sections if they do not exist. - This module adds missing ending newlines to files to keep in line with the POSIX standard, even when no other modifications need to be applied. attributes: check_mode: support: full diff_mode: support: full options: path: description: - Path to the INI-style file; this file is created if required. type: path required: true aliases: [dest] section: description: - Section name in INI file. This is added if O(state=present) automatically when a single value is being set. - If being omitted, the O(option) will be placed before the first O(section). - Omitting O(section) is also required if the config format does not support sections. type: str section_has_values: type: list elements: dict required: false suboptions: option: type: str description: Matching O(section) must contain this option. required: true value: type: str description: Matching O(section_has_values[].option) must have this specific value. values: description: - The string value to be associated with an O(section_has_values[].option). - Mutually exclusive with O(section_has_values[].value). - O(section_has_values[].value=v) is equivalent to O(section_has_values[].values=[v]). type: list elements: str description: - Among possibly multiple sections of the same name, select the first one that contains matching options and values. - With O(state=present), if a suitable section is not found, a new section will be added, including the required options. - With O(state=absent), at most one O(section) is removed if it contains the values. version_added: 8.6.0 option: description: - If set (required for changing a O(value)), this is the name of the option. - May be omitted if adding/removing a whole O(section). type: str value: description: - The string value to be associated with an O(option). - May be omitted when removing an O(option). - Mutually exclusive with O(values). - O(value=v) is equivalent to O(values=[v]). type: str values: description: - The string value to be associated with an O(option). - May be omitted when removing an O(option). - Mutually exclusive with O(value). - O(value=v) is equivalent to O(values=[v]). type: list elements: str version_added: 3.6.0 backup: description: - Create a backup file including the timestamp information so you can get the original file back if you somehow clobbered it incorrectly. type: bool default: false state: description: - If set to V(absent) and O(exclusive) set to V(true) all matching O(option) lines are removed. - If set to V(absent) and O(exclusive) set to V(false) the specified O(option=value) lines are removed, but the other O(option)s with the same name are not touched. - If set to V(present) and O(exclusive) set to V(false) the specified O(option=values) lines are added, but the other O(option)s with the same name are not touched. - If set to V(present) and O(exclusive) set to V(true) all given O(option=values) lines will be added and the other O(option)s with the same name are removed. type: str choices: [absent, present] default: present exclusive: description: - If set to V(true) (default), all matching O(option) lines are removed when O(state=absent), or replaced when O(state=present). - If set to V(false), only the specified O(value)/O(values) are added when O(state=present), or removed when O(state=absent), and existing ones are not modified. type: bool default: true version_added: 3.6.0 no_extra_spaces: description: - Do not insert spaces before and after '=' symbol. type: bool default: false ignore_spaces: description: - Do not change a line if doing so would only add or remove spaces before or after the V(=) symbol. type: bool default: false version_added: 7.5.0 create: description: - If set to V(false), the module will fail if the file does not already exist. - By default it will create the file if it is missing. type: bool default: true allow_no_value: description: - Allow option without value and without '=' symbol. type: bool default: false modify_inactive_option: description: - By default the module replaces a commented line that matches the given option. - Set this option to V(false) to avoid this. This is useful when you want to keep commented example C(key=value) pairs for documentation purposes. type: bool default: true version_added: 8.0.0 follow: description: - This flag indicates that filesystem links, if they exist, should be followed. - O(follow=true) can modify O(path) when combined with parameters such as O(mode). type: bool default: false version_added: 7.1.0 notes: - While it is possible to add an O(option) without specifying a O(value), this makes no sense. - As of community.general 3.2.0, UTF-8 BOM markers are discarded when reading files. author: - Jan-Piet Mens (@jpmens) - Ales Nosek (@noseka1) a - name: Ensure "fav=lemonade is in section "[drinks]" in specified file community.general.ini_file: path: /etc/conf section: drinks option: fav value: lemonade mode: '0600' backup: true - name: Ensure "temperature=cold is in section "[drinks]" in specified file community.general.ini_file: path: /etc/anotherconf section: drinks option: temperature value: cold backup: true - name: Add "beverage=lemon juice" is in section "[drinks]" in specified file community.general.ini_file: path: /etc/conf section: drinks option: beverage value: lemon juice mode: '0600' state: present exclusive: false - name: Ensure multiple values "beverage=coke" and "beverage=pepsi" are in section "[drinks]" in specified file community.general.ini_file: path: /etc/conf section: drinks option: beverage values: - coke - pepsi mode: '0600' state: present - name: Add "beverage=lemon juice" outside a section in specified file community.general.ini_file: path: /etc/conf option: beverage value: lemon juice state: present - name: Remove the peer configuration for 10.128.0.11/32 community.general.ini_file: path: /etc/wireguard/wg0.conf section: Peer section_has_values: - option: AllowedIps value: 10.128.0.11/32 mode: '0600' state: absent - name: Add "beverage=lemon juice" outside a section in specified file community.general.ini_file: path: /etc/conf option: beverage value: lemon juice state: present - name: Update the public key for peer 10.128.0.12/32 community.general.ini_file: path: /etc/wireguard/wg0.conf section: Peer section_has_values: - option: AllowedIps value: 10.128.0.12/32 option: PublicKey value: xxxxxxxxxxxxxxxxxxxx mode: '0600' state: present - name: Remove the peer configuration for 10.128.0.11/32 community.general.ini_file: path: /etc/wireguard/wg0.conf section: Peer section_has_values: - option: AllowedIps value: 10.4.0.11/32 mode: '0600' state: absent - name: Update the public key for peer 10.128.0.12/32 community.general.ini_file: path: /etc/wireguard/wg0.conf section: Peer section_has_values: - option: AllowedIps value: 10.4.0.12/32 option: PublicKey value: xxxxxxxxxxxxxxxxxxxx mode: '0600' state: present N) AnsibleModule)to_bytesto_textc^tj|}tjd|z|S)Nz,( | )*([#;]?)( | )*(%s)( | )*(=|$)( | )*(.*)reescapematchoptionlines n/home/dcms/DCMS/lib/python3.12/site-packages/ansible_collections/community/general/plugins/modules/ini_file.py match_optr s( YYv F 88FOQU VVc^tj|}tjd|z|S)Nz#()()( | )*(%s)( | )*(=|$)( | )*(.*)r rs rmatch_active_optrs' YYv F 88rc|J|D]E}|D]=}t|d|}|st|ddk(s|jd|dvs=Dyy)NrvaluesrrFT)rlenr)section_has_valuesr conditionrr s rcheck_section_has_valuesr,)sn%+ I% !)H"5t<c)H"56!;u{{1~QZ[cQd?d     rc B| t|}| t|}g}|Dcgc]$}||vs| |jt|&c}|}tddd|zd|z}|r?tjj |r tjj |}n|}tjj|sz| s|jdd|ztjj|}tjj|s!|jstj|g}nGtj|dd 5}|jDcgc] }t|}}ddd|jrdj!|d <d }s|jd |d dk(s |d d d k7r|d xxd z cc<d}d}|j#dd|z|jd|s|}| }dx}}d}| rd}nd}d }t%j&td}gx} }!g}"t%j&tdt%j(|j+z}#t-|D]G\}$}|r*|j/drt1||||$r|$}nd }dx}}|#j3|sDd}|$}I|d|} |||}"||t5|}!dgt5|"z}%| rt6}&nt8}&|dk(r|rt-|"D]\}$}|&||s|&||}'|r^|'j;d|vrK|'j;d}(|(s | rd|z})d}n|||(fz})t=|||"|$|%| |)|\}}|j?|(y|r|| sd|z})t=|||"|$|%| |)|\}}d}n|dk(r|r| st5|dkDr^t-|"D]P\}$}|%|$r |&||s|||jAdfz})t=|||"|$|%| |)|\}}t5|dk(sPntCt5|"dz dd D]}$|%|$r |&||"|$s|"|$=|%|$=d}d}!|dk(rtCt5|"dd D]}$|j3|"|$dz r|rM|rK|ddd D]?}*|*|"j#|$|||*fzd}d}!|*$| s'|"j#|$d|zd}d}An!|r|s| r|s|"j#|$d|zd}d}n|dk(r|r|r(|"Dcgc]}t9||r|}+}|"|+k7rdd}d}|+}"n]|s[t5|dkDrM|"D,cgc].},t9||,rt9||,j;d|vr-|,0}+},|"|+k7rd}d}|+}"n|"rg}"d}d}| |"z|!z}|d=|d d=|s|dk(r|jd |zd!}|r|D]}}-|-d"|k7rPt5|-d#dkDr$|-d#D]}|j||-d"|fz@| sC|jd|-d"z[|r^|-d#D]}||vs|j||r |r|D]}|j|||fzn|r|s| r|jd|znd$}d}|jrdj!||d%<d}.|r|js|r|jE|}.|Dcgc] }tG|}/} tIjJ|jL&\}0}1tjN|0d'}2|2jQ|/|2jS |j[1tjj]|||.||fScc}wcc}w#1swYxYwcc}wcc},wcc}w#tT$r(|jd(tWjX)YwxYw#tT$r9|j^jd*1d+|d,tWjX)YwxYw)-Nz %s (content))beforeafter before_header after_headerizDestination %s does not exist!)rcr"rz utf-8-sig)encodingr/F T(ad01e11446efb704fcdbdb21f2c43757423d91c5rz[%s][OKz%s=%s z%s = %s z^[ \t]*([#;].*)?$z ^\[\s*%s\s*]presentrz%s rrz option addedabsentzsection removedz[%s] zsection and option addedrr(zonly section addedr0)dirwbz"Unable to create temporary file %s)r" tracebackzAUnable to move temporary file z to z , IOError)0rappenddictospathislinkrealpathexists fail_jsondirname check_modemakedirsioopen readlines_diffjoininsertr compiler strip enumerate startswithr,r r)rrrr&removepoprange backup_localrtempfilemkstemptmpdirfdopen writelinescloseIOErrorr? format_exc atomic_moveabspathansible)3modulefilenamesectionr*rr(state exclusivebackupno_extra_spacesr createallow_no_valuemodify_inactive_optionfollow values_uniquevaluedifftarget_filenamedestpath ini_linesini_filerrfake_section_namewithin_section section_start section_endr"assignment_formatoption_no_value_presentnon_blank_non_comment_patternr/r0rsection_patternrrmatch_functionr matched_valuer!elementnew_section_linesir+ backup_fileencoded_ini_linestmpfdtmpfilefs3 rdo_inir5ss '" M7=remA[`e`q]'%.)r F $x/#h.  D"''..*''**84" 77>>/ *   )IO)[  \77???3ww~~h'0A0A KK ! WW_cK @ IH3;3E3E3GH4HIH I||),XG }y}R0E9"   DQ"334T # [N"##MK C&(#$&JJw7K/L$M!FUMjj299W]]_;U)U!VWO +" t dood3'"ImE$B$ "'.//    &!N!M!"$q 'FmK8M k#i. 1EC#m,,M") f$]3 KE4fd+&vt4ekk!n6$)KKNM(^")F"226/#4v}6M"M%8-Y^`mo|FHK&LNWcMM-0N%.G%8-Y^`mo|FHK&LNWc.2+' * i v;?(7  t$U+vt0L/66::a=2IIG%8-Y^`mo|FHK&LNWc6{a'  3}-11b9 'E 'N6=QVCW,X!%(!%(&  ' 3}-q"5 E066}UQY7OPf#)$B$< +#.)008IVU\L]8]^"0C&*G$_)00&8HI"0C&*G +F~F]!((&0@A(C"G/ 2  6C$ldL\]ceiLjT$l!$l $55"G*C$5M3v;?0=%W1FVW]_`Fafvw}@AgBgHgHIJgKOUgUQ%W!%W $55"G*C$5M " '&.I ! "# ey0W,-( / 1 X&&09X./!3%.x%8_E%,,->)HBUW\A]-]^_'!((9X3F)FG"!*8!41 ."MM%01 1 f F  !2fe_!DE F F~   Wv- .&C ||+W Kv((  --o>K8ABXd^BB i%--&--@NE7 %&A LL* + GGI {   w(H I [$ ,,}s0I I I|%m%WfC  i   !EQZQeQeQg  h i  { NN $ $>E*Xclcwcwcy % { {sp ^^^^ +^=^ #^5^.^ ^^#2A^( /_^  ^(.__?``ctttdddgtdtddttdd tdtdd  dd d ggtdtdtdd tddtddddgtddtddtddtddtddtddtddd d ggdd}|jd}|jd}|jd}|jd}|jd }|jd }|jd}|jd}|jd} |jd} |jd} |jd} |jd } |jd!}|jd"}|dk(r| s||s|jd#$||g}n|g}|r!|D]}|d  |d g|d <|d g|d <t ||||||||| | | || | |\}}}}|j sLt jj|r-|j|j}|j||}t||||%}|||d&<|jd'i|y)(NrCTdest)typerequiredaliasesstr)rlistrA)rr)relements)rrpr(rpr()rroptionsdefaultmutually_exclusiveboolF)rrr;r<)rrchoices)rCrfr*rrpr(rirgrhrjr rlrmrkrn) argument_specradd_file_common_argssupports_check_moderfr*rrgrhrirjr rlrmrkrnzOParameter 'value(s)' must be defined if state=present and allow_no_value=False.)r")rrqr"rCr) rrAparamsrGrrIrBrCrFload_file_common_argumentsset_fs_attributes_if_different exit_json)rdrCrfr*rrpr(rgrhrirjr rlrmrkrnr+rrrqr" file_argsresultss rmainrAs  6D6(Ce$#&$6&%8K'81D0E  G U#E"Ve4VU3E9x>ST5 fe<FE:VU;#'VT#BVT2VU3' ,h  " 5F: == DmmI&G';< ]]8 $F MM' "E ]]8 $F MM' "E k*I ]]8 $Fmm$56OMM/2M]]#34N#]]+CD ]]8 $F ]]8 $F .U]6no  + )I!-'0'9&: (#8$,&( (#  ))/g1665)U[@VX^)`%Wk4   !555fmmD 77 7K    G !, Fwr__main__) NNNNr;TFFFTFTF) __future__rrrr __metaclass__ DOCUMENTATIONEXAMPLESrKrBr rYr?ansible.module_utils.basicr+ansible.module_utils.common.text.convertersrrrrr&r,rr__name__rrrrsA@ P d` D 4IW M $ Y]JOglI-XQ h zFr