�
�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
Z d d l
Z
d d l Z d d l Z d d l
Z
d d l Z d d l Z d d l Z d d l Z d d l m Z d d e d
� Z d � Z d � Z d � Z d � Z d � Z e d k re � n d S( i ( t absolute_importt divisiont print_functions 1.1t metadata_versiont stableinterfacet statust coret supported_bys�
---
module: find
author: Brian Coca (@bcoca)
version_added: "2.0"
short_description: Return a list of files based on specific criteria
description:
- Return a list of files based on specific criteria. Multiple criteria are AND'd together.
- For Windows targets, use the M(win_find) module instead.
options:
age:
description:
- Select files whose age is equal to or greater than the specified time.
- Use a negative age to find files equal to or less than the specified time.
- You can choose seconds, minutes, hours, days, or weeks by specifying the
first letter of any of those words (e.g., "1w").
type: str
patterns:
default: []
description:
- One or more (shell or regex) patterns, which type is controlled by C(use_regex) option.
- The patterns restrict the list of files to be returned to those whose basenames match at
least one of the patterns specified. Multiple patterns can be specified using a list.
- The pattern is matched against the file base name, excluding the directory.
- When using regexen, the pattern MUST match the ENTIRE file name, not just parts of it. So
if you are looking to match all files ending in .default, you'd need to use '.*\.default'
as a regexp and not just '\.default'.
- This parameter expects a list, which can be either comma separated or YAML. If any of the
patterns contain a comma, make sure to put them in a list to avoid splitting the patterns
in undesirable ways.
- Defaults to '*' when C(use_regex=False), or '.*' when C(use_regex=True).
type: list
aliases: [ pattern ]
excludes:
description:
- One or more (shell or regex) patterns, which type is controlled by C(use_regex) option.
- Items whose basenames match an C(excludes) pattern are culled from C(patterns) matches.
Multiple patterns can be specified using a list.
type: list
aliases: [ exclude ]
version_added: "2.5"
contains:
description:
- A regular expression or pattern which should be matched against the file content.
type: str
paths:
description:
- List of paths of directories to search. All paths must be fully qualified.
type: list
required: true
aliases: [ name, path ]
file_type:
description:
- Type of file to select.
- The 'link' and 'any' choices were added in Ansible 2.3.
type: str
choices: [ any, directory, file, link ]
default: file
recurse:
description:
- If target is a directory, recursively descend into the directory looking for files.
type: bool
default: no
size:
description:
- Select files whose size is equal to or greater than the specified size.
- Use a negative size to find files equal to or less than the specified size.
- Unqualified values are in bytes but b, k, m, g, and t can be appended to specify
bytes, kilobytes, megabytes, gigabytes, and terabytes, respectively.
- Size is not evaluated for directories.
age_stamp:
description:
- Choose the file property against which we compare age.
type: str
choices: [ atime, ctime, mtime ]
default: mtime
hidden:
description:
- Set this to C(yes) to include hidden files, otherwise they will be ignored.
type: bool
default: no
follow:
description:
- Set this to C(yes) to follow symlinks in path for systems with python 2.6+.
type: bool
default: no
get_checksum:
description:
- Set this to C(yes) to retrieve a file's SHA1 checksum.
type: bool
default: no
use_regex:
description:
- If C(no), the patterns are file globs (shell).
- If C(yes), they are python regexes.
type: bool
default: no
depth:
description:
- Set the maximum number of levels to descend into.
- Setting recurse to C(no) will override this value, which is effectively depth 1.
- Default is unlimited depth.
type: int
version_added: "2.6"
seealso:
- module: win_find
s
- name: Recursively find /tmp files older than 2 days
find:
paths: /tmp
age: 2d
recurse: yes
- name: Recursively find /tmp files older than 4 weeks and equal or greater than 1 megabyte
find:
paths: /tmp
age: 4w
size: 1m
recurse: yes
- name: Recursively find /var/tmp files with last access time greater than 3600 seconds
find:
paths: /var/tmp
age: 3600
age_stamp: atime
recurse: yes
- name: Find /var/log files equal or greater than 10 megabytes ending with .old or .log.gz
find:
paths: /var/log
patterns: '*.old,*.log.gz'
size: 10m
# Note that YAML double quotes require escaping backslashes but yaml single quotes do not.
- name: Find /var/log files equal or greater than 10 megabytes ending with .old or .log.gz via regex
find:
paths: /var/log
patterns: "^.*?\\.(?:old|log\\.gz)$"
size: 10m
use_regex: yes
- name: Find /var/log all directories, exclude nginx and mysql
find:
paths: /var/log
recurse: no
file_type: directory
excludes: 'nginx,mysql'
# When using patterns that contain a comma, make sure they are formatted as lists to avoid splitting the pattern
- name: Use a single pattern that contains a comma formatted as a list
find:
paths: /var/log
file_type: file
use_regex: yes
patterns: ['^_[0-9]{2,4}_.*.log$']
- name: Use multiple patterns that contain a comma formatted as a YAML list
find:
paths: /var/log
file_type: file
use_regex: yes
patterns:
- '^_[0-9]{2,4}_.*.log$'
- '^[a-z]{1,5}_.*log$'
sk
files:
description: All matches found with the specified criteria (see stat module for full output of each dictionary)
returned: success
type: list
sample: [
{ path: "/var/tmp/test1",
mode: "0644",
"...": "...",
checksum: 16fac7be61a6e4591a33ef4b729c5c3302307523
},
{ path: "/var/tmp/test2",
"...": "..."
},
]
matched:
description: Number of matches
returned: success
type: int
sample: 14
examined:
description: Number of filesystem objects looked at
returned: success
type: int
sample: 34
N( t
AnsibleModulec C` s | d k r | d k r t S| r� | rj | d k rj x� | D]( } t j | � } | j | � r; t Sq; Wq{| r{| r{xf | D][ } t j | � } | j | � r} x0 | D]( } t j | � } | j | � r� t Sq� Wt Sq} Wq{n� | r | d k r x� | D] } t j | | � r� t Sq� Wn] | r{| r{xN | D]C } t j | | � r1x$ | D] } t j | | � rPt SqPWt Sq1Wn t S( s filter using glob patternsN( t Nonet Truet ret compilet matcht Falset fnmatch( t ft patternst excludest use_regext pt rt e( ( s> /usr/lib/python2.7/site-packages/ansible/modules/files/find.pyt pfilter� s:
c C` sz | d k r t S| d k rC | | j d | � t | � k rC t S| d k rv | | j d | � t | � k rv t St S( s filter files older than agei s st_%sN( R R
t __getattribute__t absR ( t stt nowt aget timestamp( ( s> /usr/lib/python2.7/site-packages/ansible/modules/files/find.pyt agefilter s //c C` s^ | d k r t S| d k r5 | j t | � k r5 t S| d k rZ | j t | � k rZ t St S( s filter files greater than sizei N( R R
t st_sizeR R ( R t size( ( s> /usr/lib/python2.7/site-packages/ansible/modules/files/find.pyt
sizefilter s !!c C` st | d k r t St j | � } y= t | � �+ } x! | D] } | j | � r8 t Sq8 WWd QXWn t k
ro n Xt S( s
Filter files which contain the given expression
:arg fsname: Filename to scan for lines matching a pattern
:arg pattern: Pattern to look for inside of line
:rtype: bool
:returns: True if one of the lines in fsname matches the pattern. Otherwise False
N( R R
R R t openR
t ExceptionR ( t fsnamet patternt progR t line( ( s> /usr/lib/python2.7/site-packages/ansible/modules/files/find.pyt
contentfilter s
c C` sk d } d } y t j | j � j } Wn t k
r8 n Xy t j | j � j } Wn t k
re n Xi d t j
| j � d 6t j | j � d 6t j
| j � d 6t j | j � d 6t j | j � d 6t j | j � d 6t j | j � d 6t j | j � d
6| j d 6| j d 6| j d
6| j d 6| j d 6| j d 6| j d 6| j d 6| j d 6| d 6| d 6t | j t j @� d 6t | j t j @� d 6t | j t j @� d 6t | j t j @� d 6t | j t j @� d 6t | j t j @� d 6t | j t j! @� d 6t | j t j" @� d 6t | j t j# @� d 6t | j t j$ @� d 6t | j t j% @� d 6S(! Nt s %04ot modet isdirt ischrt isblkt isregt isfifot islnkt issockt uidt gidR t inodet devt nlinkt atimet mtimet ctimet gr_namet pw_namet wusrt rusrt xusrt wgrpt rgrpt xgrpt wotht rotht xotht isuidt isgid(& t pwdt getpwuidt st_uidR; R# t grpt getgrgidt st_gidR: t statt S_IMODEt st_modet S_ISDIRt S_ISCHRt S_ISBLKt S_ISREGt S_ISFIFOt S_ISLNKt S_ISSOCKR t st_inot st_devt st_nlinkt st_atimet st_mtimet st_ctimet boolt S_IWUSRt S_IRUSRt S_IXUSRt S_IWGRPt S_IRGRPt S_IXGRPt S_IWOTHt S_IROTHt S_IXOTHt S_ISUIDt S_ISGID( R R; R: ( ( s> /usr/lib/python2.7/site-packages/ansible/modules/files/find.pyt statinfo8 sR
c ! C` s� t d t d t d d d t d d d g d d
� d t d d d g d d
g d d
� d t d d d d g d d
� d t d d
� d t d d
d d d d d d d g � d t d d
� d t d d
d d d d d d g � d t d d
� d t d d d t � d t d d d t � d t d d d t � d! t d d d t � d" t d d d t � d# t d d$ � � d% t � } | j } | d s�| d" r�d& g | d <q�d' g | d <n g } | d d k r�d } n� t j d( | d j � � } i d) d* 6d+ d, 6d- d. 6d/ d0 6d1 d2 6} | rIt | j
d) � � | j | j
d3 � d) � } n | j d | d d4 d5 � | d d k r|d } n� t j d6 | d j � � } i d) d7 6d8 d9 6dK d, 6dL d; 6dM d= 6} | r�t | j
d) � � | j | j
d3 � d) � } n | j d | d d4 d> � t
j
� } d? } d@ }
xG| d D];} t j j t j j | � � } t j j | � rbxt j dN k r�t j | � p�t j | dB | d �D]�\ } }
} | d# r"| j | j t j j � d? � j t j j � } | s�|
r| d) 7} n | | d# k r"|
2q�q"n |
t | � t |
� }
x| |
D]} t j j t j j | | � � } t j j | � j dC � r�| d r�qGn y t j | � } Wn" t k
r�| dD | 7} qGn Xi | d 6} | d d k r�t! | | d | d | d" � rIt" | | | | d � rI| j# t$ | � � t% j& | j' � rn| d! rn| j( | � | dE <n | j) | � qIqGt% j* | j' � r| d d k rt! | | d | d | d" � rIt" | | | | d � rI| j# t$ | � � | j) | � qIqGt% j& | j' � r�| d d k r�t! | | d | d | d" � rIt" | | | | d � rIt+ | | � rIt, | | d � rI| j# t$ | � � | d! r�| j( | � | dE <n | j) | � qIqGt% j- | j' � rG| d d k rGt! | | d | d | d" � rIt" | | | | d � rI| j# t$ | � � | j) | � qIqGqGW| d s�Pq�q�Wq5| dF | 7} q5Wt | � } | j. dG | dH t d4 | dI | dJ |
� d S(O Nt
argument_spect pathst typet listt requiredt aliasest namet patht elementst strR t defaultR% R t excludet containst file_typet filet choicest anyt directoryt linkR t age_stampR8 R7 R9 R t recurseR] t hiddent followt get_checksumR t deptht intt supports_check_modes .*t *s ^(-?\d+)(s|m|h|d|w)?$i t si< t mi t hi�Q t di�: t wi t msgs failed to process ages ^(-?\d+)(b|k|m|g|t)?$t bi t ki t gi t ts failed to process sizeR) i i t followlinkst .sO %s was skipped as it does not seem to be a valid file or it cannot be accessed
t checksumsT %s was skipped as it does not seem to be a valid directory or it cannot be accessed
t filest changedt matchedt examinedi i @I ( i i i (/ R t dictR
R t paramsR R R
t lowerR� t groupt gett fail_jsont timet osRq t
expandusert
expandvarsR+ t syst version_infot walkt replacet rstript sept countt lent normpatht joint basenamet
startswitht lstatR# R R t updateRi RM RS RO t sha1t appendRP R! R( RU t exit_json( t moduleR� t filelistR R� t seconds_per_unitR t bytes_per_unitR R� t lookedt npatht roott dirsR� R� t fsobjR$ R R R� ( ( s> /usr/lib/python2.7/site-packages/ansible/modules/files/find.pyt mainh s� '$ '$
)1 )1 G
0
!&
: ":"!"
":
t __main__( t
__future__R R R Rl t
__metaclass__t ANSIBLE_METADATAt
DOCUMENTATIONt EXAMPLESt RETURNR RJ R� RG R RM R� R� t ansible.module_utils.basicR R R R R R! R( Ri R� t __name__( ( ( s> /usr/lib/python2.7/site-packages/ansible/modules/files/find.pyt <module>
s0
l> ' 0 }
Anons79 File Manager Version 1.0, Coded By Anons79
Email: [email protected]
Anons79 Mini Shell