TITLE

Provides a Raku wrapper for the system 'file' command


SUBTITLE

data

=begin data
{"type":"page","file":"work_mods/zef/File::file/File-file-0.0.1/README.md","sources":[],"node":{"type":"block","id":"L75coHinVv_szinQtjgSG","margin":"","name":"root","content":[{"type":"para","id":"fThBj6R4rY-L9iWKeX91a","margin":"","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":434,"offset":433}},"text":"text","content":[{"meta":"https://github.com/tbrowder/File-file/actions","type":"fcode","name":"L","content":[{"type":"block","id":"sSVZAyojE3BdVdhe9Rbxj","margin":"","name":"Image","config":[],"location":{"start":{"line":1,"column":2,"offset":1},"end":{"line":1,"column":96,"offset":95}},"content":[{"type":"image","src":"https://github.com/tbrowder/File-file/actions/workflows/linux.yml/badge.svg","alt":"Actions Status"}]}]}," ",{"meta":"https://github.com/tbrowder/File-file/actions","type":"fcode","name":"L","content":[{"type":"block","id":"9Ef_-a7hxz0-j41qeVLkf","margin":"","name":"Image","config":[],"location":{"start":{"line":1,"column":146,"offset":145},"end":{"line":1,"column":240,"offset":239}},"content":[{"type":"image","src":"https://github.com/tbrowder/File-file/actions/workflows/macos.yml/badge.svg","alt":"Actions Status"}]}]}," ",{"meta":"https://github.com/tbrowder/File-file/actions","type":"fcode","name":"L","content":[{"type":"block","id":"XRrIV8wfbf4iF6f63Pr5n","margin":"","name":"Image","config":[],"location":{"start":{"line":1,"column":290,"offset":289},"end":{"line":1,"column":386,"offset":385}},"content":[{"type":"image","src":"https://github.com/tbrowder/File-file/actions/workflows/windows.yml/badge.svg","alt":"Actions Status"}]}]}]},{"type":"block","id":"Mn2o5Ubq7aGhKQxDN4V37","margin":"","level":1,"name":"head","location":{"start":{"line":3,"column":1,"offset":435},"end":{"line":3,"column":7,"offset":441}},"content":["NAME"]},{"type":"para","id":"NhxIlm7TO2ybxrczlk7fi","margin":"","location":{"start":{"line":5,"column":1,"offset":443},"end":{"line":5,"column":71,"offset":513}},"text":"text","content":[{"type":"fcode","name":"B","content":["File::file"]}," - Provides a Raku wrapper for the system 'file' command"]},{"type":"block","id":"KZnUHTFGSyNTOy8zAsGoX","margin":"","level":1,"name":"head","location":{"start":{"line":7,"column":1,"offset":515},"end":{"line":7,"column":11,"offset":525}},"content":["SYNOPSIS"]},{"type":"block","id":"T_WdtvSnCugA3nizyq7ys","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":9,"column":1,"offset":527},"end":{"line":13,"column":4,"offset":624}},"content":[{"type":"verbatim","value":"use File::file;\nmy $o = File::file.new;\nsay $o.file: \"..\"; # OUTPUT: «..: directory␤»"}]},{"type":"block","id":"bp39cIfFBHvqburAmLmop","margin":"","level":1,"name":"head","location":{"start":{"line":15,"column":1,"offset":626},"end":{"line":15,"column":14,"offset":639}},"content":["DESCRIPTION"]},{"type":"para","id":"hx6UxZ8S4gndu7boFSvQl","margin":"","location":{"start":{"line":17,"column":1,"offset":641},"end":{"line":17,"column":74,"offset":714}},"text":"text","content":[{"type":"fcode","name":"B","content":["File::file"]}," is a convenience wrapper around the system 'file' command."]},{"type":"block","id":"Vf56tWNew7WhwUDvI5RMX","margin":"","level":1,"name":"head","location":{"start":{"line":19,"column":1,"offset":716},"end":{"line":19,"column":9,"offset":724}},"content":["AUTHOR"]},{"type":"para","id":"tx9MoSOM2Ywf-RcOfiXnN","margin":"","location":{"start":{"line":21,"column":1,"offset":726},"end":{"line":21,"column":31,"offset":756}},"text":"text","content":["Tom Browder ",{"meta":"mailto:tbrowder@acm.org","type":"fcode","name":"L","content":["tbrowder@acm.org"]}]},{"type":"block","id":"BbacprdIje-yWHr-JTvMy","margin":"","level":1,"name":"head","location":{"start":{"line":23,"column":1,"offset":758},"end":{"line":23,"column":24,"offset":781}},"content":["COPYRIGHT AND LICENSE"]},{"type":"para","id":"yHTf0LZbr_E0QQHErUMFv","margin":"","location":{"start":{"line":25,"column":1,"offset":783},"end":{"line":25,"column":19,"offset":801}},"text":"text","content":["© 2023 Tom Browder"]},{"type":"para","id":"dPoZHvmcZvIKH3FhQeJ6u","margin":"","location":{"start":{"line":27,"column":1,"offset":803},"end":{"line":27,"column":100,"offset":902}},"text":"text","content":["This library is free software; you may redistribute it or modify it under the Artistic License 2.0."]}]},"publishUrl":"/mods/zef/File::file/File-file-0.0.1/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"","auth":"zef:tbrowder","authors":["Tom Browder"],"build-depends":[],"depends":["Proc::Easier"],"description":"Provides a Raku wrapper for the system 'file' command","dist":"File::file:ver<0.0.1>:auth<zef:tbrowder>","license":"Artistic-2.0","name":"File::file","path":"F/IL/FILE_FILE/c0b0c68c1b46e9220478f8f8e47609d1a068d207.tar.gz","perl":"6.d","provides":{"File::file":"lib/File/file.rakumod"},"resources":[],"source-url":"https://github.com/tbrowder/File-file.git","tags":["file system mime magic"],"test-depends":[],"version":"0.0.1"},"files":[{"file":"work_mods/zef/File::file/File-file-0.0.1/README.md","publishUrl":"/mods/zef/File::file/File-file-0.0.1/README.md"},{"file":"work_mods/zef/File::file/File-file-0.0.1/docs/README.rakudoc","publishUrl":"/mods/zef/File::file/File-file-0.0.1/docs/README.rakudoc"}],"src":"zef","url":"/mods/zef/File::file"}}}
=end data


React

    =begin React :component<RenderItem>
    =begin data
    {"type":"page","file":"work_mods/zef/File::file/File-file-0.0.1/README.md","sources":[],"node":{"type":"block","id":"L75coHinVv_szinQtjgSG","margin":"","name":"root","content":[{"type":"para","id":"fThBj6R4rY-L9iWKeX91a","margin":"","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":434,"offset":433}},"text":"text","content":[{"meta":"https://github.com/tbrowder/File-file/actions","type":"fcode","name":"L","content":[{"type":"block","id":"sSVZAyojE3BdVdhe9Rbxj","margin":"","name":"Image","config":[],"location":{"start":{"line":1,"column":2,"offset":1},"end":{"line":1,"column":96,"offset":95}},"content":[{"type":"image","src":"https://github.com/tbrowder/File-file/actions/workflows/linux.yml/badge.svg","alt":"Actions Status"}]}]}," ",{"meta":"https://github.com/tbrowder/File-file/actions","type":"fcode","name":"L","content":[{"type":"block","id":"9Ef_-a7hxz0-j41qeVLkf","margin":"","name":"Image","config":[],"location":{"start":{"line":1,"column":146,"offset":145},"end":{"line":1,"column":240,"offset":239}},"content":[{"type":"image","src":"https://github.com/tbrowder/File-file/actions/workflows/macos.yml/badge.svg","alt":"Actions Status"}]}]}," ",{"meta":"https://github.com/tbrowder/File-file/actions","type":"fcode","name":"L","content":[{"type":"block","id":"XRrIV8wfbf4iF6f63Pr5n","margin":"","name":"Image","config":[],"location":{"start":{"line":1,"column":290,"offset":289},"end":{"line":1,"column":386,"offset":385}},"content":[{"type":"image","src":"https://github.com/tbrowder/File-file/actions/workflows/windows.yml/badge.svg","alt":"Actions Status"}]}]}]},{"type":"block","id":"Mn2o5Ubq7aGhKQxDN4V37","margin":"","level":1,"name":"head","location":{"start":{"line":3,"column":1,"offset":435},"end":{"line":3,"column":7,"offset":441}},"content":["NAME"]},{"type":"para","id":"NhxIlm7TO2ybxrczlk7fi","margin":"","location":{"start":{"line":5,"column":1,"offset":443},"end":{"line":5,"column":71,"offset":513}},"text":"text","content":[{"type":"fcode","name":"B","content":["File::file"]}," - Provides a Raku wrapper for the system 'file' command"]},{"type":"block","id":"KZnUHTFGSyNTOy8zAsGoX","margin":"","level":1,"name":"head","location":{"start":{"line":7,"column":1,"offset":515},"end":{"line":7,"column":11,"offset":525}},"content":["SYNOPSIS"]},{"type":"block","id":"T_WdtvSnCugA3nizyq7ys","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":9,"column":1,"offset":527},"end":{"line":13,"column":4,"offset":624}},"content":[{"type":"verbatim","value":"use File::file;\nmy $o = File::file.new;\nsay $o.file: \"..\"; # OUTPUT: «..: directory␤»"}]},{"type":"block","id":"bp39cIfFBHvqburAmLmop","margin":"","level":1,"name":"head","location":{"start":{"line":15,"column":1,"offset":626},"end":{"line":15,"column":14,"offset":639}},"content":["DESCRIPTION"]},{"type":"para","id":"hx6UxZ8S4gndu7boFSvQl","margin":"","location":{"start":{"line":17,"column":1,"offset":641},"end":{"line":17,"column":74,"offset":714}},"text":"text","content":[{"type":"fcode","name":"B","content":["File::file"]}," is a convenience wrapper around the system 'file' command."]},{"type":"block","id":"Vf56tWNew7WhwUDvI5RMX","margin":"","level":1,"name":"head","location":{"start":{"line":19,"column":1,"offset":716},"end":{"line":19,"column":9,"offset":724}},"content":["AUTHOR"]},{"type":"para","id":"tx9MoSOM2Ywf-RcOfiXnN","margin":"","location":{"start":{"line":21,"column":1,"offset":726},"end":{"line":21,"column":31,"offset":756}},"text":"text","content":["Tom Browder ",{"meta":"mailto:tbrowder@acm.org","type":"fcode","name":"L","content":["tbrowder@acm.org"]}]},{"type":"block","id":"BbacprdIje-yWHr-JTvMy","margin":"","level":1,"name":"head","location":{"start":{"line":23,"column":1,"offset":758},"end":{"line":23,"column":24,"offset":781}},"content":["COPYRIGHT AND LICENSE"]},{"type":"para","id":"yHTf0LZbr_E0QQHErUMFv","margin":"","location":{"start":{"line":25,"column":1,"offset":783},"end":{"line":25,"column":19,"offset":801}},"text":"text","content":["© 2023 Tom Browder"]},{"type":"para","id":"dPoZHvmcZvIKH3FhQeJ6u","margin":"","location":{"start":{"line":27,"column":1,"offset":803},"end":{"line":27,"column":100,"offset":902}},"text":"text","content":["This library is free software; you may redistribute it or modify it under the Artistic License 2.0."]}]},"publishUrl":"/mods/zef/File::file/File-file-0.0.1/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"","auth":"zef:tbrowder","authors":["Tom Browder"],"build-depends":[],"depends":["Proc::Easier"],"description":"Provides a Raku wrapper for the system 'file' command","dist":"File::file:ver<0.0.1>:auth<zef:tbrowder>","license":"Artistic-2.0","name":"File::file","path":"F/IL/FILE_FILE/c0b0c68c1b46e9220478f8f8e47609d1a068d207.tar.gz","perl":"6.d","provides":{"File::file":"lib/File/file.rakumod"},"resources":[],"source-url":"https://github.com/tbrowder/File-file.git","tags":["file system mime magic"],"test-depends":[],"version":"0.0.1"},"files":[{"file":"work_mods/zef/File::file/File-file-0.0.1/README.md","publishUrl":"/mods/zef/File::file/File-file-0.0.1/README.md"},{"file":"work_mods/zef/File::file/File-file-0.0.1/docs/README.rakudoc","publishUrl":"/mods/zef/File::file/File-file-0.0.1/docs/README.rakudoc"}],"src":"zef","url":"/mods/zef/File::file"}}}
    =end data
    =end React


root

para

L<Examples| file:../examples/index.podlite>


L<Download |file:../download/index.podlite>


=begin React :component<HeaderCol> :id<menu> 
=para L<Documentation|/doc/introduction>
=para L<Modules| /mods>
=para L<Examples| file:../examples/index.podlite>
=para L<Download |file:../download/index.podlite>
=para L<About|file:../about/index.podlite>
=para 🔍 K<⌘K>/K<ctrl-K>
=end React


HEADER

FOOTER

File::file


=begin data
{"type":"page","file":"work_mods/zef/File::Find/File-Find-0.1.2/README.md","sources":[],"node":{"type":"block","id":"woZkZD6SA8xyM_A1ZkgXz","margin":"","name":"root","content":[{"type":"para","id":"u_qFOBhNrhl3cxakk91mO","margin":"","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":171,"offset":170}},"text":"text","content":[{"meta":"https://github.com/raku-community-modules/File-Find/actions","type":"fcode","name":"L","content":[{"type":"block","id":"Po4wu_4PMEHHCrxdswMCw","margin":"","name":"Image","config":[],"location":{"start":{"line":1,"column":2,"offset":1},"end":{"line":1,"column":109,"offset":108}},"content":[{"type":"image","src":"https://github.com/raku-community-modules/File-Find/actions/workflows/test.yml/badge.svg","alt":"Actions Status"}]}]}]},{"type":"block","id":"k-L0kTYKsthDYBwvSU8CY","margin":"","level":1,"name":"head","location":{"start":{"line":3,"column":1,"offset":172},"end":{"line":3,"column":7,"offset":178}},"content":["NAME"]},{"type":"para","id":"FCCZ45EayBg9tOi0rXruS","margin":"","location":{"start":{"line":5,"column":1,"offset":180},"end":{"line":5,"column":49,"offset":228}},"text":"text","content":["File::Find - Get a lazy list of a directory tree"]},{"type":"block","id":"XojE0hF35lEwmCovTWOCO","margin":"","level":1,"name":"head","location":{"start":{"line":7,"column":1,"offset":230},"end":{"line":7,"column":11,"offset":240}},"content":["SYNOPSIS"]},{"type":"block","id":"bjrNoN1054PMyhvo28Dig","margin":"","name":"code","config":[],"location":{"start":{"line":9,"column":1,"offset":242},"end":{"line":15,"column":21,"offset":376}},"content":[{"type":"verbatim","value":"use File::Find;\n\nmy @list := find(dir => 'foo');\nsay @list[0..3];\n\nmy $list = find(dir => 'foo');\nsay $list[0..3];"}]},{"type":"block","id":"jlG0GGr-PHaPJ7Hempisw","margin":"","level":1,"name":"head","location":{"start":{"line":17,"column":1,"offset":378},"end":{"line":17,"column":14,"offset":391}},"content":["DESCRIPTION"]},{"type":"para","id":"RvpH0gNPdi1Q_Huzu_xSU","margin":"","location":{"start":{"line":19,"column":1,"offset":393},"end":{"line":19,"column":494,"offset":886}},"text":"text","content":[{"type":"fcode","name":"C","content":["File::Find"]}," allows you to get the contents of the given directory, recursively, depth first. The only exported function, ",{"type":"fcode","name":"C","content":["find()"]},", generates a lazy list of files in given directory. Every element of the list is an ",{"type":"fcode","name":"C","content":["IO::Path"]}," object, described below. ",{"type":"fcode","name":"C","content":["find()"]}," takes one (or more) named arguments. The ",{"type":"fcode","name":"C","content":["dir"]}," argument is mandatory, and sets the directory ",{"type":"fcode","name":"C","content":["find()"]}," will traverse. There are also few optional arguments. If more than one is passed, all of them must match for a file to be returned."]},{"type":"block","id":"Yj4ZMM9pD_CJrK4kpQq7Z","margin":"","level":2,"name":"head","location":{"start":{"line":21,"column":1,"offset":888},"end":{"line":21,"column":8,"offset":895}},"content":["name"]},{"type":"para","id":"-twrJOqKEIOd2TE8jEvir","margin":"","location":{"start":{"line":23,"column":1,"offset":897},"end":{"line":23,"column":377,"offset":1273}},"text":"text","content":["Specify a name of the file ",{"type":"fcode","name":"C","content":["File::Find"]}," is ought to look for. If you pass a string here, ",{"type":"fcode","name":"C","content":["find()"]}," will return only the files with the given name. When passing a regex, only the files with path matching the pattern will be returned. Any other type of argument passed here will just be smartmatched against the path (which is exactly what happens to regexes passed, by the way)."]},{"type":"block","id":"a1dpK17VAfbJeqboQAFTb","margin":"","level":2,"name":"head","location":{"start":{"line":25,"column":1,"offset":1275},"end":{"line":25,"column":8,"offset":1282}},"content":["type"]},{"type":"para","id":"qwLFPFPT16BpxTLoJUTFU","margin":"","location":{"start":{"line":27,"column":1,"offset":1284},"end":{"line":27,"column":120,"offset":1403}},"text":"text","content":["Given a type, ",{"type":"fcode","name":"C","content":["find()"]}," will only return files being the given type. The available types are ",{"type":"fcode","name":"C","content":["file"]},", ",{"type":"fcode","name":"C","content":["dir"]}," or ",{"type":"fcode","name":"C","content":["symlink"]},"."]},{"type":"block","id":"5Vq5_sHTHF-i4FAQy6yAX","margin":"","level":2,"name":"head","location":{"start":{"line":29,"column":1,"offset":1405},"end":{"line":29,"column":11,"offset":1415}},"content":["exclude"]},{"type":"para","id":"axZdf8ZOWqpehLB7QyKnB","margin":"","location":{"start":{"line":31,"column":1,"offset":1417},"end":{"line":31,"column":191,"offset":1607}},"text":"text","content":["Exclude is meant to be used for skipping certain big and uninteresting directories, like '.git'. Neither them nor any of their contents will be returned, saving a significant amount of time."]},{"type":"para","id":"PEE4YlFsV73K31LhAGFjB","margin":"","location":{"start":{"line":33,"column":1,"offset":1609},"end":{"line":33,"column":240,"offset":1848}},"text":"text","content":["The value of ",{"type":"fcode","name":"C","content":["exclude"]}," will be smartmatched against each IO object found by File::Find. It's recommended that it's passed as an IO object (or a Junction of those) so we avoid silly things like slashes vs backslashes on different platforms."]},{"type":"block","id":"QBLx-mx4-aeRxf66wgc1h","margin":"","level":2,"name":"head","location":{"start":{"line":35,"column":1,"offset":1850},"end":{"line":35,"column":14,"offset":1863}},"content":["keep-going"]},{"type":"para","id":"kpziiHvNDAbD4vAiEAxpA","margin":"","location":{"start":{"line":37,"column":1,"offset":1865},"end":{"line":37,"column":147,"offset":2011}},"text":"text","content":["Parameter ",{"type":"fcode","name":"C","content":["keep-going"]}," tells ",{"type":"fcode","name":"C","content":["find()"]}," to not stop finding files on errors such as 'Access is denied', but rather ignore the errors and keep going."]},{"type":"block","id":"rLbvm7J1uP_ZiCjUGzl3A","margin":"","level":2,"name":"head","location":{"start":{"line":39,"column":1,"offset":2013},"end":{"line":39,"column":13,"offset":2025}},"content":["recursive"]},{"type":"para","id":"bVDO-uVG8vK5-BhlAbMvf","margin":"","location":{"start":{"line":41,"column":1,"offset":2027},"end":{"line":41,"column":241,"offset":2267}},"text":"text","content":["By default, ",{"type":"fcode","name":"C","content":["find"]}," will recursively traverse a directory tree, descending into any subdirectories it finds. This behaviour can be changed by setting ",{"type":"fcode","name":"C","content":["recursive"]}," to a false value. In this case, only the first level entries will be processed."]},{"type":"block","id":"bnjjlRNXeB-HFpPJsXJu3","margin":"","level":1,"name":"head","location":{"start":{"line":43,"column":1,"offset":2269},"end":{"line":43,"column":20,"offset":2288}},"content":["Perl's File::Find"]},{"type":"para","id":"XPortZ1cgMd8GMsbq0oId","margin":"","location":{"start":{"line":45,"column":1,"offset":2290},"end":{"line":45,"column":201,"offset":2490}},"text":"text","content":["Please note, that this module is not trying to be the verbatim port of Perl's File::Find module. Its interface is closer to Perl's File::Find::Rule, and its features are planned to be similar one day."]},{"type":"block","id":"coYkdcncgOoRAhgvuvA40","margin":"","level":1,"name":"head","location":{"start":{"line":47,"column":1,"offset":2492},"end":{"line":47,"column":10,"offset":2501}},"content":["CAVEATS"]},{"type":"para","id":"uUYB-oJHqBS1FevXAdB8f","margin":"","location":{"start":{"line":49,"column":1,"offset":2503},"end":{"line":49,"column":245,"offset":2747}},"text":"text","content":["List assignment is eager in Raku, so if You assign ",{"type":"fcode","name":"C","content":["find()"]}," result to an array, the elements will be copied and the laziness will be spoiled. For a proper lazy list, use either binding (",{"type":"fcode","name":"C","content":[":="]},") or assign a result to a scalar value (see SYNOPSIS)."]}]},"publishUrl":"/mods/zef/File::Find/File-Find-0.1.2/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"","auth":"zef:raku-community-modules","authors":["Tadeusz “tadzik” Sośnierz","Dagur Valberg Johansson","Elizabeth Mattijsen","Filip Sergot","GlitchMr","Heather","isleofmax","Moritz Lenz","Paul Cochrane","Steve Mynott","timo","Tobias Leich"],"build-depends":[],"depends":[],"description":"Get a lazy list of a directory tree","dist":"File::Find:ver<0.1.2>:auth<zef:raku-community-modules>","license":"MIT","name":"File::Find","path":"F/IL/FILE_FIND/0291d285ceecac7bcc790a255d14ce657699b586.tar.gz","perl":"6.*","provides":{"File::Find":"lib/File/Find.rakumod"},"resources":[],"source-url":"git://github.com/raku-community-modules/File-Find.git","tags":[],"test-depends":[],"version":"0.1.2"},"files":[{"file":"work_mods/zef/File::Find/File-Find-0.1.2/README.md","publishUrl":"/mods/zef/File::Find/File-Find-0.1.2/README.md"},{"file":"work_mods/zef/File::Find/File-Find-0.1.2/lib/File/Find.rakumod","publishUrl":"/mods/zef/File::Find/File-Find-0.1.2/lib/File/Find.rakumod"}],"src":"zef","url":"/mods/zef/File::Find"}}}
=end data


    =begin React :component<RenderItem>
    =begin data
    {"type":"page","file":"work_mods/zef/File::Find/File-Find-0.1.2/README.md","sources":[],"node":{"type":"block","id":"woZkZD6SA8xyM_A1ZkgXz","margin":"","name":"root","content":[{"type":"para","id":"u_qFOBhNrhl3cxakk91mO","margin":"","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":171,"offset":170}},"text":"text","content":[{"meta":"https://github.com/raku-community-modules/File-Find/actions","type":"fcode","name":"L","content":[{"type":"block","id":"Po4wu_4PMEHHCrxdswMCw","margin":"","name":"Image","config":[],"location":{"start":{"line":1,"column":2,"offset":1},"end":{"line":1,"column":109,"offset":108}},"content":[{"type":"image","src":"https://github.com/raku-community-modules/File-Find/actions/workflows/test.yml/badge.svg","alt":"Actions Status"}]}]}]},{"type":"block","id":"k-L0kTYKsthDYBwvSU8CY","margin":"","level":1,"name":"head","location":{"start":{"line":3,"column":1,"offset":172},"end":{"line":3,"column":7,"offset":178}},"content":["NAME"]},{"type":"para","id":"FCCZ45EayBg9tOi0rXruS","margin":"","location":{"start":{"line":5,"column":1,"offset":180},"end":{"line":5,"column":49,"offset":228}},"text":"text","content":["File::Find - Get a lazy list of a directory tree"]},{"type":"block","id":"XojE0hF35lEwmCovTWOCO","margin":"","level":1,"name":"head","location":{"start":{"line":7,"column":1,"offset":230},"end":{"line":7,"column":11,"offset":240}},"content":["SYNOPSIS"]},{"type":"block","id":"bjrNoN1054PMyhvo28Dig","margin":"","name":"code","config":[],"location":{"start":{"line":9,"column":1,"offset":242},"end":{"line":15,"column":21,"offset":376}},"content":[{"type":"verbatim","value":"use File::Find;\n\nmy @list := find(dir => 'foo');\nsay @list[0..3];\n\nmy $list = find(dir => 'foo');\nsay $list[0..3];"}]},{"type":"block","id":"jlG0GGr-PHaPJ7Hempisw","margin":"","level":1,"name":"head","location":{"start":{"line":17,"column":1,"offset":378},"end":{"line":17,"column":14,"offset":391}},"content":["DESCRIPTION"]},{"type":"para","id":"RvpH0gNPdi1Q_Huzu_xSU","margin":"","location":{"start":{"line":19,"column":1,"offset":393},"end":{"line":19,"column":494,"offset":886}},"text":"text","content":[{"type":"fcode","name":"C","content":["File::Find"]}," allows you to get the contents of the given directory, recursively, depth first. The only exported function, ",{"type":"fcode","name":"C","content":["find()"]},", generates a lazy list of files in given directory. Every element of the list is an ",{"type":"fcode","name":"C","content":["IO::Path"]}," object, described below. ",{"type":"fcode","name":"C","content":["find()"]}," takes one (or more) named arguments. The ",{"type":"fcode","name":"C","content":["dir"]}," argument is mandatory, and sets the directory ",{"type":"fcode","name":"C","content":["find()"]}," will traverse. There are also few optional arguments. If more than one is passed, all of them must match for a file to be returned."]},{"type":"block","id":"Yj4ZMM9pD_CJrK4kpQq7Z","margin":"","level":2,"name":"head","location":{"start":{"line":21,"column":1,"offset":888},"end":{"line":21,"column":8,"offset":895}},"content":["name"]},{"type":"para","id":"-twrJOqKEIOd2TE8jEvir","margin":"","location":{"start":{"line":23,"column":1,"offset":897},"end":{"line":23,"column":377,"offset":1273}},"text":"text","content":["Specify a name of the file ",{"type":"fcode","name":"C","content":["File::Find"]}," is ought to look for. If you pass a string here, ",{"type":"fcode","name":"C","content":["find()"]}," will return only the files with the given name. When passing a regex, only the files with path matching the pattern will be returned. Any other type of argument passed here will just be smartmatched against the path (which is exactly what happens to regexes passed, by the way)."]},{"type":"block","id":"a1dpK17VAfbJeqboQAFTb","margin":"","level":2,"name":"head","location":{"start":{"line":25,"column":1,"offset":1275},"end":{"line":25,"column":8,"offset":1282}},"content":["type"]},{"type":"para","id":"qwLFPFPT16BpxTLoJUTFU","margin":"","location":{"start":{"line":27,"column":1,"offset":1284},"end":{"line":27,"column":120,"offset":1403}},"text":"text","content":["Given a type, ",{"type":"fcode","name":"C","content":["find()"]}," will only return files being the given type. The available types are ",{"type":"fcode","name":"C","content":["file"]},", ",{"type":"fcode","name":"C","content":["dir"]}," or ",{"type":"fcode","name":"C","content":["symlink"]},"."]},{"type":"block","id":"5Vq5_sHTHF-i4FAQy6yAX","margin":"","level":2,"name":"head","location":{"start":{"line":29,"column":1,"offset":1405},"end":{"line":29,"column":11,"offset":1415}},"content":["exclude"]},{"type":"para","id":"axZdf8ZOWqpehLB7QyKnB","margin":"","location":{"start":{"line":31,"column":1,"offset":1417},"end":{"line":31,"column":191,"offset":1607}},"text":"text","content":["Exclude is meant to be used for skipping certain big and uninteresting directories, like '.git'. Neither them nor any of their contents will be returned, saving a significant amount of time."]},{"type":"para","id":"PEE4YlFsV73K31LhAGFjB","margin":"","location":{"start":{"line":33,"column":1,"offset":1609},"end":{"line":33,"column":240,"offset":1848}},"text":"text","content":["The value of ",{"type":"fcode","name":"C","content":["exclude"]}," will be smartmatched against each IO object found by File::Find. It's recommended that it's passed as an IO object (or a Junction of those) so we avoid silly things like slashes vs backslashes on different platforms."]},{"type":"block","id":"QBLx-mx4-aeRxf66wgc1h","margin":"","level":2,"name":"head","location":{"start":{"line":35,"column":1,"offset":1850},"end":{"line":35,"column":14,"offset":1863}},"content":["keep-going"]},{"type":"para","id":"kpziiHvNDAbD4vAiEAxpA","margin":"","location":{"start":{"line":37,"column":1,"offset":1865},"end":{"line":37,"column":147,"offset":2011}},"text":"text","content":["Parameter ",{"type":"fcode","name":"C","content":["keep-going"]}," tells ",{"type":"fcode","name":"C","content":["find()"]}," to not stop finding files on errors such as 'Access is denied', but rather ignore the errors and keep going."]},{"type":"block","id":"rLbvm7J1uP_ZiCjUGzl3A","margin":"","level":2,"name":"head","location":{"start":{"line":39,"column":1,"offset":2013},"end":{"line":39,"column":13,"offset":2025}},"content":["recursive"]},{"type":"para","id":"bVDO-uVG8vK5-BhlAbMvf","margin":"","location":{"start":{"line":41,"column":1,"offset":2027},"end":{"line":41,"column":241,"offset":2267}},"text":"text","content":["By default, ",{"type":"fcode","name":"C","content":["find"]}," will recursively traverse a directory tree, descending into any subdirectories it finds. This behaviour can be changed by setting ",{"type":"fcode","name":"C","content":["recursive"]}," to a false value. In this case, only the first level entries will be processed."]},{"type":"block","id":"bnjjlRNXeB-HFpPJsXJu3","margin":"","level":1,"name":"head","location":{"start":{"line":43,"column":1,"offset":2269},"end":{"line":43,"column":20,"offset":2288}},"content":["Perl's File::Find"]},{"type":"para","id":"XPortZ1cgMd8GMsbq0oId","margin":"","location":{"start":{"line":45,"column":1,"offset":2290},"end":{"line":45,"column":201,"offset":2490}},"text":"text","content":["Please note, that this module is not trying to be the verbatim port of Perl's File::Find module. Its interface is closer to Perl's File::Find::Rule, and its features are planned to be similar one day."]},{"type":"block","id":"coYkdcncgOoRAhgvuvA40","margin":"","level":1,"name":"head","location":{"start":{"line":47,"column":1,"offset":2492},"end":{"line":47,"column":10,"offset":2501}},"content":["CAVEATS"]},{"type":"para","id":"uUYB-oJHqBS1FevXAdB8f","margin":"","location":{"start":{"line":49,"column":1,"offset":2503},"end":{"line":49,"column":245,"offset":2747}},"text":"text","content":["List assignment is eager in Raku, so if You assign ",{"type":"fcode","name":"C","content":["find()"]}," result to an array, the elements will be copied and the laziness will be spoiled. For a proper lazy list, use either binding (",{"type":"fcode","name":"C","content":[":="]},") or assign a result to a scalar value (see SYNOPSIS)."]}]},"publishUrl":"/mods/zef/File::Find/File-Find-0.1.2/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"","auth":"zef:raku-community-modules","authors":["Tadeusz “tadzik” Sośnierz","Dagur Valberg Johansson","Elizabeth Mattijsen","Filip Sergot","GlitchMr","Heather","isleofmax","Moritz Lenz","Paul Cochrane","Steve Mynott","timo","Tobias Leich"],"build-depends":[],"depends":[],"description":"Get a lazy list of a directory tree","dist":"File::Find:ver<0.1.2>:auth<zef:raku-community-modules>","license":"MIT","name":"File::Find","path":"F/IL/FILE_FIND/0291d285ceecac7bcc790a255d14ce657699b586.tar.gz","perl":"6.*","provides":{"File::Find":"lib/File/Find.rakumod"},"resources":[],"source-url":"git://github.com/raku-community-modules/File-Find.git","tags":[],"test-depends":[],"version":"0.1.2"},"files":[{"file":"work_mods/zef/File::Find/File-Find-0.1.2/README.md","publishUrl":"/mods/zef/File::Find/File-Find-0.1.2/README.md"},{"file":"work_mods/zef/File::Find/File-Find-0.1.2/lib/File/Find.rakumod","publishUrl":"/mods/zef/File::Find/File-Find-0.1.2/lib/File/Find.rakumod"}],"src":"zef","url":"/mods/zef/File::Find"}}}
    =end data
    =end React


Get a lazy list of a directory tree


File::Find


Access extended attributes of filesystem objects (xattr)


=begin data
{"type":"page","file":"work_mods/zef/File::ExtendedAttributes/dist/README.md","sources":[],"node":{"type":"block","id":"xrpMD8N5Y2KIEF59uRD3S","margin":"","name":"root","content":[{"type":"block","id":"y5LHCudrMp0mmeITj99y5","margin":"","level":1,"name":"head","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":7,"offset":6}},"content":["NAME"]},{"type":"para","id":"qgEMi99pR6PCFx6N6yh1S","margin":"","location":{"start":{"line":3,"column":1,"offset":8},"end":{"line":3,"column":42,"offset":49}},"text":"text","content":["File::ExtendedAttributes - blah blah blah"]},{"type":"block","id":"nzDjHgtTfZQ3yNVVTRWvR","margin":"","level":1,"name":"head","location":{"start":{"line":5,"column":1,"offset":51},"end":{"line":5,"column":11,"offset":61}},"content":["SYNOPSIS"]},{"type":"block","id":"xCNMEt5Ddy9j7GIEYRAZG","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":7,"column":1,"offset":63},"end":{"line":9,"column":4,"offset":104}},"content":[{"type":"verbatim","value":"use File::ExtendedAttributes;"}]},{"type":"block","id":"v4legkwx_jNKp1Xb5mSsB","margin":"","level":1,"name":"head","location":{"start":{"line":11,"column":1,"offset":106},"end":{"line":11,"column":14,"offset":119}},"content":["DESCRIPTION"]},{"type":"para","id":"WhfSO21IAsJVjacLf2tWi","margin":"","location":{"start":{"line":13,"column":1,"offset":121},"end":{"line":13,"column":32,"offset":152}},"text":"text","content":["File::ExtendedAttributes is ..."]},{"type":"block","id":"sp5qjl8jmuVrOJ4XDLkX2","margin":"","level":1,"name":"head","location":{"start":{"line":15,"column":1,"offset":154},"end":{"line":15,"column":9,"offset":162}},"content":["AUTHOR"]},{"type":"para","id":"kQx9YmCwoY_DaLEiBFxa6","margin":"","location":{"start":{"line":17,"column":1,"offset":164},"end":{"line":17,"column":35,"offset":198}},"text":"text","content":["Adrian Kreher ",{"meta":"mailto:avuserow@gmail.com","type":"fcode","name":"L","content":["avuserow@gmail.com"]}]},{"type":"block","id":"q0Lqt51O871PJG37Fl74U","margin":"","level":1,"name":"head","location":{"start":{"line":19,"column":1,"offset":200},"end":{"line":19,"column":24,"offset":223}},"content":["COPYRIGHT AND LICENSE"]},{"type":"para","id":"lnqTS-vi0EoVnfB-YhA4L","margin":"","location":{"start":{"line":21,"column":1,"offset":225},"end":{"line":21,"column":29,"offset":253}},"text":"text","content":["Copyright 2022 Adrian Kreher"]},{"type":"para","id":"UXOAwAaAwz-o1mY0E4X6_","margin":"","location":{"start":{"line":23,"column":1,"offset":255},"end":{"line":23,"column":104,"offset":358}},"text":"text","content":["This library is free software; you can redistribute it and/or modify it under the Artistic License 2.0."]}]},"publishUrl":"/mods/zef/File::ExtendedAttributes/dist/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"","auth":"zef:avuserow","authors":["Adrian Kreher"],"build-depends":[],"depends":["Unix::errno"],"description":"Access extended attributes of filesystem objects (xattr)","dist":"File::ExtendedAttributes:ver<0.0.1>:auth<zef:avuserow>","license":"Artistic-2.0","name":"File::ExtendedAttributes","path":"F/IL/FILE_EXTENDEDATTRIBUTES/fcc0c5c550df9510e97ff86fd11a376446863c1f.tar.gz","perl":"6.d","provides":{"File::ExtendedAttributes":"lib/File/ExtendedAttributes.rakumod"},"resources":[],"source-url":"","tags":["filesystem","metadata","unix"],"test-depends":[],"version":"0.0.1"},"files":[{"file":"work_mods/zef/File::ExtendedAttributes/dist/README.md","publishUrl":"/mods/zef/File::ExtendedAttributes/dist/README.md"},{"file":"work_mods/zef/File::ExtendedAttributes/dist/lib/File/ExtendedAttributes.rakumod","publishUrl":"/mods/zef/File::ExtendedAttributes/dist/lib/File/ExtendedAttributes.rakumod"}],"src":"zef","url":"/mods/zef/File::ExtendedAttributes"}}}
=end data


    =begin React :component<RenderItem>
    =begin data
    {"type":"page","file":"work_mods/zef/File::ExtendedAttributes/dist/README.md","sources":[],"node":{"type":"block","id":"xrpMD8N5Y2KIEF59uRD3S","margin":"","name":"root","content":[{"type":"block","id":"y5LHCudrMp0mmeITj99y5","margin":"","level":1,"name":"head","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":7,"offset":6}},"content":["NAME"]},{"type":"para","id":"qgEMi99pR6PCFx6N6yh1S","margin":"","location":{"start":{"line":3,"column":1,"offset":8},"end":{"line":3,"column":42,"offset":49}},"text":"text","content":["File::ExtendedAttributes - blah blah blah"]},{"type":"block","id":"nzDjHgtTfZQ3yNVVTRWvR","margin":"","level":1,"name":"head","location":{"start":{"line":5,"column":1,"offset":51},"end":{"line":5,"column":11,"offset":61}},"content":["SYNOPSIS"]},{"type":"block","id":"xCNMEt5Ddy9j7GIEYRAZG","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":7,"column":1,"offset":63},"end":{"line":9,"column":4,"offset":104}},"content":[{"type":"verbatim","value":"use File::ExtendedAttributes;"}]},{"type":"block","id":"v4legkwx_jNKp1Xb5mSsB","margin":"","level":1,"name":"head","location":{"start":{"line":11,"column":1,"offset":106},"end":{"line":11,"column":14,"offset":119}},"content":["DESCRIPTION"]},{"type":"para","id":"WhfSO21IAsJVjacLf2tWi","margin":"","location":{"start":{"line":13,"column":1,"offset":121},"end":{"line":13,"column":32,"offset":152}},"text":"text","content":["File::ExtendedAttributes is ..."]},{"type":"block","id":"sp5qjl8jmuVrOJ4XDLkX2","margin":"","level":1,"name":"head","location":{"start":{"line":15,"column":1,"offset":154},"end":{"line":15,"column":9,"offset":162}},"content":["AUTHOR"]},{"type":"para","id":"kQx9YmCwoY_DaLEiBFxa6","margin":"","location":{"start":{"line":17,"column":1,"offset":164},"end":{"line":17,"column":35,"offset":198}},"text":"text","content":["Adrian Kreher ",{"meta":"mailto:avuserow@gmail.com","type":"fcode","name":"L","content":["avuserow@gmail.com"]}]},{"type":"block","id":"q0Lqt51O871PJG37Fl74U","margin":"","level":1,"name":"head","location":{"start":{"line":19,"column":1,"offset":200},"end":{"line":19,"column":24,"offset":223}},"content":["COPYRIGHT AND LICENSE"]},{"type":"para","id":"lnqTS-vi0EoVnfB-YhA4L","margin":"","location":{"start":{"line":21,"column":1,"offset":225},"end":{"line":21,"column":29,"offset":253}},"text":"text","content":["Copyright 2022 Adrian Kreher"]},{"type":"para","id":"UXOAwAaAwz-o1mY0E4X6_","margin":"","location":{"start":{"line":23,"column":1,"offset":255},"end":{"line":23,"column":104,"offset":358}},"text":"text","content":["This library is free software; you can redistribute it and/or modify it under the Artistic License 2.0."]}]},"publishUrl":"/mods/zef/File::ExtendedAttributes/dist/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"","auth":"zef:avuserow","authors":["Adrian Kreher"],"build-depends":[],"depends":["Unix::errno"],"description":"Access extended attributes of filesystem objects (xattr)","dist":"File::ExtendedAttributes:ver<0.0.1>:auth<zef:avuserow>","license":"Artistic-2.0","name":"File::ExtendedAttributes","path":"F/IL/FILE_EXTENDEDATTRIBUTES/fcc0c5c550df9510e97ff86fd11a376446863c1f.tar.gz","perl":"6.d","provides":{"File::ExtendedAttributes":"lib/File/ExtendedAttributes.rakumod"},"resources":[],"source-url":"","tags":["filesystem","metadata","unix"],"test-depends":[],"version":"0.0.1"},"files":[{"file":"work_mods/zef/File::ExtendedAttributes/dist/README.md","publishUrl":"/mods/zef/File::ExtendedAttributes/dist/README.md"},{"file":"work_mods/zef/File::ExtendedAttributes/dist/lib/File/ExtendedAttributes.rakumod","publishUrl":"/mods/zef/File::ExtendedAttributes/dist/lib/File/ExtendedAttributes.rakumod"}],"src":"zef","url":"/mods/zef/File::ExtendedAttributes"}}}
    =end data
    =end React


File::ExtendedAttributes


The Raku Knowledge Base


=begin React :component<HeaderCol> :id<footer>  
=begin nested :!nested
=item1 B<Language>
    =item2 L<Get started|file:../getting-started/getting-started.podlite>
    =item2 L<Why Raku?|/doc/language/faq#Why-should-I-learn-Raku-What's-so-great-about-it>
    =item2 L<Try Raku|https://glot.io/new/raku>
    =item2 L<Raku cheat sheet|https://github.com/Raku/mu/blob/master/docs/Perl6/Cheatsheet/cheatsheet.txt>
    =item2 L<empty|#>
    =item2 L<empty|#>
    =item2 L<empty|#>
    =item2 L<Raku on Exercism|https://exercism.org/tracks/raku>
    =item2 L<Wikipedia|https://en.wikipedia.org/wiki/Raku_(programming_language)>
    =item2 L<empty|#>
    =item2 L<empty|#>
    =item2 L<empty|#>

=end nested
=begin nested :!nested

=item1 B<L<Documentation|/doc>>
    =item2 L<Getting started, Migration guides from other languages, & Tutorials | file:../doc/introduction.podlite>
    =item2 L<Language References|file:../doc/reference.podlite>
    =item2 L<Type Reference| file:../doc/types.podlite>
    =item2 L<Miscellaneous| file:../doc/miscellaneous.podlite>
    =item2 L<FAQs (Frequently Asked Questions)|/doc/language/faq>
    =item2 L<Community|/doc/language/community>
    =item2 L<The list of all documents|file:../doc/index.podlite>

=item1 B<Resources>
    =item2 L<The Raku Guide|https://raku.guide/>
    =item2 L<Books |https://perl6book.com/>
    =item2 L<Rosetta Code | https://www.raku.org/community/rosettacode>

=end nested
=begin nested :!nested

=item1 B<Resoures>
    =item2 L<Download | file:../download/index.podlite>
    =item2 L<empty|#>
    =item2 L<empty|#>
    =item2 L<empty|#>
    =item2 L<empty|#>
    =item2 L<empty|#>
    =item2 L<empty|#>
    =item2 L<empty|#>

=item1 B<Learning>
    =item2 L<The Raku Guide|https://raku.guide/>
    =item2 L<Wikibook |https://en.wikibooks.org/wiki/Raku_Programming>
    =item2 L<Books |https://perl6book.com/>
    =item2 L<Rosetta Code | https://www.raku.org/community/rosettacode>
    =item2 L<Learn Raku in Y minutes|https://learnxinyminutes.com/docs/raku/>
    =item2 L<Golfing |https://github.com/AlexDaniel/raku-golf-cheatsheet>
=end nested
=begin nested :!nested

=item1 B<Explore>
    =item2 L<Raku Blog Aggregator|https://planet.raku.org/>
    =item2 L<Rakudo Weekly|https://rakudoweekly.blog/>
    =item2 L<The Weekly Challenge |https://perlweeklychallenge.org/>
    =item2 L<Raku Advent Calendar|https://raku-advent.blog/>
    =item2 L<empty|#>
    =item2 L<empty|#>
    =item2 L<empty|#>
    =item2 L<empty|#>
    =item2 L<empty|#>

=end nested
=end React


=begin React :component<CookieConsent> :id<CookieConsent> :buttonCaption("Got it!")
=para
This website uses cookies for analytics.
=end React


File::file

NAME

SYNOPSIS

DESCRIPTION

AUTHOR

COPYRIGHT AND LICENSE

File::file v0.0.1

Authors

License

Dependencies

Test Dependencies

Provides

Documentation