File::Find::Rule - Alternative interface to File::Find

<!DOCTYPE html> <html lang="en-US"> <head> <title>File::Find::Rule - Alternative interface to File::Find - metacpan.org</title> <link rel="preload" as="fetch" href="/account/login_status" crossorigin="anonymous" /> <link href="/assets/style-XFEQ536G.css" rel="stylesheet" type="text/css"> <script src="/assets/main-WXBSEDQJ.js" type="module"></script> <link rel="alternate" type="application/rss+xml" title="Recent CPAN Uploads of File-Find-Rule - MetaCPAN" href="/dist/File-Find-Rule/releases.rss" /> <link rel="canonical" href="https://metacpan.org/pod/File::Find::Rule" /> <meta name="description" content="Alternative interface to File::Find" /> <meta name="viewport" content="width=device-width, initial-scale=1, maximum-scale=5"> <link rel="shortcut icon" href="/static/icons/favicon.ico"> <link rel="apple-touch-icon" sizes="152x152" href="/static/icons/apple-touch-icon.png"> <link rel="search" href="/static/opensearch.xml" type="application/opensearchdescription+xml" title="MetaCPAN"> <script async src="https://perl-ads.perlhacks.com/perl-ads.js"></script> <script async src="https://www.googletagmanager.com/gtag/js?id=G-E82Q2V8LVD"></script> <meta property="og:site_name" content="MetaCPAN" /> <meta name="twitter:site" content="@metacpan" /> <meta property="og:type" content="article" /> <meta name="twitter:card" content="summary" /> <meta property="og:url" content="https://metacpan.org/pod/File::Find::Rule" /> <meta property="og:title" content="File::Find::Rule" /> <meta property="og:description" content="Alternative interface to File::Find" /> <meta property="og:image" content="https://metacpan.org/static/images/dots.png" /> </head> <body> <nav class="navbar navbar-default" role="navigation"> <div class="header-logo-large hidden-xs"> <a href="/" tabindex="0"> <svg class="logo" aria-label="MetaCPAN"> <use class="logo" href="/static/images/metacpan-logo.svg#logo" /> </svg> </a> </div> <div class="header-logo-icon visible-xs"> <a href="/"> <svg class="logo" aria-label="MetaCPAN"> <use class="logo" href="/static/images/metacpan-logo.svg#dots" /> </svg> </a> </div> <ul class="nav navbar-nav menu-items hidden-xs hidden-sm"> <li><a href="/about">About</a></li> <li><a href="/about/sponsors">Sponsor</a></li> <li><a href="https://grep.metacpan.org/">grep::cpan</a></li> <li><a href="/recent">Recent</a></li> <li><a href="/about/faq">FAQ</a></li> <li><a href="/tools">Tools</a></li> <li><a href="https://fastapi.metacpan.org/">API</a></li> </ul> <ul class="nav navbar-nav navbar-right"> <button type="button" class="searchbar-btn visible-xs visible-sm"> <i class="fa fa-search button-fa-icon"></i> </button> <form action="/search" class="searchbar-form visible-md visible-lg search-form form-horizontal"> <input type="hidden" name="size" id="metacpan_search-size" value="20"> <div class="form-group"> <div class="search-group"> <i class="fa fa-search"></i> <input type="text" name="q" placeholder="Search the CPAN" size="41" autocorrect="off" autocapitalize="off" spellcheck="false" id="metacpan_search-input" class="form-control" value=""> </div> </div> </form> <li class="icon-slidepanel visible-xs visible-sm"> <button data-toggle="slidepanel" data-target=".slidepanel"> <span class="button-fa-icon"> <i class="fa fa-bars slidepanel-open"></i> <i class="fa fa-times slidepanel-close"></i> </span> </button> </li> <li class="dropdown login-dropdown show-logged-in"> <button type="button" class="dropdown-toggle" data-toggle="dropdown"> <i class="fa fa-user button-fa-icon logged-in-icon" aria-hidden="true"></i> <i class="fas fa-chevron-down"></i> </button> <ul class="dropdown-menu"> <li><a href="/account/identities">Identities</a></li> <li><a href="/account/profile">Profile</a></li> <li><a href="/account/favorite/list">Favorites</a></li> <li> <a href="#" type="button" class="logout-button"> Logout </a> </li> </ul> </li> <li class="dropdown login-dropdown show-logged-out"> <button type="button" class="dropdown-toggle" data-toggle="dropdown"> <i class="fa fa-user button-fa-icon avatar-placeholder" aria-hidden="true"></i> <i class="fas fa-chevron-down"></i> </button> <ul class="dropdown-menu"> <li> <a href="/login/github"> <i class="fab fa-github fa-fw"></i> GitHub </a> </li> <li> <a href="/login/twitter"> <i class="fab fa-twitter fa-fw"></i> Twitter </a> </li> <li> <a href="/login/google"> <i class="fab fa-google fa-fw"></i> Google </a> </li> </ul> </li> <li class="dropdown login-dropdown hide-logged-in hide-logged-out"> <button> <i class="fa fa-user button-fa-icon" aria-hidden="true"></i> </button> </li> </ul> </nav> <div class="page-content "> <div id="perl-ad-target" class="top-notify-banner perl-ad-target"> </div> <nav class="sidebar"> <div class="slidepanel"> <ul class="nav-list "> <li class="nav-header no-margin-top"> <div class="ttip" data-toggle="tooltip" data-placement="bottom" title="The date that this version of File-Find-Rule was released."> <span class="relatize">03 Dec 2015 14:31:54 UTC</span> </div> </li> <li> Distribution: <a href="/dist/File-Find-Rule">File-Find-Rule</a> </li> <li> Module version: 0.34 </li> <li> <a data-keyboard-shortcut="g s" href="/dist/File-Find-Rule/source/lib/File/Find/Rule.pm">Source</a> (<a href="/dist/File-Find-Rule/source/lib/File/Find/Rule.pm?raw=1">raw</a>) </li> <li> <a data-keyboard-shortcut="g b" href="/dist/File-Find-Rule/source/lib/File/Find">Browse</a> (<a href="/dist/File-Find-Rule/source/lib/File/Find?raw=1">raw</a>) </li> <li> <a data-keyboard-shortcut="g c" href="/dist/File-Find-Rule/changes">Changes</a> </li> <li> <a class="nopopup" href="/dist/File-Find-Rule/contribute">How to Contribute</a> </li> <li> <a rel="noopener nofollow" data-keyboard-shortcut="g i" href="https://rt.cpan.org/Public/Dist/Display.html?Name=File-Find-Rule">Issues</a> (17) </li> <li> <a rel="noopener nofollow" href="http://matrix.cpantesters.org/?dist=File-Find-Rule+0.34" title="Matrix">Testers</a> <span title="(pass / fail / na)">(<a rel="noopener nofollow" href="https://www.cpantesters.org/distro/F/File-Find-Rule.html?oncpan=1&distmat=1&version=0.34&grade=2" style="color: #090">15555</a> / <a rel="noopener nofollow" href="https://www.cpantesters.org/distro/F/File-Find-Rule.html?oncpan=1&distmat=1&version=0.34&grade=3" style="color: #900">3</a> / <a rel="noopener nofollow" href="https://www.cpantesters.org/distro/F/File-Find-Rule.html?oncpan=1&distmat=1&version=0.34&grade=4">0</a>)</span> </li> <li> <a rel="noopener nofollow" href="http://cpants.cpanauthors.org/release/RCLAMP/File-Find-Rule-0.34">Kwalitee</a> </li> <li> <div class="ttip" data-toggle="tooltip" data-placement="bottom" title="The # people with an indexing permission on File-Find-Rule who have released something to CPAN in the last 2 years (i.e. the # people likely able to release critical fixes in a timely manner)"> Bus factor: 1 </div> </li> <li> <a rel="noopener nofollow" href="http://cpancover.com/latest/File-Find-Rule-0.34/index.html">71.15% Coverage </a> </li> <li> License: unknown </li> <li class="nav-header">Activity</li> <li> <div class="activity-graph"> <img src="/dist/File-Find-Rule/activity.svg?res=month" /> <div class="comment">24 month</div> </div> </li> <li class="nav-header">Tools</li> <li> <a itemprop="downloadUrl" href="https://cpan.metacpan.org/authors/id/R/RC/RCLAMP/File-Find-Rule-0.34.tar.gz"> Download (<span itemprop="fileSize">15.79KB</span>)</a> </li> <li> <a href="https://explorer.metacpan.org/?url=%2Fmodule%2FRCLAMP%2FFile-Find-Rule-0.34%2Flib%2FFile%2FFind%2FRule.pm"> MetaCPAN Explorer </a> </li> <li> <a href="/dist/File-Find-Rule/permissions"> Permissions </a> </li> <li> <a href="/dist/File-Find-Rule/releases.rss"> Subscribe to distribution </a> </li> <li> <button class="btn btn-link" data-toggle="modal" data-target="#metacpan_install-instructions-dialog"> Install Instructions </button> </li> <li> <form action="/search"> <input type="hidden" name="q" value="dist:File-Find-Rule"> <input type="search" name="q" placeholder="Search distribution" class="form-control tool-bar-form"> <input type="submit" style="display: none"> </form> </li> <li> <form action="https://grep.metacpan.org/search"> <input type="hidden" name="qd" value="File-Find-Rule"> <input type="hidden" name="source" value="metacpan"> <input type="search" name="q" placeholder="grep distribution" class="form-control tool-bar-form"> <input type="submit" style="display: none"> </form> </li> <li class="version-jump"> <select class="select-navigator form-control tool-bar-form"> <option disabled selected>Jump to version</option> <option disabled value="/release/RCLAMP/File-Find-Rule-0.34/view/lib/File/Find/Rule.pm" >0.34 (RCLAMP on 2015-12-03)</option> <option value="/release/RCLAMP/File-Find-Rule-0.33/view/lib/File/Find/Rule.pm" >0.33 (RCLAMP on 2011-09-19)</option> <option value="/release/RCLAMP/File-Find-Rule-0.32/view/lib/File/Find/Rule.pm" >0.32 (RCLAMP on 2009-11-28)</option> <option value="/release/RCLAMP/File-Find-Rule-0.31/view/lib/File/Find/Rule.pm" >0.31 (RCLAMP on 2009-11-27)</option> <option value="/release/RCLAMP/File-Find-Rule-0.30/view/lib/File/Find/Rule.pm" >0.30 (RCLAMP on 2006-06-01)</option> <option value="/release/RCLAMP/File-Find-Rule-0.29/view/lib/File/Find/Rule.pm" >0.29 (RCLAMP on 2006-05-16)</option> <option value="/release/RCLAMP/File-Find-Rule-0.28/view/lib/File/Find/Rule.pm" >0.28 (RCLAMP on 2004-05-18)</option> <optgroup label="BackPAN">' <option value="/release/RCLAMP/File-Find-Rule-0.27/view/lib/File/Find/Rule.pm" >0.27 (RCLAMP on 2004-02-25)</option> <option value="/release/RCLAMP/File-Find-Rule-0.26/view/lib/File/Find/Rule.pm" >0.26 (RCLAMP on 2003-11-10)</option> <option value="/release/RCLAMP/File-Find-Rule-0.25/view/lib/File/Find/Rule.pm" >0.25 (RCLAMP on 2003-10-22)</option> <option value="/release/RCLAMP/File-Find-Rule-0.24/view/lib/File/Find/Rule.pm" >0.24 (RCLAMP on 2003-10-06)</option> <option value="/release/RCLAMP/File-Find-Rule-0.24_01/view/lib/File/Find/Rule.pm" >0.24_01 DEV (RCLAMP on 2003-10-04)</option> <option value="/release/RCLAMP/File-Find-Rule-0.23/view/lib/File/Find/Rule.pm" >0.23 (RCLAMP on 2003-10-03)</option> <option value="/release/RCLAMP/File-Find-Rule-0.22/view/lib/File/Find/Rule.pm" >0.22 (RCLAMP on 2003-10-03)</option> <option value="/release/RCLAMP/File-Find-Rule-0.21/view/lib/File/Find/Rule.pm" >0.21 (RCLAMP on 2003-09-15)</option> <option value="/release/RCLAMP/File-Find-Rule-0.20/view/lib/File/Find/Rule.pm" >0.20 (RCLAMP on 2003-09-08)</option> <option value="/release/RCLAMP/File-Find-Rule-0.20_03/view/lib/File/Find/Rule.pm" >0.20_03 DEV (RCLAMP on 2003-08-04)</option> <option value="/release/RCLAMP/File-Find-Rule-0.11/view/lib/File/Find/Rule.pm" >0.11 (RCLAMP on 2003-07-29)</option> <option value="/release/RCLAMP/File-Find-Rule-0.20_02/view/lib/File/Find/Rule.pm" >0.20_02 DEV (RCLAMP on 2003-06-25)</option> <option value="/release/RCLAMP/File-Find-Rule-0.20_01/view/lib/File/Find/Rule.pm" >0.20_01 DEV (RCLAMP on 2003-06-22)</option> <option value="/release/RCLAMP/File-Find-Rule-0.10/view/lib/File/Find/Rule.pm" >0.10 (RCLAMP on 2003-03-10)</option> <option value="/release/RCLAMP/File-Find-Rule-0.09/view/lib/File/Find/Rule.pm" >0.09 (RCLAMP on 2003-01-21)</option> <option value="/release/RCLAMP/File-Find-Rule-0.08/view/lib/File/Find/Rule.pm" >0.08 (RCLAMP on 2002-12-04)</option> <option value="/release/RCLAMP/File-Find-Rule-0.07/view/lib/File/Find/Rule.pm" >0.07 (RCLAMP on 2002-10-25)</option> <option value="/release/RCLAMP/File-Find-Rule-0.06/view/lib/File/Find/Rule.pm" >0.06 (RCLAMP on 2002-10-22)</option> <option value="/release/RCLAMP/File-Find-Rule-0.05/view/lib/File/Find/Rule.pm" >0.05 (RCLAMP on 2002-10-21)</option> <option value="/release/RCLAMP/File-Find-Rule-0.04/view/lib/File/Find/Rule.pm" >0.04 (RCLAMP on 2002-09-10)</option> <option value="/release/RCLAMP/File-Find-Rule-0.03/view/lib/File/Find/Rule.pm" >0.03 (RCLAMP on 2002-08-24)</option> <option value="/release/RCLAMP/File-Find-Rule-0.02/view/lib/File/Find/Rule.pm" >0.02 (RCLAMP on 2002-08-14)</option> <option value="/release/RCLAMP/File-Find-Rule-0.01/view/lib/File/Find/Rule.pm" >0.01 (RCLAMP on 2002-07-26)</option> </optgroup> </select> </li> <li class="version-diff"> <select class="select-navigator form-control tool-bar-form"> <option disabled selected>Diff with version</option> <option disabled value="/release/RCLAMP/File-Find-Rule-0.34/diff/RCLAMP/File-Find-Rule-0.34/lib/File/Find/Rule.pm" >0.34 (RCLAMP on 2015-12-03)</option> <option value="/release/RCLAMP/File-Find-Rule-0.34/diff/RCLAMP/File-Find-Rule-0.33/lib/File/Find/Rule.pm" >0.33 (RCLAMP on 2011-09-19)</option> <option value="/release/RCLAMP/File-Find-Rule-0.34/diff/RCLAMP/File-Find-Rule-0.32/lib/File/Find/Rule.pm" >0.32 (RCLAMP on 2009-11-28)</option> <option value="/release/RCLAMP/File-Find-Rule-0.34/diff/RCLAMP/File-Find-Rule-0.31/lib/File/Find/Rule.pm" >0.31 (RCLAMP on 2009-11-27)</option> <option value="/release/RCLAMP/File-Find-Rule-0.34/diff/RCLAMP/File-Find-Rule-0.30/lib/File/Find/Rule.pm" >0.30 (RCLAMP on 2006-06-01)</option> <option value="/release/RCLAMP/File-Find-Rule-0.34/diff/RCLAMP/File-Find-Rule-0.29/lib/File/Find/Rule.pm" >0.29 (RCLAMP on 2006-05-16)</option> <option value="/release/RCLAMP/File-Find-Rule-0.34/diff/RCLAMP/File-Find-Rule-0.28/lib/File/Find/Rule.pm" >0.28 (RCLAMP on 2004-05-18)</option> <optgroup label="BackPAN">' <option value="/release/RCLAMP/File-Find-Rule-0.34/diff/RCLAMP/File-Find-Rule-0.27/lib/File/Find/Rule.pm" >0.27 (RCLAMP on 2004-02-25)</option> <option value="/release/RCLAMP/File-Find-Rule-0.34/diff/RCLAMP/File-Find-Rule-0.26/lib/File/Find/Rule.pm" >0.26 (RCLAMP on 2003-11-10)</option> <option value="/release/RCLAMP/File-Find-Rule-0.34/diff/RCLAMP/File-Find-Rule-0.25/lib/File/Find/Rule.pm" >0.25 (RCLAMP on 2003-10-22)</option> <option value="/release/RCLAMP/File-Find-Rule-0.34/diff/RCLAMP/File-Find-Rule-0.24/lib/File/Find/Rule.pm" >0.24 (RCLAMP on 2003-10-06)</option> <option value="/release/RCLAMP/File-Find-Rule-0.34/diff/RCLAMP/File-Find-Rule-0.24_01/lib/File/Find/Rule.pm" >0.24_01 DEV (RCLAMP on 2003-10-04)</option> <option value="/release/RCLAMP/File-Find-Rule-0.34/diff/RCLAMP/File-Find-Rule-0.23/lib/File/Find/Rule.pm" >0.23 (RCLAMP on 2003-10-03)</option> <option value="/release/RCLAMP/File-Find-Rule-0.34/diff/RCLAMP/File-Find-Rule-0.22/lib/File/Find/Rule.pm" >0.22 (RCLAMP on 2003-10-03)</option> <option value="/release/RCLAMP/File-Find-Rule-0.34/diff/RCLAMP/File-Find-Rule-0.21/lib/File/Find/Rule.pm" >0.21 (RCLAMP on 2003-09-15)</option> <option value="/release/RCLAMP/File-Find-Rule-0.34/diff/RCLAMP/File-Find-Rule-0.20/lib/File/Find/Rule.pm" >0.20 (RCLAMP on 2003-09-08)</option> <option value="/release/RCLAMP/File-Find-Rule-0.34/diff/RCLAMP/File-Find-Rule-0.20_03/lib/File/Find/Rule.pm" >0.20_03 DEV (RCLAMP on 2003-08-04)</option> <option value="/release/RCLAMP/File-Find-Rule-0.34/diff/RCLAMP/File-Find-Rule-0.11/lib/File/Find/Rule.pm" >0.11 (RCLAMP on 2003-07-29)</option> <option value="/release/RCLAMP/File-Find-Rule-0.34/diff/RCLAMP/File-Find-Rule-0.20_02/lib/File/Find/Rule.pm" >0.20_02 DEV (RCLAMP on 2003-06-25)</option> <option value="/release/RCLAMP/File-Find-Rule-0.34/diff/RCLAMP/File-Find-Rule-0.20_01/lib/File/Find/Rule.pm" >0.20_01 DEV (RCLAMP on 2003-06-22)</option> <option value="/release/RCLAMP/File-Find-Rule-0.34/diff/RCLAMP/File-Find-Rule-0.10/lib/File/Find/Rule.pm" >0.10 (RCLAMP on 2003-03-10)</option> <option value="/release/RCLAMP/File-Find-Rule-0.34/diff/RCLAMP/File-Find-Rule-0.09/lib/File/Find/Rule.pm" >0.09 (RCLAMP on 2003-01-21)</option> <option value="/release/RCLAMP/File-Find-Rule-0.34/diff/RCLAMP/File-Find-Rule-0.08/lib/File/Find/Rule.pm" >0.08 (RCLAMP on 2002-12-04)</option> <option value="/release/RCLAMP/File-Find-Rule-0.34/diff/RCLAMP/File-Find-Rule-0.07/lib/File/Find/Rule.pm" >0.07 (RCLAMP on 2002-10-25)</option> <option value="/release/RCLAMP/File-Find-Rule-0.34/diff/RCLAMP/File-Find-Rule-0.06/lib/File/Find/Rule.pm" >0.06 (RCLAMP on 2002-10-22)</option> <option value="/release/RCLAMP/File-Find-Rule-0.34/diff/RCLAMP/File-Find-Rule-0.05/lib/File/Find/Rule.pm" >0.05 (RCLAMP on 2002-10-21)</option> <option value="/release/RCLAMP/File-Find-Rule-0.34/diff/RCLAMP/File-Find-Rule-0.04/lib/File/Find/Rule.pm" >0.04 (RCLAMP on 2002-09-10)</option> <option value="/release/RCLAMP/File-Find-Rule-0.34/diff/RCLAMP/File-Find-Rule-0.03/lib/File/Find/Rule.pm" >0.03 (RCLAMP on 2002-08-24)</option> <option value="/release/RCLAMP/File-Find-Rule-0.34/diff/RCLAMP/File-Find-Rule-0.02/lib/File/Find/Rule.pm" >0.02 (RCLAMP on 2002-08-14)</option> <option value="/release/RCLAMP/File-Find-Rule-0.34/diff/RCLAMP/File-Find-Rule-0.01/lib/File/Find/Rule.pm" >0.01 (RCLAMP on 2002-07-26)</option> </optgroup> </select> </li> <li> <ul class="dependencies"> <li class="nav-header">Dependencies</li> <li><a href="/pod/File::Find" title="File::Find" class="ellipsis">File::Find</a></li> <li><a href="/pod/File::Spec" title="File::Spec" class="ellipsis">File::Spec</a></li> <li><a href="/pod/Number::Compare" title="Number::Compare" class="ellipsis">Number::Compare</a></li> <li><a href="/pod/Test::More" title="Test::More" class="ellipsis">Test::More</a></li> <li><a href="/pod/Text::Glob" title="Text::Glob" class="ellipsis">Text::Glob</a></li> <li><i class="ttip" title="dynamic_config enabled">and possibly others</i></li> <li> <hr> </li> <li> <a href="/module/File::Find::Rule/requires">Reverse dependencies</a> </li> <li> <a href="http://deps.cpantesters.org/?module=File%3A%3AFind%3A%3ARule">CPAN Testers List</a> </li> <li> <a href="https://cpandeps.grinnz.com/?dist=File-Find-Rule">Dependency graph</a> </li> </ul> </li> <li class="nav-header">Permalinks</li> <li> <a href="/release/RCLAMP/File-Find-Rule-0.34/view/lib/File/Find/Rule.pm">This version</a> </li> <li> <a href="/pod/File::Find::Rule">Latest version</a> </li> <li> <div class="plussers"> <div class="nav-header">++ed by:</div> <div> <a class="display-all" href="/author/LLAP"><img src="https://www.gravatar.com/avatar/fe83c062043dc4e41c9af07b080e306e?d=identicon&s=20" title="LLAP" alt="LLAP"></a> <a class="display-all" href="/author/DMOL"><img src="https://www.gravatar.com/avatar/78b28a931707c0fa696996adc7702db9?d=identicon&s=20" title="DMOL" alt="DMOL"></a> <a class="display-all" href="/author/HANENKAMP"><img src="https://www.gravatar.com/avatar/e5b51c69496e22e3e2d037604cc6d8c9?d=identicon&s=20" title="HANENKAMP" alt="HANENKAMP"></a> <a class="display-all" href="/author/EGOR"><img src="https://www.gravatar.com/avatar/d1b2873e176897abb1f26be3a92e771d?d=identicon&s=20" title="EGOR" alt="EGOR"></a> <a class="display-all" href="/author/SYP"><img src="https://www.gravatar.com/avatar/9b6fa62677be03c25ee1af4d95472042?d=identicon&s=20" title="SYP" alt="SYP"></a> </div>  <div> <a href="/dist/File-Find-Rule/plussers">20 PAUSE users</a> </div> <div> 20 non-PAUSE users </div> </div> </li> <li> </li> </ul> </div> </nav> <div class="content-navigation"> <div class="breadcrumbs"> <span> <a data-keyboard-shortcut="g a" rel="author" href="/author/RCLAMP" class="author-name">Richard Clamp</a> </span> <span> / </span> <div class="release dist-release status-latest maturity-released"> <span class="dropdown"><b class="caret"></b></span> <select class="select-navigator "> <option selected value="/release/RCLAMP/File-Find-Rule-0.34/view/lib/File/Find/Rule.pm" >0.34 (RCLAMP on 2015-12-03)</option> <option value="/release/RCLAMP/File-Find-Rule-0.33/view/lib/File/Find/Rule.pm" >0.33 (RCLAMP on 2011-09-19)</option> <option value="/release/RCLAMP/File-Find-Rule-0.32/view/lib/File/Find/Rule.pm" >0.32 (RCLAMP on 2009-11-28)</option> <option value="/release/RCLAMP/File-Find-Rule-0.31/view/lib/File/Find/Rule.pm" >0.31 (RCLAMP on 2009-11-27)</option> <option value="/release/RCLAMP/File-Find-Rule-0.30/view/lib/File/Find/Rule.pm" >0.30 (RCLAMP on 2006-06-01)</option> <option value="/release/RCLAMP/File-Find-Rule-0.29/view/lib/File/Find/Rule.pm" >0.29 (RCLAMP on 2006-05-16)</option> <option value="/release/RCLAMP/File-Find-Rule-0.28/view/lib/File/Find/Rule.pm" >0.28 (RCLAMP on 2004-05-18)</option> <optgroup label="BackPAN">' <option value="/release/RCLAMP/File-Find-Rule-0.27/view/lib/File/Find/Rule.pm" >0.27 (RCLAMP on 2004-02-25)</option> <option value="/release/RCLAMP/File-Find-Rule-0.26/view/lib/File/Find/Rule.pm" >0.26 (RCLAMP on 2003-11-10)</option> <option value="/release/RCLAMP/File-Find-Rule-0.25/view/lib/File/Find/Rule.pm" >0.25 (RCLAMP on 2003-10-22)</option> <option value="/release/RCLAMP/File-Find-Rule-0.24/view/lib/File/Find/Rule.pm" >0.24 (RCLAMP on 2003-10-06)</option> <option value="/release/RCLAMP/File-Find-Rule-0.24_01/view/lib/File/Find/Rule.pm" >0.24_01 DEV (RCLAMP on 2003-10-04)</option> <option value="/release/RCLAMP/File-Find-Rule-0.23/view/lib/File/Find/Rule.pm" >0.23 (RCLAMP on 2003-10-03)</option> <option value="/release/RCLAMP/File-Find-Rule-0.22/view/lib/File/Find/Rule.pm" >0.22 (RCLAMP on 2003-10-03)</option> <option value="/release/RCLAMP/File-Find-Rule-0.21/view/lib/File/Find/Rule.pm" >0.21 (RCLAMP on 2003-09-15)</option> <option value="/release/RCLAMP/File-Find-Rule-0.20/view/lib/File/Find/Rule.pm" >0.20 (RCLAMP on 2003-09-08)</option> <option value="/release/RCLAMP/File-Find-Rule-0.20_03/view/lib/File/Find/Rule.pm" >0.20_03 DEV (RCLAMP on 2003-08-04)</option> <option value="/release/RCLAMP/File-Find-Rule-0.11/view/lib/File/Find/Rule.pm" >0.11 (RCLAMP on 2003-07-29)</option> <option value="/release/RCLAMP/File-Find-Rule-0.20_02/view/lib/File/Find/Rule.pm" >0.20_02 DEV (RCLAMP on 2003-06-25)</option> <option value="/release/RCLAMP/File-Find-Rule-0.20_01/view/lib/File/Find/Rule.pm" >0.20_01 DEV (RCLAMP on 2003-06-22)</option> <option value="/release/RCLAMP/File-Find-Rule-0.10/view/lib/File/Find/Rule.pm" >0.10 (RCLAMP on 2003-03-10)</option> <option value="/release/RCLAMP/File-Find-Rule-0.09/view/lib/File/Find/Rule.pm" >0.09 (RCLAMP on 2003-01-21)</option> <option value="/release/RCLAMP/File-Find-Rule-0.08/view/lib/File/Find/Rule.pm" >0.08 (RCLAMP on 2002-12-04)</option> <option value="/release/RCLAMP/File-Find-Rule-0.07/view/lib/File/Find/Rule.pm" >0.07 (RCLAMP on 2002-10-25)</option> <option value="/release/RCLAMP/File-Find-Rule-0.06/view/lib/File/Find/Rule.pm" >0.06 (RCLAMP on 2002-10-22)</option> <option value="/release/RCLAMP/File-Find-Rule-0.05/view/lib/File/Find/Rule.pm" >0.05 (RCLAMP on 2002-10-21)</option> <option value="/release/RCLAMP/File-Find-Rule-0.04/view/lib/File/Find/Rule.pm" >0.04 (RCLAMP on 2002-09-10)</option> <option value="/release/RCLAMP/File-Find-Rule-0.03/view/lib/File/Find/Rule.pm" >0.03 (RCLAMP on 2002-08-24)</option> <option value="/release/RCLAMP/File-Find-Rule-0.02/view/lib/File/Find/Rule.pm" >0.02 (RCLAMP on 2002-08-14)</option> <option value="/release/RCLAMP/File-Find-Rule-0.01/view/lib/File/Find/Rule.pm" >0.01 (RCLAMP on 2002-07-26)</option> </optgroup> </select> <a data-keyboard-shortcut="g d" class="release-name" href="/dist/File-Find-Rule">File-Find-Rule-0.34</a> </div> <span class="river-gauge-gauge"> <svg width="24px" height="15px" version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink"> <g> <title> River stage four 
 • 281 direct dependents 
 • 1691 total dependents </title> <rect x="0" y="0" width="4" height="15" fill="#7ea3f2" /> <rect x="5" y="0" width="4" height="15" fill="#7ea3f2" /> <rect x="10" y="0" width="4" height="15" fill="#7ea3f2" /> <rect x="15" y="0" width="4" height="15" fill="#7ea3f2" /> <rect x="20" y="0" width="4" height="15" fill="#e4e2e2" /> </g> </svg> </span> <div id="File-Find-Rule-fav" class="show-logged-in"> <form action="/account/favorite/add" style="display: inline" method="POST"> <input type="hidden" name="remove" value="0"> <input type="hidden" name="release" value="File-Find-Rule-0.34"> <input type="hidden" name="author" value="RCLAMP"> <input type="hidden" name="distribution" value="File-Find-Rule"> <button type="submit" class="favorite highlight"><span>40</span> ++</button> </form> </div> <div class="show-logged-out"> <button class="fav-not-logged-in favorite highlight"><span>40</span> ++</button> </div> / <span>File::Find::Rule</span> </div> </div> <main class="content"> <nav class="toc"> <div class="toc-header"><strong>Contents</strong></div> <ul> <li><a href="#NAME">NAME</a></li> <li><a href="#SYNOPSIS">SYNOPSIS</a></li> <li><a href="#DESCRIPTION">DESCRIPTION</a></li> <li><a href="#METHODS">METHODS</a> <ul> <li><a href="#Matching-Rules">Matching Rules</a></li> <li><a href="#Query-Methods">Query Methods</a></li> <li><a href="#Extensions">Extensions</a></li> <li><a href="#Further-examples">Further examples</a></li> </ul> </li> <li><a href="#TWO-FOR-THE-PRICE-OF-ONE">TWO FOR THE PRICE OF ONE</a></li> <li><a href="#EXPORTS">EXPORTS</a></li> <li><a href="#TAINT-MODE-INTERACTION">TAINT MODE INTERACTION</a></li> <li><a href="#BUGS">BUGS</a></li> <li><a href="#AUTHOR">AUTHOR</a></li> <li><a href="#COPYRIGHT">COPYRIGHT</a></li> <li><a href="#SEE-ALSO">SEE ALSO</a></li> </ul></nav> <div class="pod anchors"> <h1 id="NAME">NAME</h1> <p>File::Find::Rule - Alternative interface to File::Find</p> <h1 id="SYNOPSIS">SYNOPSIS</h1> <pre><code>use File::Find::Rule; # find all the subdirectories of a given directory my @subdirs = File::Find::Rule->directory->in( $directory ); # find all the .pm files in @INC my @files = File::Find::Rule->file() ->name( '*.pm' ) ->in( @INC ); # as above, but without method chaining my $rule = File::Find::Rule->new; $rule->file; $rule->name( '*.pm' ); my @files = $rule->in( @INC );</code></pre> <h1 id="DESCRIPTION">DESCRIPTION</h1> <p>File::Find::Rule is a friendlier interface to File::Find. It allows you to build rules which specify the desired files and directories.</p> <h1 id="METHODS">METHODS</h1> <dl> <dt id="new"><code>new</code></dt> <dd> <p>A constructor. You need not invoke <code>new</code> manually unless you wish to, as each of the rule-making methods will auto-create a suitable object if called as class methods.</p> </dd> </dl> <h2 id="Matching-Rules"><a id="Matching"></a>Matching Rules</h2> <dl> <dt id="name(-@patterns-)"><a id="name"></a><a id="name-patterns"></a><code>name( @patterns )</code></dt> <dd> <p>Specifies names that should match. May be globs or regular expressions.</p> <pre><code>$set->name( '*.mp3', '*.ogg' ); # mp3s or oggs $set->name( qr/\.(mp3|ogg)$/ ); # the same as a regex $set->name( 'foo.bar' ); # just things named foo.bar</code></pre> </dd> <dt id="-X-tests"><a id="X-tests"></a>-X tests</dt> <dd> <p>Synonyms are provided for each of the -X tests. See <a href="/pod/perlfunc#-X">"-X" in perlfunc</a> for details. None of these methods take arguments.</p> <pre><code> Test | Method Test | Method ------|------------- ------|---------------- -r | readable -R | r_readable -w | writeable -W | r_writeable -w | writable -W | r_writable -x | executable -X | r_executable -o | owned -O | r_owned | | -e | exists -f | file -z | empty -d | directory -s | nonempty -l | symlink | -p | fifo -u | setuid -S | socket -g | setgid -b | block -k | sticky -c | character | -t | tty -M | modified | -A | accessed -T | ascii -C | changed -B | binary</code></pre> <p>Though some tests are fairly meaningless as binary flags (<code>modified</code>, <code>accessed</code>, <code>changed</code>), they have been included for completeness.</p> <pre><code># find nonempty files $rule->file, ->nonempty;</code></pre> </dd> <dt id="stat-tests"><a id="stat"></a>stat tests</dt> <dd> <p>The following <code>stat</code> based methods are provided: <code>dev</code>, <code>ino</code>, <code>mode</code>, <code>nlink</code>, <code>uid</code>, <code>gid</code>, <code>rdev</code>, <code>size</code>, <code>atime</code>, <code>mtime</code>, <code>ctime</code>, <code>blksize</code>, and <code>blocks</code>. See <a href="/pod/perlfunc#stat">"stat" in perlfunc</a> for details.</p> <p>Each of these can take a number of targets, which will follow <a href="/pod/Number::Compare">Number::Compare</a> semantics.</p> <pre><code>$rule->size( 7 ); # exactly 7 $rule->size( ">7Ki" ); # larger than 7 * 1024 * 1024 bytes $rule->size( ">=7" ) ->size( "<=90" ); # between 7 and 90, inclusive $rule->size( 7, 9, 42 ); # 7, 9 or 42</code></pre> </dd> <dt id="any(-@rules-)"><a id="any"></a><a id="any-rules"></a><code>any( @rules )</code></dt> <dd> </dd> <dt id="or(-@rules-)"><a id="or"></a><a id="or-rules"></a><code>or( @rules )</code></dt> <dd> <p>Allows shortcircuiting boolean evaluation as an alternative to the default and-like nature of combined rules. <code>any</code> and <code>or</code> are interchangeable.</p> <pre><code># find avis, movs, things over 200M and empty files $rule->any( File::Find::Rule->name( '*.avi', '*.mov' ), File::Find::Rule->size( '>200M' ), File::Find::Rule->file->empty, );</code></pre> </dd> <dt id="none(-@rules-)"><a id="none"></a><a id="none-rules"></a><code>none( @rules )</code></dt> <dd> </dd> <dt id="not(-@rules-)"><a id="not"></a><a id="not-rules"></a><code>not( @rules )</code></dt> <dd> <p>Negates a rule. (The inverse of <code>any</code>.) <code>none</code> and <code>not</code> are interchangeable.</p> <pre><code># files that aren't 8.3 safe $rule->file ->not( $rule->new->name( qr/^[^.]{1,8}(\.[^.]{0,3})?$/ ) );</code></pre> </dd> <dt id="prune"><code>prune</code></dt> <dd> <p>Traverse no further. This rule always matches.</p> </dd> <dt id="discard"><code>discard</code></dt> <dd> <p>Don't keep this file. This rule always matches.</p> </dd> <dt id="exec(-\&subroutine(-$shortname,-$path,-$fullname-)-)"><a id="exec"></a><a id="exec-subroutine-shortname-path-fullname"></a><code>exec( \&subroutine( $shortname, $path, $fullname ) )</code></dt> <dd> <p>Allows user-defined rules. Your subroutine will be invoked with <code>$_</code> set to the current short name, and with parameters of the name, the path you're in, and the full relative filename.</p> <p>Return a true value if your rule matched.</p> <pre><code># get things with long names $rules->exec( sub { length > 20 } );</code></pre> </dd> <dt id="grep(-@specifiers-)"><a id="grep"></a><a id="grep-specifiers"></a><code>grep( @specifiers )</code></dt> <dd> <p>Opens a file and tests it each line at a time.</p> <p>For each line it evaluates each of the specifiers, stopping at the first successful match. A specifier may be a regular expression or a subroutine. The subroutine will be invoked with the same parameters as an ->exec subroutine.</p> <p>It is possible to provide a set of negative specifiers by enclosing them in anonymous arrays. Should a negative specifier match the iteration is aborted and the clause is failed. For example:</p> <pre><code>$rule->grep( qr/^#!.*\bperl/, [ sub { 1 } ] );</code></pre> <p>Is a passing clause if the first line of a file looks like a perl shebang line.</p> </dd> <dt id="maxdepth(-$level-)"><a id="maxdepth"></a><a id="maxdepth-level"></a><code>maxdepth( $level )</code></dt> <dd> <p>Descend at most <code>$level</code> (a non-negative integer) levels of directories below the starting point.</p> <p>May be invoked many times per rule, but only the most recent value is used.</p> </dd> <dt id="mindepth(-$level-)"><a id="mindepth"></a><a id="mindepth-level"></a><code>mindepth( $level )</code></dt> <dd> <p>Do not apply any tests at levels less than <code>$level</code> (a non-negative integer).</p> </dd> <dt id="extras(-\%extras-)"><a id="extras"></a><a id="extras-extras"></a><code>extras( \%extras )</code></dt> <dd> <p>Specifies extra values to pass through to <code>File::File::find</code> as part of the options hash.</p> <p>For example this allows you to specify following of symlinks like so:</p> <pre><code>my $rule = File::Find::Rule->extras({ follow => 1 });</code></pre> <p>May be invoked many times per rule, but only the most recent value is used.</p> </dd> <dt id="relative"><code>relative</code></dt> <dd> <p>Trim the leading portion of any path found</p> </dd> <dt id="canonpath"><code>canonpath</code></dt> <dd> <p>Normalize paths found using <code>File::Spec-</code>canonpath>. This will return paths with a file-seperator that is native to your OS (as determined by <a href="/pod/File::Spec">File::Spec</a>), instead of the default <code>/</code>.</p> <p>For example, this will return <code>tmp/foobar</code> on Unix-ish OSes and <code>tmp\foobar</code> on Win32.</p> </dd> <dt id="not_*"><a id="not_"></a><code>not_*</code></dt> <dd> <p>Negated version of the rule. An effective shortand related to ! in the procedural interface.</p> <pre><code>$foo->not_name('*.pl'); $foo->not( $foo->new->name('*.pl' ) );</code></pre> </dd> </dl> <h2 id="Query-Methods"><a id="Query"></a>Query Methods</h2> <dl> <dt id="in(-@directories-)"><a id="in"></a><a id="in-directories"></a><code>in( @directories )</code></dt> <dd> <p>Evaluates the rule, returns a list of paths to matching files and directories.</p> </dd> <dt id="start(-@directories-)"><a id="start"></a><a id="start-directories"></a><code>start( @directories )</code></dt> <dd> <p>Starts a find across the specified directories. Matching items may then be queried using <a href="#match">"match"</a>. This allows you to use a rule as an iterator.</p> <pre><code>my $rule = File::Find::Rule->file->name("*.jpeg")->start( "/web" ); while ( defined ( my $image = $rule->match ) ) { ... }</code></pre> </dd> <dt id="match"><code>match</code></dt> <dd> <p>Returns the next file which matches, false if there are no more.</p> </dd> </dl> <h2 id="Extensions">Extensions</h2> <p>Extension modules are available from CPAN in the File::Find::Rule namespace. In order to use these extensions either use them directly:</p> <pre><code>use File::Find::Rule::ImageSize; use File::Find::Rule::MMagic; # now your rules can use the clauses supplied by the ImageSize and # MMagic extension</code></pre> <p>or, specify that File::Find::Rule should load them for you:</p> <pre><code>use File::Find::Rule qw( :ImageSize :MMagic );</code></pre> <p>For notes on implementing your own extensions, consult <a href="/pod/distribution/File-Find-Rule/lib/File/Find/Rule/Extending.pod">File::Find::Rule::Extending</a></p> <h2 id="Further-examples"><a id="Further"></a>Further examples</h2> <dl> <dt id="Finding-perl-scripts"><a id="Finding"></a>Finding perl scripts</dt> <dd> <pre><code>my $finder = File::Find::Rule->or ( File::Find::Rule->name( '*.pl' ), File::Find::Rule->exec( sub { if (open my $fh, $_) { my $shebang = <$fh>; close $fh; return $shebang =~ /^#!.*\bperl/; } return 0; } ), );</code></pre> <p>Based upon this message http://use.perl.org/comments.pl?sid=7052&cid=10842</p> </dd> <dt id="ignore-CVS-directories"><a id="ignore"></a>ignore CVS directories</dt> <dd> <pre><code>my $rule = File::Find::Rule->new; $rule->or($rule->new ->directory ->name('CVS') ->prune ->discard, $rule->new);</code></pre> <p>Note here the use of a null rule. Null rules match anything they see, so the effect is to match (and discard) directories called 'CVS' or to match anything.</p> </dd> </dl> <h1 id="TWO-FOR-THE-PRICE-OF-ONE"><a id="TWO"></a>TWO FOR THE PRICE OF ONE</h1> <p>File::Find::Rule also gives you a procedural interface. This is documented in <a href="/pod/distribution/File-Find-Rule/lib/File/Find/Rule/Procedural.pod">File::Find::Rule::Procedural</a></p> <h1 id="EXPORTS">EXPORTS</h1> <p><a href="#find">"find"</a>, <a href="#rule">"rule"</a></p> <h1 id="TAINT-MODE-INTERACTION"><a id="TAINT"></a>TAINT MODE INTERACTION</h1> <p>As of 0.32 File::Find::Rule doesn't capture the current working directory in a taint-unsafe manner. File::Find itself still does operations that the taint system will flag as insecure but you can use the <a href="#extras">"extras"</a> feature to ask <a href="/pod/File::Find">File::Find</a> to internally <code>untaint</code> file paths with a regex like so:</p> <pre><code>my $rule = File::Find::Rule->extras({ untaint => 1 });</code></pre> <p>Please consult <a href="/pod/File::Find">File::Find</a>'s documentation for <code>untaint</code>, <code>untaint_pattern</code>, and <code>untaint_skip</code> for more information.</p> <h1 id="BUGS">BUGS</h1> <p>The code makes use of the <code>our</code> keyword and as such requires perl version 5.6.0 or newer.</p> <p>Currently it isn't possible to remove a clause from a rule object. If this becomes a significant issue it will be addressed.</p> <h1 id="AUTHOR">AUTHOR</h1> <p>Richard Clamp <richardc@unixbeard.net> with input gained from this use.perl discussion: http://use.perl.org/~richardc/journal/6467</p> <p>Additional proofreading and input provided by Kake, Greg McCarroll, and Andy Lester andy@petdance.com.</p> <h1 id="COPYRIGHT">COPYRIGHT</h1> <p>Copyright (C) 2002, 2003, 2004, 2006, 2009, 2011 Richard Clamp. All Rights Reserved.</p> <p>This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself.</p> <h1 id="SEE-ALSO"><a id="SEE"></a>SEE ALSO</h1> <p><a href="/pod/File::Find">File::Find</a>, <a href="/pod/Text::Glob">Text::Glob</a>, <a href="/pod/Number::Compare">Number::Compare</a>, find(1)</p> <p>If you want to know about the procedural interface, see <a href="/pod/distribution/File-Find-Rule/lib/File/Find/Rule/Procedural.pod">File::Find::Rule::Procedural</a>, and if you have an idea for a neat extension <a href="/pod/distribution/File-Find-Rule/lib/File/Find/Rule/Extending.pod">File::Find::Rule::Extending</a></p></div> <div id="metacpan_install-instructions-dialog" class="modal fade"> <div class="modal-dialog"> <div class="modal-content"> <div class="modal-header"> <button type="button" class="close" data-dismiss="modal" aria-hidden="true">×</button> <h4 class="modal-title">Module Install Instructions</h4> </div> <div class="modal-body"> <p>To install File::Find::Rule, copy and paste the appropriate command in to your terminal.</p> <p><a href="/dist/App-cpanminus/view/bin/cpanm">cpanm</a></p> <pre><code>cpanm File::Find::Rule</code></pre> <p><a href="/pod/CPAN">CPAN shell</a></p> <pre><code>perl -MCPAN -e shell install File::Find::Rule</code></pre> <p>For more information on module installation, please visit <a href="https://www.cpan.org/modules/INSTALL.html">the detailed CPAN module installation guide</a>.</p> </div> <div class="modal-footer"> <a href="#" data-dismiss="modal" class="btn">Close</a> </div> </div> </div> </div> </main> <div class="content-pagination"> </div> </div> <footer class="footer"> <div class="footer-container"> <div class="footer-social"> <div class="footer-link footer-logo"> <a href="/"> <img src="/static/images/metacpan-logo.svg" alt="MetaCPAN" /> </a> </div> <a class="footer-social-link" href="https://github.com/metacpan"> <i class="fab fa-github-square"></i> </a> <a class="footer-social-link" href="https://fosstodon.org/@metacpan"> <i class="fab fa-mastodon"></i> </a> </div> <div class="footer-links"> <div class="footer-link"> <a href="/about">About</a> </div> <div class="footer-link"> <a href="/about/sponsors">Sponsor</a> </div> <div class="footer-link"> <a href="https://grep.metacpan.org">grep::cpan</a> </div> <div class="footer-link"> <a href="/recent">Recent</a> </div> <div class="footer-link"> <a href="/about/faq">FAQ</a> </div> <div class="footer-link"> <a href="/tools">Tools</a> </div> <div class="footer-link"> <a href="https://fastapi.metacpan.org/">API</a> </div> <div class="footer-link"> <a href="https://www.perl.org/">Perl.org</a> </div> </div> <div class="footer-sponsors"> <a class="footer-sponsor-link" target="_blank" href="https://www.bytemark.co.uk/" rel="noopener"> <img class="footer-sponsor-bytemark" src="/static/images/sponsors/bytemark_logo.svg" alt="Bytemark logo"> </a> <a class="footer-sponsor-link" target="_blank" href="https://www.liquidweb.com/" rel="noopener"> <img class="footer-sponsor-liquidweb" src="/static/images/sponsors/liquidweb_logo.png" alt="liquidweb logo"> </a> <a class="footer-sponsor-link" target="_blank" href="https://deriv.com/careers/" rel="noopener"> <img class="footer-sponsor-deriv" src="/static/images/sponsors/deriv.svg" alt="Deriv logo"> </a> <a class="footer-sponsor-link" target="_blank" href="https://geocode.xyz" rel="noopener"> <img class="footer-sponsor-geocode" src="/static/images/sponsors/geocodelogo.svg" alt="Geocode logo"> </a> <a class="footer-sponsor-link" target="_blank" href="https://www.fastly.com/" rel="noopener"> <img class="footer-sponsor-fastly" src="/static/images/sponsors/fastly_logo.svg" alt="Fastly logo"> </a> <a class="footer-sponsor-link" target="_blank" href="https://opencagedata.com" rel="noopener"> <img class="footer-sponsor-opencage" src="/static/images/sponsors/open-cage.svg" alt="OpenCage logo"> </a>  <a class="footer-sponsor-link" target="_blank" href="https://www.elastic.co/" rel="noopener"> <img class="footer-sponsor-elastic" src="/static/images/sponsors/elastic.svg" alt="Elastic logo"> </a>  <a class="footer-sponsor-link" target="_blank" href="https://route4me.com/" rel="noopener"> <img class="footer-sponsor-route4me" src="/static/images/sponsors/route4me.png" alt="Route4Me logo"> </a> </div> </div> </footer> <div class="modal fade" tabindex="-1" role="dialog" id="metacpan_keyboard-shortcuts"> <div class="modal-dialog"> <div class="modal-content"> <div class="modal-header"> <button type="button" class="close" data-dismiss="modal">×</button> <h4 class="modal-title">Keyboard Shortcuts</h4> </div> <div class="modal-body row"> <div class="col-md-6"> <table class="table keyboard-shortcuts"> <thead> <tr> <th></th> <th>Global</th> </tr> </thead> <tbody> <tr> <td class="keys"> <kbd>s</kbd> </td> <td>Focus search bar</td> </tr> <tr> <td class="keys"> <kbd>?</kbd> </td> <td>Bring up this help dialog</td> </tr> </tbody> </table> <table class="table keyboard-shortcuts"> <thead> <tr> <th></th> <th>GitHub</th> </tr> </thead> <tbody> <tr> <td class="keys"> <kbd>g</kbd> <kbd>p</kbd> </td> <td>Go to pull requests</td> </tr> <tr> <td class="keys"> <kbd>g</kbd> <kbd>i</kbd> </td> <td>go to github issues (only if github is preferred repository)</td> </tr> </tbody> </table> </div> <div class="col-md-6"> <table class="table keyboard-shortcuts"> <thead> <tr> <th></th> <th>POD</th> </tr> </thead> <tbody> <tr> <td class="keys"> <kbd>g</kbd> <kbd>a</kbd> </td> <td>Go to author</td> </tr> <tr> <td class="keys"> <kbd>g</kbd> <kbd>c</kbd> </td> <td>Go to changes</td> </tr> <tr> <td class="keys"> <kbd>g</kbd> <kbd>i</kbd> </td> <td>Go to issues</td> </tr> <tr> <td class="keys"> <kbd>g</kbd> <kbd>d</kbd> </td> <td>Go to dist</td> </tr> <tr> <td class="keys"> <kbd>g</kbd> <kbd>r</kbd> </td> <td>Go to repository/SCM</td> </tr> <tr> <td class="keys"> <kbd>g</kbd> <kbd>s</kbd> </td> <td>Go to source</td> </tr> <tr> <td class="keys"> <kbd>g</kbd> <kbd>b</kbd> </td> <td>Go to file browse</td> </tr> </tbody> </table> </div> <div class="col-md-12"> <table class="table keyboard-shortcuts"> <thead> <tr> <th></th> <th>Search terms</th> </tr> </thead> <tbody> <tr> <td><em>module:</em> (e.g. <a href="/search?q=module%3APlugin">module:Plugin</a>)</td> </tr> <tr> <td><em>distribution:</em> (e.g. <a href="/search?q=distribution%3ADancer+auth">distribution:Dancer auth</a>)</td> </tr> <tr> <td><em>author:</em> (e.g. <a href="/search?q=author%3ASONGMU+Redis">author:SONGMU Redis</a>)</td> </tr> <tr> <td><em>version:</em> (e.g. <a href="/search?q=version%3A1.00">version:1.00</a>)</td> </tr> </tbody> </table> </div> </div> <div class="modal-footer"></div> </div> </div> </div> </body> </html>

CINXE.COM

File::Find::Rule - Alternative interface to File::Find - metacpan.org