Vh\ddlmZdZdZdZddlZddlZddlZddlm Z ddl m Z m Z m Z dZd Zd Zd Zd Zed k(reyy)) annotationsa= --- module: lineinfile short_description: Manage lines in text files description: - This module ensures a particular line is in a file, or replace an existing line using a back-referenced regular expression. - This is primarily useful when you want to change a single line in a file only. - See the M(ansible.builtin.replace) module if you want to change multiple, similar lines or check M(ansible.builtin.blockinfile) if you want to insert/update/remove a block of lines in a file. For other cases, see the M(ansible.builtin.copy) or M(ansible.builtin.template) modules. version_added: "0.7" options: path: description: - The file to modify. - Before Ansible 2.3 this option was only usable as O(dest), O(destfile) and O(name). type: path required: true aliases: [ dest, destfile, name ] regexp: description: - The regular expression to look for in every line of the file. - For O(state=present), the pattern to replace if found. Only the last line found will be replaced. - For O(state=absent), the pattern of the line(s) to remove. - If the regular expression is not matched, the line will be added to the file in keeping with O(insertbefore) or O(insertafter) settings. - When modifying a line the regexp should typically match both the initial state of the line as well as its state after replacement by O(line) to ensure idempotence. - Uses Python regular expressions. See U(https://docs.python.org/3/library/re.html). type: str aliases: [ regex ] version_added: '1.7' search_string: description: - The literal string to look for in every line of the file. This does not have to match the entire line. - For O(state=present), the line to replace if the string is found in the file. Only the last line found will be replaced. - For O(state=absent), the line(s) to remove if the string is in the line. - If the literal expression is not matched, the line will be added to the file in keeping with O(insertbefore) or O(insertafter) settings. - Mutually exclusive with O(backrefs) and O(regexp). type: str version_added: '2.11' state: description: - Whether the line should be there or not. type: str choices: [ absent, present ] default: present line: description: - The line to insert/replace into the file. - Required for O(state=present). - If O(backrefs) is set, may contain backreferences that will get expanded with the O(regexp) capture groups if the regexp matches. type: str aliases: [ value ] backrefs: description: - Used with O(state=present). - If set, O(line) can contain backreferences (both positional and named) that will get populated if the O(regexp) matches. - This parameter changes the operation of the module slightly; O(insertbefore) and O(insertafter) will be ignored, and if the O(regexp) does not match anywhere in the file, the file will be left unchanged. - If the O(regexp) does match, the last matching line will be replaced by the expanded line parameter. - Mutually exclusive with O(search_string). type: bool default: no version_added: "1.1" insertafter: description: - Used with O(state=present). - If specified, the line will be inserted after the last match of specified regular expression. - If the first match is required, use(firstmatch=yes). - A special value is available; V(EOF) for inserting the line at the end of the file. - If specified regular expression has no matches or no value is passed, V(EOF) will be used instead. - If O(insertbefore) is set, default value V(EOF) will be ignored. - If regular expressions are passed to both O(regexp) and O(insertafter), O(insertafter) is only honored if no match for O(regexp) is found. - May not be used with O(backrefs) or O(insertbefore). type: str insertbefore: description: - Used with O(state=present). - If specified, the line will be inserted before the last match of specified regular expression. - If the first match is required, use O(firstmatch=yes). - A value is available; V(BOF) for inserting the line at the beginning of the file. - If specified regular expression has no matches, the line will be inserted at the end of the file. - If regular expressions are passed to both O(regexp) and O(insertbefore), O(insertbefore) is only honored if no match for O(regexp) is found. - May not be used with O(backrefs) or O(insertafter). type: str version_added: "1.1" create: description: - Used with O(state=present). - If specified, the file will be created if it does not already exist. - By default it will fail if the file is missing. type: bool default: no 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: no firstmatch: description: - Used with O(insertafter) or O(insertbefore). - If set, O(insertafter) and O(insertbefore) will work with the first line that matches the given regular expression. type: bool default: no version_added: "2.5" extends_documentation_fragment: - action_common_attributes - action_common_attributes.files - files - validate attributes: check_mode: support: full diff_mode: support: full platform: platforms: posix safe_file_operations: support: full vault: support: none notes: - As of Ansible 2.3, the O(dest) option has been changed to O(path) as default, but O(dest) still works as well. seealso: - module: ansible.builtin.blockinfile - module: ansible.builtin.copy - module: ansible.builtin.file - module: ansible.builtin.replace - module: ansible.builtin.template - module: community.windows.win_lineinfile author: - Daniel Hokka Zakrissoni (@dhozac) - Ahti Kitsik (@ahtik) - Jose Angel Munoz (@imjoseangel) a6 # NOTE: Before 2.3, option 'dest', 'destfile' or 'name' was used instead of 'path' - name: Ensure SELinux is set to enforcing mode ansible.builtin.lineinfile: path: /etc/selinux/config regexp: '^SELINUX=' line: SELINUX=enforcing - name: Make sure group wheel is not in the sudoers configuration ansible.builtin.lineinfile: path: /etc/sudoers state: absent regexp: '^%wheel' - name: Replace a localhost entry with our own ansible.builtin.lineinfile: path: /etc/hosts regexp: '^127\.0\.0\.1' line: 127.0.0.1 localhost owner: root group: root mode: '0644' - name: Replace a localhost entry searching for a literal string to avoid escaping ansible.builtin.lineinfile: path: /etc/hosts search_string: '127.0.0.1' line: 127.0.0.1 localhost owner: root group: root mode: '0644' - name: Ensure the default Apache port is 8080 ansible.builtin.lineinfile: path: /etc/httpd/conf/httpd.conf regexp: '^Listen ' insertafter: '^#Listen ' line: Listen 8080 - name: Ensure php extension matches new pattern ansible.builtin.lineinfile: path: /etc/httpd/conf/httpd.conf search_string: '' insertafter: '^\t\n' line: ' ' - name: Ensure we have our own comment added to /etc/services ansible.builtin.lineinfile: path: /etc/services regexp: '^# port for http' insertbefore: '^www.*80/tcp' line: '# port for http by default' - name: Add a line to a file if the file does not exist, without passing regexp ansible.builtin.lineinfile: path: /tmp/testfile line: 192.168.1.99 foo.lab.net foo create: yes # NOTE: Yaml requires escaping backslashes in double quotes but not in single quotes - name: Ensure the JBoss memory settings are exactly as needed ansible.builtin.lineinfile: path: /opt/jboss-as/bin/standalone.conf regexp: '^(.*)Xms(\d+)m(.*)$' line: '\1Xms${xms}m\3' backrefs: yes # NOTE: Fully quoted because of the ': ' on the line. See the Gotchas in the YAML docs. - name: Validate the sudoers file before saving ansible.builtin.lineinfile: path: /etc/sudoers state: present regexp: '^%ADMIN ALL=' line: '%ADMIN ALL=(ALL) NOPASSWD: ALL' validate: /usr/sbin/visudo -cf %s # See https://docs.python.org/3/library/re.html for further details on syntax - name: Use backrefs with alternative group syntax to avoid conflicts with variable values ansible.builtin.lineinfile: path: /tmp/config regexp: ^(host=).* line: \g<1>{{ hostname }} backrefs: yes #N) AnsibleModule)to_bytes to_nativeto_textc ntj|j\}}tj|d5}|j |ddd|j jdd}| }|r^d|vr|jd|z|jt||zd\}} } |d k(}|d k7r|jd |d | |rU|j|ttjjt|dd|j d  yy#1swYxYw)N)dirwbvalidatez%szvalidate must contain %%s: %smsgsurrogate_or_stricterrorsrzfailed to validate: rc:z error: unsafe_writes)r)tempfilemkstemptmpdirosfdopen writelinesparamsget fail_json run_commandr atomic_moverpathrealpath) moduleb_linesdesttmpfdtmpfilefr validrcouterrs J/home/dcms/DCMS/lib/python3.12/site-packages/ansible/modules/lineinfile.py write_changesr+s-%%&--8NE7 5$ 1 W}}  T2HLE x    !@H!M  N++HX5GPe,fgS#a 7   57">  ? 7$RWW%5%5htLa6b%cmBC)/)G  I s D++D4c|j|j}|j|d|r|r|dz }d}|dz }||fS)NF)diffz and Tz,ownership, perms or SE linux context changed)load_file_common_argumentsrset_fs_attributes_if_different)r changedmessager- file_argss r*check_file_attrsr3sS11&--@I ,,YD,I  w GAA G c  ddd|zd|zd} t|d} tjj| s}|s|j dd|ztjj | } | rAtjj| s"|j s tj| g}n%t| d 5}|j}ddd|jrtdj| d<| tj t|d}|dvr!tj t|d}n'|dvr!tj t|d}nd}ddg}d}d}t|d}|2t#D]$\}}j%|}|s||d<|}| s$n|0t#D]"\}}t|d|v}|s||d<|}| s"n|s^t#D]P\}}||j'dk(r||d<d}"|%|j%|s7|r |dz|d<| rn|sH||d<| sPnd}d}ttj(d}|ddk7rz| r|r|j+|}n|}|j-|s||z }|||fdk(r)|s&|r|dk7rr|ddddvr |d|z|d<t/||dk(r8||ddz j'd|k7r|j1||zd}d}n||dj'd|k7r|j3|d||zd}d}n|r|dk7r|ddkr9|dj'd|k7r|j3|d||zd}d}ne|ddz j'd|k7rG|j3|d||zd}d}n)|d|k7r|||d<d}d}n| rn |dk(s|dk(rj3d||zd}d}n|dk(s|ddk(r6r|ddddvr|j1||j1||zd}d}n|r|ddk7r~t/|dk(r6||ddz j'd|k7rl|j1||zd}d}nS|||dj'dk7r9|j3|d||zd}d}nj3|d||zd}d}|jrtdj| d<d}|rK|j s?|r0tjj| r|j5|}t7|||j r4tjj| s|j9|||| i}t;||||\}}d!|z|d"<d!|z|d#<| |g} |j9|||| y#t$r6}|j d t| d t|d  Yd}~zd}~wwxYw#1swYdxYw)$N %s (content)beforeafter before_header after_headerrrizDestination %s does not exist !r'rzError creating z ()r rbr4r9)NBOFEOF)Nr@Fr TNNNrA)  z line addedr@z line replaceds r:)r0rbackupr-%s (file attributes)r;r<)rrrexistsrdirname check_modemakedirs Exceptionropen readlines_diffrjoinrecompile enumeratesearchrstriplinesepexpandendswithlenappendinsert backup_localr+ exit_jsonr3)!r r"regexp search_stringline insertafter insertbeforecreaterHbackrefs firstmatchr-b_dest b_destpather!r%bre_mbre_insindexmatchexact_line_matchb_linelineno b_cur_line match_foundrr0 b_linesep b_new_line backupdest attr_diffdifflists! r*presentry s+d2*T1 3D d#8 9F 77>>& !   )JT)Q  RWW__V, bggnnZ8ARAR c J' &$  $1kkmG $||"388G#45X  8F3HIJ..**Xk:OPQ ] ***Xl;PQRHE E d#8 9F"+G"4  FJ,,z2K!a#   "+G"4  FJ"=9NOS]]K!a#   "+G"4  FJ**733!a#' $ )C%zE!H!%E!H!! $ CG,ABI Qx2~ f-J J""9- ) #J M5 )-? ?HX{e372;rs#3~#E")"+ "9GBKw<58+uQx!|,33G<Fv '9:*"&U1X&--g6&@NN58Vi-?@&C"G,%"78q=uQx(//8FBuQx)1CD*"&U1X\*11':fDNN58Vi-?@&C"G U1X * , *GE!H !CG   +"6q&9,-  qR 72;rs+~= NN9 %v )* qR w<58 #uQx!|$++G4>v 12" wuQx(//8 8 NN58Vi%7 8CG uQx)!34 ||!#((7"34W Jv(( bggnnV,,,T2Jfgt, !7c*4PI#FGS)DLC!7$!>Io 6 =Ini H W#jxPE c  ATV]^_V`%a bb c  $ $s$W4X64 X3=+X..X36Yct|d}tjj|s|j ddd}ddd|zd|zd}t |d 5} | j } ddd|jrtd j |d < tjtdgt|dfd }  D cgc] } | | s | } } td kD} |jrtd j| |d<d}| r,|js |r|j|}t|| || rdtz}i}t!|| ||\}} d|z|d<d|z|d<||g}|j | t|||y#1swYCxYwcc} w)NrrFzfile not present)r0rr6r7r8r?r4r9cj|}n&td|v}n|jdk(}|rj|| S)NrrrC)rVrrWr\)rrrsrpbre_cfoundr`ras r*matcherzabsent..matcher s\  ,,z2K  &"=9NOS]]K J$5$5g$>>K  LL $r4rr:z%s line(s) removedrIr;r<)r0r}rrHr-)rrrrJr_rOrPrQrrRrSrTr[rLr^r+r3)r r"r`rarbrHrhrr-r%r!r~lr0rvrwrxrpr|r}s `` @@@r*absentrs d#8 9F 77>>& !,>? C+d2*T1 3D fd  q++- ||"388G#45X  8F3HIJ E d#8 9F  "0QWQZq0G0%j1nG ||!#((7"34W Jv(( ,,T2Jfgt,"SZ/I#FGS)DLC!7$!>Io 6 =Ini H WCJC Yab]  .1s F2 F?.F?2F<ctttddgdtddddgtdd g td tdd g td td td dtd dtd dtd dtd  ddgddgddggdd}|j}|d}|d}|d}|d}|d}|d}|d}|d} d||fvr$d} d} |dk(rd} | dz } |j| | zt |d !} t j j| r|jd"d#|z$|d%dk(rP|r||jd&'| |jd('|d|d}} | |d)}t||||| || |||| y||| fd*k(r|jd+'t||||| |y),NrT)r"destfilename)typerequiredaliasesstrryr)rdefaultchoicesregex)rr)rvalueboolF)rr) rstater`rarbrcrdrfrerHrgr rdrcr`rarf) argument_specmutually_exclusiveadd_file_common_argssupports_check_modererHrgrbr6zThe %s is an empty string, which will match every line in the file. This may have unintended consequences, such as replacing the last line in the file rather than appending.z search stringzregular expressionzT If this is desired, use '^' to match every line in the file and avoid this warning.rrzPath %s is a directory !r=rz%regexp is required with backrefs=truer z#line is required with state=presentrArEzCone of line, search_string, or regexp is required with state=absent) rdictrwarnrrrisdirrryr)r rrerHrfrrgr`rarbr param_nameb_pathins_befins_afts r*mainr2s= 6D:VWE9x>STUWI6E*57)4%(5)vu5VU3VU37u%  ] +h-H:WfJgi! %F*]]F H F H Fj!H &>D %J H F?+M &>D fm $${$ R<-J i iC C*$% d#8 9F ww}}VC%?$%FG g)#    !H  I <   !F  G".16-3H ?wGfmT&&(J H M4 (,> >   !f  gvtV]D&Ar4__main__) __future__r DOCUMENTATIONEXAMPLESRETURNrrSransible.module_utils.basicr+ansible.module_utils.common.text.convertersrrrr+r3ryrr__name__r4r*rsm#P dS j  5TTI, RQj:cz@BF zFr4