Vh)$ddlmZdZdZdZddlZddlZddlZddlZddl m Z ddl m Z m Z ddlmZd d Zdd Zd Zed k(reyy)) annotationsa --- module: assemble short_description: Assemble configuration files from fragments description: - Assembles a configuration file from fragments. - Often a particular program will take a single configuration file and does not support a C(conf.d) style structure where it is easy to build up the configuration from multiple sources. M(ansible.builtin.assemble) will take a directory of files that can be local or have already been transferred to the system, and concatenate them together to produce a destination file. - Files are assembled in string sorting order. - Puppet calls this idea I(fragments). version_added: '0.5' options: src: description: - An already existing directory full of source files. type: path required: true dest: description: - A file to create using the concatenation of all of the source files. type: path required: true backup: description: - Create a backup file (if V(true)), including the timestamp information so you can get the original file back if you somehow clobbered it incorrectly. type: bool default: no delimiter: description: - A delimiter to separate the file contents. type: str version_added: '1.4' remote_src: description: - If V(false), it will search for src at originating/master machine. - If V(true), it will go to the remote/target machine for the src. type: bool default: yes version_added: '1.4' regexp: description: - Assemble files only if the given regular expression matches the filename. - If not set, all files are assembled. - Every V(\\) (backslash) must be escaped as V(\\\\) to comply to YAML syntax. - Uses L(Python regular expressions,https://docs.python.org/3/library/re.html). type: str ignore_hidden: description: - A boolean that controls if files that start with a C(.) will be included or not. type: bool default: no version_added: '2.0' validate: description: - The validation command to run before copying into place. - The path to the file to validate is passed in by C(%s) which must be present as in the sshd example below. - The command is passed securely so shell features like expansion and pipes won't work. type: str version_added: '2.0' attributes: action: support: full async: support: none bypass_host_loop: support: none check_mode: support: none diff_mode: support: full platform: platforms: posix safe_file_operations: support: full vault: support: full version_added: '2.2' seealso: - module: ansible.builtin.copy - module: ansible.builtin.template - module: ansible.windows.win_copy author: - Stephen Fromm (@sfromm) extends_documentation_fragment: - action_common_attributes - action_common_attributes.flow - action_common_attributes.files - decrypt - files a( - name: Assemble from fragments from a directory ansible.builtin.assemble: src: /etc/someapp/fragments dest: /etc/someapp/someapp.conf - name: Insert the provided delimiter between fragments ansible.builtin.assemble: src: /etc/someapp/fragments dest: /etc/someapp/someapp.conf delimiter: '### START FRAGMENT ###' - name: Assemble a new "sshd_config" file into place, after passing validation with sshd ansible.builtin.assemble: src: /etc/ssh/conf.d/ dest: /etc/ssh/sshd_config validate: /usr/sbin/sshd -t -f %s #N) AnsibleModule)b indexbytes) to_nativectj|\}}tj|d}d}d} t tj |D]Q} |r|j | stjj|| } tjj| r0|r/tjj| jdrt| d5} | j} ddd| r|jtd|rT|rRt!j"|d}|j|t%|d d k7r|jtd|j d }| j'tdrd} Pd } T|j)|S#1swYxYw) z/ assemble a file from a directory of fragments )dirwbF.rbN r T)tempfilemkstemposfdopensortedlistdirsearchpathjoinisfilebasename startswithopenreadwritercodecs escape_decoderendswithclose)src_path delimitercompiled_regexp ignore_hiddentmpdirtmpfd temp_pathtmp delimit_me add_newlineffragment fragment_fhfragment_contents H/home/dcms/DCMS/lib/python3.12/site-packages/ansible/modules/assemble.pyassemble_from_fragmentsr3sw''F3E9 ))E4 CJK BJJx( )! ?#9#9!#< 77<<!,ww~~h'Mbgg>N>Nx>X>c>cdg>h  (D ! 2[*//1  2  IIag  "00;A>  )$i,2IIag& "#  $ $QtW -KKC!FIIK = 2 2s &F99G ctjj|r tj|yy#tt f$r&}|d|dt |g|d<Yd}~yYd}~yd}~wwxYw)NzUnable to remove temp file (z): warnings)rrexistsremoveIOErrorOSErrorr)rresultes r2cleanupr<se ww~~d d IIdO! d!OSU^_`Ua&b%cz"" ds8A-A((A-ctttddtdtddtddtddtdtddtdtdd d }d}d}d}|jd }|jd }|jd }|jd}|jd}d} |jd} |jjdd} t||} tj j |s|jd|ztj j|s|jd|z| tj|} | rd| vr|jd| zt||| | |j}|j|}|| d< |j!|}|| d<tj j |r|j|}||k7r| rQ|j%| |z\}}}t|||| d<|dk7r#t'||jd |d!||r||j)|| d"<|j+|||jd#$d}t'|| |j-|j}|j/||| d%<d&| d'<|j0d(i| y#tj$r-} |jdt| d|dYd} ~ d} ~ wwxYw#t"$rd}YmwxYw))NrT)typerequiredstr)r>boolF)r>default) srcr%destbackup remote_srcregexpr'validatedecrypt) argument_specadd_file_common_argsrCrDrEr%rGr'rH)rCrDzSource (%s) does not exist)msgzSource (%s) is not a directoryzInvalid Regexp (z) in ""z%szvalidate must contain %%s: %schecksummd5sum)rcstdoutstderr validationrzfailed to validate: rc:z error: backup_file unsafe_writes)rUchangedOKrL)rdictparamsgetrrr6 fail_jsonisdirrecompileerrorrr3r(sha1md5 ValueError run_commandr< backup_local atomic_moveload_file_common_argumentsset_fs_attributes_if_different exit_json)modulerV path_hash dest_hashrCrDrEr%rGr&r'rHr:r;rpathmd5rPouterr file_argss r2mainrqs2 &40&6D1VU36U#FE:u% fd3 "#F(GII -- C == D ]]8 $F k*I ]]8 $FOMM/2M}}  T2H c %F 77>># 9C?@ 77== =CD  [ jj0OD(>M MM__main__)NNFN)N) __future__r DOCUMENTATIONEXAMPLESRETURNr rr^ransible.module_utils.basicransible.module_utils.sixrr+ansible.module_utils.common.text.convertersrr3r<rq__name__rXr2r|s]#^ @ &  42A+\dUp zFr{