Metadata-Version: 2.1
Name: refind
Version: 0.9.2
Summary: A find clone in Python with both CLI and library interfaces
Home-page: https://github.com/Tails86/refind
Author: James Smith
Author-email: jmsmith86@gmail.com
License: UNKNOWN
Project-URL: Documentation, https://github.com/Tails86/refind
Project-URL: Bug Reports, https://github.com/Tails86/refind/issues
Project-URL: Source Code, https://github.com/Tails86/refind
Description: # refind
        A find clone in Python with both CLI and library interfaces
        
        ## Installation
        This project is uploaded to PyPI at https://pypi.org/project/refind/
        
        To install, ensure you are connected to the internet and execute: `python3 -m pip install refind`
        
        ## CLI Help
        ```
        Partially implements find command entirely in Python.
        
            Usage: find.py [path...] [expression...]
        
            default path is the current directory (.); default action is -print
        
            operators
                ! EXPR
                -not EXPR  Inverts the resulting value of the expression
                EXPR EXPR
                EXPR -a EXPR
                EXPR -and EXPR  Logically AND the left and right expressions' result
                EXPR -o EXPR
                EXPR -or EXPR   Logically OR the left and right expressions' result
        
            normal options
                -help  Shows help and exit
                -maxdepth LEVELS  Sets the maximum directory depth of find (default: inf)
                -mindepth LEVELS  Sets the minimum directory depth of find (default: 0)
                -regextype TYPE  Set the regex type to py, sed, egrep (default: sed)
        
            tests
                -name PATTERN  Tests against the name of item using fnmatch
                -regex PATTERN  Tests against the path to the item using re
                -type [dfl]  Tests against item type directory, file, or link
                -path PATTERN
                -wholename PATTERN  Tests against the path to the item using fnmatch
                -amin [+-]N  Last accessed N, greater than +N, or less than -N minutes ago
                -anewer FILE  Last accessed time is more recent than given file
                -atime [+-]N  Last accessed N, greater than +N, or less than -N days ago
                -cmin [+-]N  Change N, greater than +N, or less than -N minutes ago
                -cnewer FILE  Change time is more recent than given file
                -ctime [+-]N  Change N, greater than +N, or less than -N days ago
                -empty  File is 0 bytes or directory empty
                -executable  Matches items which are executable by current user
                -false  Always false
                -gid GID  Matches with group ID
                -group GNAME  Matches with group name or ID
                -mmin [+-]N  Modified N, greater than +N, or less than -N minutes ago
                -newer FILE  Modified time is more recent than given file
                -mtime [+-]N  Modified N, greater than +N, or less than -N days ago
                -newerXY REF  Matches REF X < item Y where X and Y can be:
                              a: Accessed time of item or REF
                              c: Change time of item or REF
                              m: Modified time of item or REF
                              t: REF is timestamp (only valid for X)
                -nogroup  Matches items which aren't assigned to a group
                -nouser  Matches items which aren't assigned to a user
                -perm [-/]PERM  Matches exactly bits in PERM, all in -PERM, any in /PERM
                -readable  Matches items which are readable by current user
                -true  Always true
                -uid UID  Matches with user ID
                -user UNAME  Matches with user name or ID
                -writable  Matches items which are writable by current user
        
            actions
                -print  Print the matching path
                -print0  Print the matching path without newline
                -pyprint PYFORMAT  Print using python print() using named args:
                                   find_root: the root given to find.py
                                   root: the directory name this item is in
                                   rel_dir: the relative directory name from root
                                   name: the name of the item
                                   full_path: the full path of the item
                                   mode_oct: st_mode as octal string
                                   perm: the octal permission value
                                   any st args from os.stat()
                -pyprint0 PYFORMAT  Same as pyprint except end is set to empty string
                -exec COMMAND ;  Execute the COMMAND where {} in the command is the matching path
                -pyexec PYFORMAT ;  Execute the COMMAND as a pyformat (see pyprint)
                -delete  Deletes every matching path
        ```
Keywords: find,files,regex,print
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Information Technology
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.5
Description-Content-Type: text/markdown
Provides-Extra: dev
