�
�Udac @` s� d d l m Z m Z m Z e Z i d d 6d g d 6d d 6Z d Z d Z d d
l Z d d
l
Z
d d
l Z d d l m
Z
m Z d d l m Z d
� Z d � Z d � Z e d k r� e � n d
S( i ( t absolute_importt divisiont print_functions 1.1t metadata_versiont stableinterfacet statust communityt supported_bys�
---
module: replace
author: Evan Kaufman (@EvanK)
extends_documentation_fragment:
- files
- validate
short_description: Replace all instances of a particular string in a
file using a back-referenced regular expression
description:
- This module will replace all instances of a pattern within a file.
- It is up to the user to maintain idempotence by ensuring that the
same pattern would never match any replacements made.
version_added: "1.6"
options:
path:
description:
- The file to modify.
- Before Ansible 2.3 this option was only usable as I(dest), I(destfile) and I(name).
type: path
required: true
aliases: [ dest, destfile, name ]
regexp:
description:
- The regular expression to look for in the contents of the file.
- Uses Python regular expressions; see
U(http://docs.python.org/2/library/re.html).
- Uses MULTILINE mode, which means C(^) and C($) match the beginning
and end of the file, as well as the beginning and end respectively
of I(each line) of the file.
- Does not use DOTALL, which means the C(.) special character matches
any character I(except newlines). A common mistake is to assume that
a negated character set like C([^#]) will also not match newlines.
- In order to exclude newlines, they must be added to the set like C([^#\n]).
- Note that, as of Ansible 2.0, short form tasks should have any escape
sequences backslash-escaped in order to prevent them being parsed
as string literal escapes. See the examples.
type: str
required: true
replace:
description:
- The string to replace regexp matches.
- May contain backreferences that will get expanded with the regexp capture groups if the regexp matches.
- If not set, matches are removed entirely.
- Backreferences can be used ambiguously like C(\1), or explicitly like C(\g<1>).
type: str
after:
description:
- If specified, only content after this match will be replaced/removed.
- Can be used in combination with C(before).
- Uses Python regular expressions; see
U(http://docs.python.org/2/library/re.html).
- Uses DOTALL, which means the C(.) special character I(can match newlines).
type: str
version_added: "2.4"
before:
description:
- If specified, only content before this match will be replaced/removed.
- Can be used in combination with C(after).
- Uses Python regular expressions; see
U(http://docs.python.org/2/library/re.html).
- Uses DOTALL, which means the C(.) special character I(can match newlines).
type: str
version_added: "2.4"
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
others:
description:
- All arguments accepted by the M(file) module also work here.
type: str
encoding:
description:
- The character encoding for reading and writing the file.
type: str
default: utf-8
version_added: "2.4"
notes:
- As of Ansible 2.3, the I(dest) option has been changed to I(path) as default, but I(dest) still works as well.
- As of Ansible 2.7.10, the combined use of I(before) and I(after) works properly. If you were relying on the
previous incorrect behavior, you may be need to adjust your tasks.
See U(https://github.com/ansible/ansible/issues/31354) for details.
- Option I(follow) has been removed in Ansible 2.5, because this module modifies the contents of the file so I(follow=no) doesn't make sense.
sE
- name: Before Ansible 2.3, option 'dest', 'destfile' or 'name' was used instead of 'path'
replace:
path: /etc/hosts
regexp: '(\s+)old\.host\.name(\s+.*)?$'
replace: '\1new.host.name\2'
- name: Replace after the expression till the end of the file (requires Ansible >= 2.4)
replace:
path: /etc/apache2/sites-available/default.conf
after: 'NameVirtualHost [*]'
regexp: '^(.+)$'
replace: '# \1'
- name: Replace before the expression till the begin of the file (requires Ansible >= 2.4)
replace:
path: /etc/apache2/sites-available/default.conf
before: '# live site config'
regexp: '^(.+)$'
replace: '# \1'
# Prior to Ansible 2.7.10, using before and after in combination did the opposite of what was intended.
# see https://github.com/ansible/ansible/issues/31354 for details.
- name: Replace between the expressions (requires Ansible >= 2.4)
replace:
path: /etc/hosts
after: '<VirtualHost [*]>'
before: '</VirtualHost>'
regexp: '^(.+)$'
replace: '# \1'
- name: Supports common file attributes
replace:
path: /home/jdoe/.ssh/known_hosts
regexp: '^old\.host\.name[^\n]*\n'
owner: jdoe
group: jdoe
mode: '0644'
- name: Supports a validate command
replace:
path: /etc/apache/ports
regexp: '^(NameVirtualHost|Listen)\s+80\s*$'
replace: '\1 127.0.0.1:8080'
validate: '/usr/sbin/apache2ctl -f %s -t'
- name: Short form task (in ansible 2+) necessitates backslash-escaped sequences
replace: path=/etc/hosts regexp='\\b(localhost)(\\d*)\\b' replace='\\1\\2.localdomain\\2 \\1\\2'
- name: Long form task does not
replace:
path: /etc/hosts
regexp: '\b(localhost)(\d*)\b'
replace: '\1\2.localdomain\2 \1\2'
- name: Explicitly specifying positional matched groups in replacement
replace:
path: /etc/ssh/sshd_config
regexp: '^(ListenAddress[ ]+)[^\n]+$'
replace: '\g<1>0.0.0.0'
- name: Explicitly specifying named matched groups
replace:
path: /etc/ssh/sshd_config
regexp: '^(?P<dctv>ListenAddress[ ]+)(?P<host>[^\n]+)$'
replace: '#\g<dctv>\g<host>\n\g<dctv>0.0.0.0'
N( t to_textt to_bytes( t
AnsibleModulec C` s t j d | j � \ } } t j | d � } | j | � | j � | j j d d � } | } | r� d | k r� | j
d d | � n | j | | � \ } } }
| d k } | d k r� | j
d d | |
f � q� n | r| j | | d | j d �n d S(
Nt dirt wbt validates %st msgs validate must contain %%s: %si s" failed to validate: rc:%s error:%st
unsafe_writes(
t tempfilet mkstempt tmpdirt ost fdopent writet closet paramst gett Nonet fail_jsont run_commandt atomic_move( t modulet contentst patht tmpfdt tmpfilet fR
t validt rct outt err( ( sA /usr/lib/python2.7/site-packages/ansible/modules/files/replace.pyt
write_changes� s
c C` sT | j | j � } | j | t � rJ | r7 | d 7} n t } | d 7} n | | f S( Ns and s, ownership, perms or SE linux context changed( t load_file_common_argumentsR t set_file_attributes_if_differentt Falset True( R t changedt messaget file_args( ( sA /usr/lib/python2.7/site-packages/ansible/modules/files/replace.pyt check_file_attrs� s
c C` s� t d t d t d d d t d d d d g � d t d d
d t � d t d d
d d
� d t d d
� d t d d
� d t d d d t � d t d d
� d t d d
d d � � d t d t � } | j } | d } | d } t � } t | d d d d d �| d <t | d d d d d �| d <t | d d d d d �| d <t | d d d d d �| d <t j j | � r�| j d d d d | � n t j j
| � s�| j d d d d | � n7 t | d! � } t | j � d d d | �} | j
� d" } | d r3| d r3d# | d | d f } n6 | d rNd$ | d } n | d rid% | d } n | r�t j | t j � } t j | | � } | r�| j d& � }
| j d& � | j d& � g } q�d' | | d <t | d( <| j | � n | }
t j | d t j � } t j | | d |
d) � }
|
d* d) k r�|
|
d) k r�| r�| | d) |
d) | | d* |
d* f }
n d+ |
d* } t } | j r�i | d, 6| d 6| d- 6|
d) d 6| d. <q�n d
} t } | rT| j rT| d r t j j
| � r | j | � | d/ <n t j j | � } t | t |
d) d | �| � n t | | | � \ | d <| d( <| j | � d S(0 Nt
argument_specR t typet requiredt aliasest destt destfilet namet regexpt strt replacet defaultt t aftert beforet backupt boolR
t encodings utf-8t add_file_common_argst supports_check_modet errorst surrogate_or_strictt nonstringt passthruR$ i R s Path %s is a directory !i s Path %s does not exist !t rbu u %s(?P<subsection>.*?)%su %s(?P<subsection>.*)u (?P<subsection>.*)%st
subsections@ Pattern for before/after params did not match the given file: %sR, i i s %s replacements madet
before_headert after_headert difft backup_file( R
t dictR+ R* R R R R t isdirR t existst opent readR t ret compilet DOTALLt searcht groupt startt endt exit_jsont MULTILINEt subnt _difft
check_modet backup_localt realpathR' R R/ ( R R R R@ t res_argsR" R t patternt
section_ret matcht sectiont indicest mret resultR R, ( ( sA /usr/lib/python2.7/site-packages/ansible/modules/files/replace.pyt main� s� $
!
/ # t __main__( t
__future__R R R R1 t
__metaclass__t ANSIBLE_METADATAt
DOCUMENTATIONt EXAMPLESR RR R t ansible.module_utils._textR R t ansible.module_utils.basicR
R' R/ Rh t __name__( ( ( sA /usr/lib/python2.7/site-packages/ansible/modules/files/replace.pyt <module> s
YD
W
Anons79 File Manager Version 1.0, Coded By Anons79
Email: [email protected]
Anons79 Mini Shell