TITLE

SUBTITLE

data

=begin data
{"type":"page","file":"work_mods/zef/IO::Maildir/README.md","sources":[],"node":{"type":"block","id":"kNXSgcz3cdtNeEfaqSoLX","margin":"","name":"root","content":[{"type":"block","id":"RcQDShx8cP6aY2n3E1cA4","margin":"","level":1,"name":"head","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":8,"offset":7}},"content":["About"]},{"type":"para","id":"XB5L1yGfVtumOcdEnfGCB","margin":"","location":{"start":{"line":3,"column":1,"offset":9},"end":{"line":4,"column":77,"offset":165}},"text":"text","content":[{"type":"fcode","name":"B","content":["IO::Maildir"]}," provides functions for safely dealing with maildir directories.\nIt can be configured to act like a mail user agent or a mail delivery agent."]},{"type":"block","id":"xwRjTZqR6taoXTLaTJ7n_","margin":"","level":1,"name":"head","location":{"start":{"line":6,"column":1,"offset":167},"end":{"line":6,"column":11,"offset":177}},"content":["Synopsis"]},{"type":"block","id":"KW9tVeKAJb7Q76gZC9Ggn","margin":"","name":"code","config":[],"location":{"start":{"line":8,"column":1,"offset":179},"end":{"line":11,"column":41,"offset":299}},"content":[{"type":"verbatim","value":"use IO::Maildir;\nmy $inbox = maildir \"~/mail/INBOX\";\n$inbox.create;\nmy $msg = $inbox.receive($somemail);"}]},{"type":"block","id":"j3Cc8utTQTmNMcTOr2gaL","margin":"","level":1,"name":"head","location":{"start":{"line":13,"column":1,"offset":301},"end":{"line":13,"column":10,"offset":310}},"content":["License"]},{"type":"para","id":"4--fFdR34xa7oP4lFQ_Ae","margin":"","location":{"start":{"line":15,"column":1,"offset":312},"end":{"line":15,"column":97,"offset":408}},"text":"text","content":["This library is free software; you may redistribute or modify it under the Artistic License 2.0."]}]},"publishUrl":"/mods/zef/IO::Maildir/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"0","auth":"zef:neula","build-depends":[],"depends":[],"description":"Simple module for accessing maildirs","dist":"IO::Maildir:ver<0.0.1>:auth<zef:neula>","license":"Artistic-2.0","meta-version":"0","name":"IO::Maildir","path":"I/O_/IO_MAILDIR/3812512b2cf40a38355e4411c95c299eef99f9b9.tar.gz","perl":"6.d","provides":{"IO::Maildir":"lib/IO/Maildir.rakumod"},"resources":[],"tags":["filesystem","email","IO"],"version":"0.0.1"},"files":[{"file":"work_mods/zef/IO::Maildir/README.md","publishUrl":"/mods/zef/IO::Maildir/README.md"}],"src":"zef","url":"/mods/zef/IO::Maildir"}}}
=end data


React

    =begin React :component<RenderItem>
    =begin data
    {"type":"page","file":"work_mods/zef/IO::Maildir/README.md","sources":[],"node":{"type":"block","id":"kNXSgcz3cdtNeEfaqSoLX","margin":"","name":"root","content":[{"type":"block","id":"RcQDShx8cP6aY2n3E1cA4","margin":"","level":1,"name":"head","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":8,"offset":7}},"content":["About"]},{"type":"para","id":"XB5L1yGfVtumOcdEnfGCB","margin":"","location":{"start":{"line":3,"column":1,"offset":9},"end":{"line":4,"column":77,"offset":165}},"text":"text","content":[{"type":"fcode","name":"B","content":["IO::Maildir"]}," provides functions for safely dealing with maildir directories.\nIt can be configured to act like a mail user agent or a mail delivery agent."]},{"type":"block","id":"xwRjTZqR6taoXTLaTJ7n_","margin":"","level":1,"name":"head","location":{"start":{"line":6,"column":1,"offset":167},"end":{"line":6,"column":11,"offset":177}},"content":["Synopsis"]},{"type":"block","id":"KW9tVeKAJb7Q76gZC9Ggn","margin":"","name":"code","config":[],"location":{"start":{"line":8,"column":1,"offset":179},"end":{"line":11,"column":41,"offset":299}},"content":[{"type":"verbatim","value":"use IO::Maildir;\nmy $inbox = maildir \"~/mail/INBOX\";\n$inbox.create;\nmy $msg = $inbox.receive($somemail);"}]},{"type":"block","id":"j3Cc8utTQTmNMcTOr2gaL","margin":"","level":1,"name":"head","location":{"start":{"line":13,"column":1,"offset":301},"end":{"line":13,"column":10,"offset":310}},"content":["License"]},{"type":"para","id":"4--fFdR34xa7oP4lFQ_Ae","margin":"","location":{"start":{"line":15,"column":1,"offset":312},"end":{"line":15,"column":97,"offset":408}},"text":"text","content":["This library is free software; you may redistribute or modify it under the Artistic License 2.0."]}]},"publishUrl":"/mods/zef/IO::Maildir/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"0","auth":"zef:neula","build-depends":[],"depends":[],"description":"Simple module for accessing maildirs","dist":"IO::Maildir:ver<0.0.1>:auth<zef:neula>","license":"Artistic-2.0","meta-version":"0","name":"IO::Maildir","path":"I/O_/IO_MAILDIR/3812512b2cf40a38355e4411c95c299eef99f9b9.tar.gz","perl":"6.d","provides":{"IO::Maildir":"lib/IO/Maildir.rakumod"},"resources":[],"tags":["filesystem","email","IO"],"version":"0.0.1"},"files":[{"file":"work_mods/zef/IO::Maildir/README.md","publishUrl":"/mods/zef/IO::Maildir/README.md"}],"src":"zef","url":"/mods/zef/IO::Maildir"}}}
    =end data
    =end React


root

Simple module for accessing maildirs


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

IO::Maildir


hijack, capture, or mute writes to an IO::Handle


IO::MiddleMan


=begin data
{"type":"page","file":"work_mods/zef/IO::Dir/dist/README.md","sources":[],"node":{"type":"block","id":"cv_SgNLc25-C1krttNk3s","margin":"","name":"root","content":[{"type":"para","id":"OPTFm37sKTe3trJghrP7K","margin":"","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":116,"offset":115}},"text":"text","content":[{"meta":"https://travis-ci.org/zoffixznet/perl6-IO-Dir","type":"fcode","name":"L","content":[{"type":"block","id":"VcJ_bAOZGkZr7saLUGX2F","margin":"","name":"Image","config":[],"location":{"start":{"line":1,"column":2,"offset":1},"end":{"line":1,"column":68,"offset":67}},"content":[{"type":"image","src":"https://travis-ci.org/zoffixznet/perl6-IO-Dir.svg","alt":"Build Status"}]}]}]},{"type":"block","id":"7SV1zduy0RikJTgdVmWzx","margin":"","level":1,"name":"head","location":{"start":{"line":3,"column":1,"offset":117},"end":{"line":3,"column":7,"offset":123}},"content":["NAME"]},{"type":"para","id":"ziaGEtVmhMC60g_-Scg9m","margin":"","location":{"start":{"line":5,"column":1,"offset":125},"end":{"line":5,"column":37,"offset":161}},"text":"text","content":["IO::Dir - IO::Path.dir you can close"]},{"type":"block","id":"m19OUf1wE_djUz4gyyJdN","margin":"","level":1,"name":"head","location":{"start":{"line":7,"column":1,"offset":163},"end":{"line":7,"column":11,"offset":173}},"content":["SYNOPSIS"]},{"type":"block","id":"ns9qBMSEC4ys3sTajldb4","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":9,"column":1,"offset":175},"end":{"line":16,"column":4,"offset":439}},"content":[{"type":"verbatim","value":"    # Won't always suit, since non-exhausted iterator holds on to an open\n    # file descriptor until GC:\n    'foo'.IO.dir[^3].say;\n\n    # all good; we explicitly close the file descriptor when done\n    .dir[^3].say and .close with IO::Dir.open: 'foo';"}]},{"type":"block","id":"4qKz65WuZXdSwutfoaAWA","margin":"","level":1,"name":"head","location":{"start":{"line":18,"column":1,"offset":441},"end":{"line":18,"column":14,"offset":454}},"content":["DESCRIPTION"]},{"type":"para","id":"ciyPjYDzgaWeCjRRnzQA3","margin":"","location":{"start":{"line":20,"column":1,"offset":456},"end":{"line":21,"column":62,"offset":591}},"text":"text","content":[{"meta":"https://docs.raku.org/routine/dir","type":"fcode","name":"L","content":[{"type":"fcode","name":"C","content":["IO::Path.dir"]}]}," does the job well for\nmost cases, however, there's an edge case where it's no good:"]},{"type":"list","id":"70BhyII7FxnEWnVlbP-UL","margin":"","level":1,"list":"itemized","content":[{"type":"block","id":"I5YRpSXin3JrJM8hX6YpV","margin":"","name":"item","level":1,"location":{"start":{"line":23,"column":1,"offset":593},"end":{"line":24,"column":35,"offset":697}},"content":[{"type":"para","id":"AgId7ye1XkdKA3r3x3ZVJ","margin":"","location":{"start":{"line":23,"column":3,"offset":595},"end":{"line":24,"column":35,"offset":697}},"text":"text","content":["You don't exhaust or ",{"meta":"https://docs.raku.org/routine/eager","type":"fcode","name":"L","content":["eagerly"]},"\nevaluate the ",{"type":"fcode","name":"C","content":["Seq"]}," ",{"type":"fcode","name":"C","content":["dir"]}," returns"]}]},{"type":"block","id":"ZvJkyyy-A8OKtAQH0ovDw","margin":"","name":"item","level":1,"location":{"start":{"line":25,"column":1,"offset":698},"end":{"line":27,"column":64,"offset":890}},"content":[{"type":"para","id":"TbJe4_dku_T91cgs7bxMn","margin":"","location":{"start":{"line":25,"column":3,"offset":700},"end":{"line":27,"column":64,"offset":890}},"text":"text","content":["You do that enough times in some tight loop that\n",{"meta":"https://en.wikipedia.org/wiki/Garbage_collection_(computer_science)","type":"fcode","name":"L","content":["GC"]},"\ndoesn't get a chance to clean up unreachable ",{"type":"fcode","name":"C","content":["dir"]}," ",{"type":"fcode","name":"C","content":["Seq"]},"s; or"]}]},{"type":"block","id":"cB5ySCh5Soqyp_-Cv9WtZ","margin":"","name":"item","level":1,"location":{"start":{"line":28,"column":1,"offset":891},"end":{"line":28,"column":58,"offset":948}},"content":[{"type":"para","id":"vYGYB8N17hA-I9uxLZYVP","margin":"","location":{"start":{"line":28,"column":3,"offset":893},"end":{"line":28,"column":58,"offset":948}},"text":"text","content":["You run this on some system with tight open file limits"]}]}]},{"type":"para","id":"nTLF16sAkg704j9ovlC4i","margin":"","location":{"start":{"line":30,"column":1,"offset":950},"end":{"line":33,"column":17,"offset":1182}},"text":"text","content":["If you're in that category, then good news! ",{"type":"fcode","name":"C","content":["IO::Dir"]}," gives you a ",{"type":"fcode","name":"C","content":["dir"]}," whose\nfile descriptor you can close without relying on GC or having to ",{"meta":"https://docs.raku.org/language/glossary#index-entry-Reify","type":"fcode","name":"L","content":["fully\nreify"]},"\nthe dir's ",{"type":"fcode","name":"C","content":["Seq"]},"."]},{"type":"block","id":"YPNap8B5lH183WFGLh8Ra","margin":"","level":1,"name":"head","location":{"start":{"line":35,"column":1,"offset":1184},"end":{"line":35,"column":10,"offset":1193}},"content":["METHODS"]},{"type":"block","id":"_C3XDVoT_-EBHGVfnXWpQ","margin":"","level":2,"name":"head","location":{"start":{"line":37,"column":1,"offset":1195},"end":{"line":37,"column":10,"offset":1204}},"content":[{"type":"fcode","name":"C","content":[".new"]}]},{"type":"para","id":"gg3a6DDnBLnk55LIcBD8H","margin":"","location":{"start":{"line":39,"column":1,"offset":1206},"end":{"line":39,"column":47,"offset":1252}},"text":"text","content":["Creates a new ",{"type":"fcode","name":"C","content":["IO::Dir"]}," object. Takes no args."]},{"type":"block","id":"i1S9KiTaP3yqXta1-rVmi","margin":"","level":2,"name":"head","location":{"start":{"line":41,"column":1,"offset":1254},"end":{"line":41,"column":11,"offset":1264}},"content":[{"type":"fcode","name":"C","content":[".open"]}]},{"type":"para","id":"6CMg2JjEhusxgeWOyiKrl","margin":"","location":{"start":{"line":43,"column":1,"offset":1266},"end":{"line":45,"column":25,"offset":1438}},"text":"text","content":["Opens for reading directory given as a positional argument, which can be\nany object that can be coerced to ",{"type":"fcode","name":"C","content":["IO::Path"]}," via ",{"type":"fcode","name":"C","content":[".IO"]}," method. Defaults to\nopening ",{"type":"fcode","name":"C","content":["'.'"]}," directory."]},{"type":"para","id":"-QqvqFArw7-N4JG5Miowf","margin":"","location":{"start":{"line":47,"column":1,"offset":1440},"end":{"line":47,"column":62,"offset":1501}},"text":"text","content":["Will first ",{"type":"fcode","name":"C","content":[".close"]}," the invocant if it was previously opened."]},{"type":"block","id":"ZNnZ7q6AlvQLBci8Q_XYp","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":49,"column":1,"offset":1503},"end":{"line":52,"column":4,"offset":1553}},"content":[{"type":"verbatim","value":"    $dir1.open;\n    $dir2.open: 'foo';"}]},{"type":"block","id":"y2dXz8NCjQzgzhk-F-0oW","margin":"","level":2,"name":"head","location":{"start":{"line":54,"column":1,"offset":1555},"end":{"line":54,"column":10,"offset":1564}},"content":[{"type":"fcode","name":"C","content":[".dir"]}]},{"type":"para","id":"zRFCTNTM6HYsSYHr1NN1k","margin":"","location":{"start":{"line":56,"column":1,"offset":1566},"end":{"line":59,"column":25,"offset":1764}},"text":"text","content":["Takes similar arguments as\n",{"meta":"https://docs.raku.org/routine/dir","type":"fcode","name":"L","content":[{"type":"fcode","name":"C","content":["IO::Path.dir"]}]},", that have the same\nmeaning, returning the same type of ",{"type":"fcode","name":"C","content":["Seq"]},". Will ",{"type":"fcode","name":"C","content":[".close"]}," the invocant when\nthe result is exhausted."]},{"type":"para","id":"hmR18IgG9VeyL9UJwmEoB","margin":"","location":{"start":{"line":61,"column":1,"offset":1766},"end":{"line":62,"column":45,"offset":1972}},"text":"text","content":["The additional arguments are boolean ",{"type":"fcode","name":"C","content":[":absolute"]}," and ",{"type":"fcode","name":"C","content":[":Str"]}," that control whether to return absolute paths when dir was opened via an absolute path and whether to\nreturn paths as ",{"type":"fcode","name":"C","content":["IO::Path"]}," or ",{"type":"fcode","name":"C","content":["Str"]}," objects."]},{"type":"para","id":"YdrULHgR82eFx4u8UDPBz","margin":"","location":{"start":{"line":64,"column":1,"offset":1974},"end":{"line":66,"column":24,"offset":2133}},"text":"text","content":[{"type":"fcode","name":"B","content":["Note:"]}," you cannot call ",{"type":"fcode","name":"C","content":[".dir"]}," more than once; re-open the\ninvocant or create a new ",{"type":"fcode","name":"C","content":["IO::Dir"]}," if you need that. Will die if called on\nan un-opened ",{"type":"fcode","name":"C","content":["IO::Dir"]},"."]},{"type":"block","id":"QiJHQPhoZ0VSrQFP3a2j2","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":68,"column":1,"offset":2135},"end":{"line":74,"column":4,"offset":2341}},"content":[{"type":"verbatim","value":"    # Explicit close:\n    .dir[^3].say and .close with IO::Dir.open: 'foo';\n\n    # Implicit close (arrays are mostly-eager, so our Seq is exhausted here)\n    my @files = IO::Dir.open('foo').dir;"}]},{"type":"block","id":"22AGi-jIzrUNpsB_jO2nk","margin":"","level":2,"name":"head","location":{"start":{"line":76,"column":1,"offset":2343},"end":{"line":76,"column":12,"offset":2354}},"content":[{"type":"fcode","name":"C","content":[".close"]}]},{"type":"para","id":"fQKH06HHrTthqqPqUX8u4","margin":"","location":{"start":{"line":78,"column":1,"offset":2356},"end":{"line":78,"column":55,"offset":2410}},"text":"text","content":["Closes an open ",{"type":"fcode","name":"C","content":["IO::Dir"]},", freeing the file descriptor."]},{"type":"block","id":"7ks_TBW7xyCaSTEeU7Xkv","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":80,"column":1,"offset":2412},"end":{"line":82,"column":4,"offset":2477}},"content":[{"type":"verbatim","value":"    .dir[^3].say and .close with IO::Dir.open: 'foo';"}]},{"type":"block","id":"cBzfRKiD_9ii-KN-1L8Tn","margin":"","level":4,"name":"head","location":{"start":{"line":86,"column":1,"offset":2484},"end":{"line":86,"column":16,"offset":2499}},"content":["REPOSITORY"]},{"type":"para","id":"didO-J3NS2_eaB2CFhyuN","margin":"","location":{"start":{"line":88,"column":1,"offset":2501},"end":{"line":89,"column":49,"offset":2577}},"text":"text","content":["Fork this module on GitHub:\n",{"meta":"https://github.com/raku-community-modules/IO-Dir","type":"fcode","name":"L","content":["https://github.com/raku-community-modules/IO-Dir"]}]},{"type":"block","id":"T4080ei9noHG0qlSfrEDP","margin":"","level":4,"name":"head","location":{"start":{"line":91,"column":1,"offset":2579},"end":{"line":91,"column":10,"offset":2588}},"content":["BUGS"]},{"type":"para","id":"GqC1saXUEyvOPaHDUzIQw","margin":"","location":{"start":{"line":93,"column":1,"offset":2590},"end":{"line":94,"column":56,"offset":2692}},"text":"text","content":["To report bugs or request features, please use\n",{"meta":"https://github.com/raku-community-modules/IO-Dir/issues","type":"fcode","name":"L","content":["https://github.com/raku-community-modules/IO-Dir/issues"]}]},{"type":"block","id":"B0ouqvLWHWH4fhrNhun8F","margin":"","level":4,"name":"head","location":{"start":{"line":96,"column":1,"offset":2694},"end":{"line":96,"column":12,"offset":2705}},"content":["AUTHOR"]},{"type":"para","id":"rXVn4LO-vvROquDperYgc","margin":"","location":{"start":{"line":98,"column":1,"offset":2707},"end":{"line":98,"column":34,"offset":2740}},"text":"text","content":["Zoffix Znet (",{"meta":"http://perl6.party/","type":"fcode","name":"L","content":["http://perl6.party/"]},")"]},{"type":"block","id":"iUEzfalzElGIV5JRF5Yyk","margin":"","level":4,"name":"head","location":{"start":{"line":100,"column":1,"offset":2742},"end":{"line":100,"column":13,"offset":2754}},"content":["LICENSE"]},{"type":"para","id":"ul5MFOVY_WN7dEKCJJDts","margin":"","location":{"start":{"line":102,"column":1,"offset":2756},"end":{"line":104,"column":35,"offset":2918}},"text":"text","content":["You can use and distribute this module under the terms of the\nThe Artistic License 2.0. See the ",{"type":"fcode","name":"C","content":["LICENSE"]}," file included in this\ndistribution for complete details."]},{"type":"para","id":"FvzdmnZ91A-X6bW0puLGc","margin":"","location":{"start":{"line":106,"column":1,"offset":2920},"end":{"line":107,"column":37,"offset":3031}},"text":"text","content":["The ",{"type":"fcode","name":"C","content":["META6.json"]}," file of this distribution may be distributed and modified\nwithout restrictions or attribution."]}]},"publishUrl":"/mods/zef/IO::Dir/dist/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"","auth":"zef:raku-community-modules","authors":["Zoffix Znet"],"depends":[],"description":"IO::Path.dir you can close","dist":"IO::Dir:ver<1.001004>:auth<zef:raku-community-modules>","license":"Artistic-2.0","name":"IO::Dir","path":"I/O_/IO_DIR/4dade30e2eb2fbbf00a30a231638c05abb8f2d2a.tar.gz","perl":"6.c","provides":{"IO::Dir":"lib/IO/Dir.pm6"},"support":{"source":"https://github.com/raku-community-modules/IO-Dir.git"},"tags":["IO","filesystem"],"test-depends":["Testo","Test::META"],"version":"1.001004"},"files":[{"file":"work_mods/zef/IO::Dir/dist/README.md","publishUrl":"/mods/zef/IO::Dir/dist/README.md"}],"src":"zef","url":"/mods/zef/IO::Dir"}}}
=end data


    =begin React :component<RenderItem>
    =begin data
    {"type":"page","file":"work_mods/zef/IO::Dir/dist/README.md","sources":[],"node":{"type":"block","id":"cv_SgNLc25-C1krttNk3s","margin":"","name":"root","content":[{"type":"para","id":"OPTFm37sKTe3trJghrP7K","margin":"","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":116,"offset":115}},"text":"text","content":[{"meta":"https://travis-ci.org/zoffixznet/perl6-IO-Dir","type":"fcode","name":"L","content":[{"type":"block","id":"VcJ_bAOZGkZr7saLUGX2F","margin":"","name":"Image","config":[],"location":{"start":{"line":1,"column":2,"offset":1},"end":{"line":1,"column":68,"offset":67}},"content":[{"type":"image","src":"https://travis-ci.org/zoffixznet/perl6-IO-Dir.svg","alt":"Build Status"}]}]}]},{"type":"block","id":"7SV1zduy0RikJTgdVmWzx","margin":"","level":1,"name":"head","location":{"start":{"line":3,"column":1,"offset":117},"end":{"line":3,"column":7,"offset":123}},"content":["NAME"]},{"type":"para","id":"ziaGEtVmhMC60g_-Scg9m","margin":"","location":{"start":{"line":5,"column":1,"offset":125},"end":{"line":5,"column":37,"offset":161}},"text":"text","content":["IO::Dir - IO::Path.dir you can close"]},{"type":"block","id":"m19OUf1wE_djUz4gyyJdN","margin":"","level":1,"name":"head","location":{"start":{"line":7,"column":1,"offset":163},"end":{"line":7,"column":11,"offset":173}},"content":["SYNOPSIS"]},{"type":"block","id":"ns9qBMSEC4ys3sTajldb4","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":9,"column":1,"offset":175},"end":{"line":16,"column":4,"offset":439}},"content":[{"type":"verbatim","value":"    # Won't always suit, since non-exhausted iterator holds on to an open\n    # file descriptor until GC:\n    'foo'.IO.dir[^3].say;\n\n    # all good; we explicitly close the file descriptor when done\n    .dir[^3].say and .close with IO::Dir.open: 'foo';"}]},{"type":"block","id":"4qKz65WuZXdSwutfoaAWA","margin":"","level":1,"name":"head","location":{"start":{"line":18,"column":1,"offset":441},"end":{"line":18,"column":14,"offset":454}},"content":["DESCRIPTION"]},{"type":"para","id":"ciyPjYDzgaWeCjRRnzQA3","margin":"","location":{"start":{"line":20,"column":1,"offset":456},"end":{"line":21,"column":62,"offset":591}},"text":"text","content":[{"meta":"https://docs.raku.org/routine/dir","type":"fcode","name":"L","content":[{"type":"fcode","name":"C","content":["IO::Path.dir"]}]}," does the job well for\nmost cases, however, there's an edge case where it's no good:"]},{"type":"list","id":"70BhyII7FxnEWnVlbP-UL","margin":"","level":1,"list":"itemized","content":[{"type":"block","id":"I5YRpSXin3JrJM8hX6YpV","margin":"","name":"item","level":1,"location":{"start":{"line":23,"column":1,"offset":593},"end":{"line":24,"column":35,"offset":697}},"content":[{"type":"para","id":"AgId7ye1XkdKA3r3x3ZVJ","margin":"","location":{"start":{"line":23,"column":3,"offset":595},"end":{"line":24,"column":35,"offset":697}},"text":"text","content":["You don't exhaust or ",{"meta":"https://docs.raku.org/routine/eager","type":"fcode","name":"L","content":["eagerly"]},"\nevaluate the ",{"type":"fcode","name":"C","content":["Seq"]}," ",{"type":"fcode","name":"C","content":["dir"]}," returns"]}]},{"type":"block","id":"ZvJkyyy-A8OKtAQH0ovDw","margin":"","name":"item","level":1,"location":{"start":{"line":25,"column":1,"offset":698},"end":{"line":27,"column":64,"offset":890}},"content":[{"type":"para","id":"TbJe4_dku_T91cgs7bxMn","margin":"","location":{"start":{"line":25,"column":3,"offset":700},"end":{"line":27,"column":64,"offset":890}},"text":"text","content":["You do that enough times in some tight loop that\n",{"meta":"https://en.wikipedia.org/wiki/Garbage_collection_(computer_science)","type":"fcode","name":"L","content":["GC"]},"\ndoesn't get a chance to clean up unreachable ",{"type":"fcode","name":"C","content":["dir"]}," ",{"type":"fcode","name":"C","content":["Seq"]},"s; or"]}]},{"type":"block","id":"cB5ySCh5Soqyp_-Cv9WtZ","margin":"","name":"item","level":1,"location":{"start":{"line":28,"column":1,"offset":891},"end":{"line":28,"column":58,"offset":948}},"content":[{"type":"para","id":"vYGYB8N17hA-I9uxLZYVP","margin":"","location":{"start":{"line":28,"column":3,"offset":893},"end":{"line":28,"column":58,"offset":948}},"text":"text","content":["You run this on some system with tight open file limits"]}]}]},{"type":"para","id":"nTLF16sAkg704j9ovlC4i","margin":"","location":{"start":{"line":30,"column":1,"offset":950},"end":{"line":33,"column":17,"offset":1182}},"text":"text","content":["If you're in that category, then good news! ",{"type":"fcode","name":"C","content":["IO::Dir"]}," gives you a ",{"type":"fcode","name":"C","content":["dir"]}," whose\nfile descriptor you can close without relying on GC or having to ",{"meta":"https://docs.raku.org/language/glossary#index-entry-Reify","type":"fcode","name":"L","content":["fully\nreify"]},"\nthe dir's ",{"type":"fcode","name":"C","content":["Seq"]},"."]},{"type":"block","id":"YPNap8B5lH183WFGLh8Ra","margin":"","level":1,"name":"head","location":{"start":{"line":35,"column":1,"offset":1184},"end":{"line":35,"column":10,"offset":1193}},"content":["METHODS"]},{"type":"block","id":"_C3XDVoT_-EBHGVfnXWpQ","margin":"","level":2,"name":"head","location":{"start":{"line":37,"column":1,"offset":1195},"end":{"line":37,"column":10,"offset":1204}},"content":[{"type":"fcode","name":"C","content":[".new"]}]},{"type":"para","id":"gg3a6DDnBLnk55LIcBD8H","margin":"","location":{"start":{"line":39,"column":1,"offset":1206},"end":{"line":39,"column":47,"offset":1252}},"text":"text","content":["Creates a new ",{"type":"fcode","name":"C","content":["IO::Dir"]}," object. Takes no args."]},{"type":"block","id":"i1S9KiTaP3yqXta1-rVmi","margin":"","level":2,"name":"head","location":{"start":{"line":41,"column":1,"offset":1254},"end":{"line":41,"column":11,"offset":1264}},"content":[{"type":"fcode","name":"C","content":[".open"]}]},{"type":"para","id":"6CMg2JjEhusxgeWOyiKrl","margin":"","location":{"start":{"line":43,"column":1,"offset":1266},"end":{"line":45,"column":25,"offset":1438}},"text":"text","content":["Opens for reading directory given as a positional argument, which can be\nany object that can be coerced to ",{"type":"fcode","name":"C","content":["IO::Path"]}," via ",{"type":"fcode","name":"C","content":[".IO"]}," method. Defaults to\nopening ",{"type":"fcode","name":"C","content":["'.'"]}," directory."]},{"type":"para","id":"-QqvqFArw7-N4JG5Miowf","margin":"","location":{"start":{"line":47,"column":1,"offset":1440},"end":{"line":47,"column":62,"offset":1501}},"text":"text","content":["Will first ",{"type":"fcode","name":"C","content":[".close"]}," the invocant if it was previously opened."]},{"type":"block","id":"ZNnZ7q6AlvQLBci8Q_XYp","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":49,"column":1,"offset":1503},"end":{"line":52,"column":4,"offset":1553}},"content":[{"type":"verbatim","value":"    $dir1.open;\n    $dir2.open: 'foo';"}]},{"type":"block","id":"y2dXz8NCjQzgzhk-F-0oW","margin":"","level":2,"name":"head","location":{"start":{"line":54,"column":1,"offset":1555},"end":{"line":54,"column":10,"offset":1564}},"content":[{"type":"fcode","name":"C","content":[".dir"]}]},{"type":"para","id":"zRFCTNTM6HYsSYHr1NN1k","margin":"","location":{"start":{"line":56,"column":1,"offset":1566},"end":{"line":59,"column":25,"offset":1764}},"text":"text","content":["Takes similar arguments as\n",{"meta":"https://docs.raku.org/routine/dir","type":"fcode","name":"L","content":[{"type":"fcode","name":"C","content":["IO::Path.dir"]}]},", that have the same\nmeaning, returning the same type of ",{"type":"fcode","name":"C","content":["Seq"]},". Will ",{"type":"fcode","name":"C","content":[".close"]}," the invocant when\nthe result is exhausted."]},{"type":"para","id":"hmR18IgG9VeyL9UJwmEoB","margin":"","location":{"start":{"line":61,"column":1,"offset":1766},"end":{"line":62,"column":45,"offset":1972}},"text":"text","content":["The additional arguments are boolean ",{"type":"fcode","name":"C","content":[":absolute"]}," and ",{"type":"fcode","name":"C","content":[":Str"]}," that control whether to return absolute paths when dir was opened via an absolute path and whether to\nreturn paths as ",{"type":"fcode","name":"C","content":["IO::Path"]}," or ",{"type":"fcode","name":"C","content":["Str"]}," objects."]},{"type":"para","id":"YdrULHgR82eFx4u8UDPBz","margin":"","location":{"start":{"line":64,"column":1,"offset":1974},"end":{"line":66,"column":24,"offset":2133}},"text":"text","content":[{"type":"fcode","name":"B","content":["Note:"]}," you cannot call ",{"type":"fcode","name":"C","content":[".dir"]}," more than once; re-open the\ninvocant or create a new ",{"type":"fcode","name":"C","content":["IO::Dir"]}," if you need that. Will die if called on\nan un-opened ",{"type":"fcode","name":"C","content":["IO::Dir"]},"."]},{"type":"block","id":"QiJHQPhoZ0VSrQFP3a2j2","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":68,"column":1,"offset":2135},"end":{"line":74,"column":4,"offset":2341}},"content":[{"type":"verbatim","value":"    # Explicit close:\n    .dir[^3].say and .close with IO::Dir.open: 'foo';\n\n    # Implicit close (arrays are mostly-eager, so our Seq is exhausted here)\n    my @files = IO::Dir.open('foo').dir;"}]},{"type":"block","id":"22AGi-jIzrUNpsB_jO2nk","margin":"","level":2,"name":"head","location":{"start":{"line":76,"column":1,"offset":2343},"end":{"line":76,"column":12,"offset":2354}},"content":[{"type":"fcode","name":"C","content":[".close"]}]},{"type":"para","id":"fQKH06HHrTthqqPqUX8u4","margin":"","location":{"start":{"line":78,"column":1,"offset":2356},"end":{"line":78,"column":55,"offset":2410}},"text":"text","content":["Closes an open ",{"type":"fcode","name":"C","content":["IO::Dir"]},", freeing the file descriptor."]},{"type":"block","id":"7ks_TBW7xyCaSTEeU7Xkv","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":80,"column":1,"offset":2412},"end":{"line":82,"column":4,"offset":2477}},"content":[{"type":"verbatim","value":"    .dir[^3].say and .close with IO::Dir.open: 'foo';"}]},{"type":"block","id":"cBzfRKiD_9ii-KN-1L8Tn","margin":"","level":4,"name":"head","location":{"start":{"line":86,"column":1,"offset":2484},"end":{"line":86,"column":16,"offset":2499}},"content":["REPOSITORY"]},{"type":"para","id":"didO-J3NS2_eaB2CFhyuN","margin":"","location":{"start":{"line":88,"column":1,"offset":2501},"end":{"line":89,"column":49,"offset":2577}},"text":"text","content":["Fork this module on GitHub:\n",{"meta":"https://github.com/raku-community-modules/IO-Dir","type":"fcode","name":"L","content":["https://github.com/raku-community-modules/IO-Dir"]}]},{"type":"block","id":"T4080ei9noHG0qlSfrEDP","margin":"","level":4,"name":"head","location":{"start":{"line":91,"column":1,"offset":2579},"end":{"line":91,"column":10,"offset":2588}},"content":["BUGS"]},{"type":"para","id":"GqC1saXUEyvOPaHDUzIQw","margin":"","location":{"start":{"line":93,"column":1,"offset":2590},"end":{"line":94,"column":56,"offset":2692}},"text":"text","content":["To report bugs or request features, please use\n",{"meta":"https://github.com/raku-community-modules/IO-Dir/issues","type":"fcode","name":"L","content":["https://github.com/raku-community-modules/IO-Dir/issues"]}]},{"type":"block","id":"B0ouqvLWHWH4fhrNhun8F","margin":"","level":4,"name":"head","location":{"start":{"line":96,"column":1,"offset":2694},"end":{"line":96,"column":12,"offset":2705}},"content":["AUTHOR"]},{"type":"para","id":"rXVn4LO-vvROquDperYgc","margin":"","location":{"start":{"line":98,"column":1,"offset":2707},"end":{"line":98,"column":34,"offset":2740}},"text":"text","content":["Zoffix Znet (",{"meta":"http://perl6.party/","type":"fcode","name":"L","content":["http://perl6.party/"]},")"]},{"type":"block","id":"iUEzfalzElGIV5JRF5Yyk","margin":"","level":4,"name":"head","location":{"start":{"line":100,"column":1,"offset":2742},"end":{"line":100,"column":13,"offset":2754}},"content":["LICENSE"]},{"type":"para","id":"ul5MFOVY_WN7dEKCJJDts","margin":"","location":{"start":{"line":102,"column":1,"offset":2756},"end":{"line":104,"column":35,"offset":2918}},"text":"text","content":["You can use and distribute this module under the terms of the\nThe Artistic License 2.0. See the ",{"type":"fcode","name":"C","content":["LICENSE"]}," file included in this\ndistribution for complete details."]},{"type":"para","id":"FvzdmnZ91A-X6bW0puLGc","margin":"","location":{"start":{"line":106,"column":1,"offset":2920},"end":{"line":107,"column":37,"offset":3031}},"text":"text","content":["The ",{"type":"fcode","name":"C","content":["META6.json"]}," file of this distribution may be distributed and modified\nwithout restrictions or attribution."]}]},"publishUrl":"/mods/zef/IO::Dir/dist/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"","auth":"zef:raku-community-modules","authors":["Zoffix Znet"],"depends":[],"description":"IO::Path.dir you can close","dist":"IO::Dir:ver<1.001004>:auth<zef:raku-community-modules>","license":"Artistic-2.0","name":"IO::Dir","path":"I/O_/IO_DIR/4dade30e2eb2fbbf00a30a231638c05abb8f2d2a.tar.gz","perl":"6.c","provides":{"IO::Dir":"lib/IO/Dir.pm6"},"support":{"source":"https://github.com/raku-community-modules/IO-Dir.git"},"tags":["IO","filesystem"],"test-depends":["Testo","Test::META"],"version":"1.001004"},"files":[{"file":"work_mods/zef/IO::Dir/dist/README.md","publishUrl":"/mods/zef/IO::Dir/dist/README.md"}],"src":"zef","url":"/mods/zef/IO::Dir"}}}
    =end data
    =end React


IO::Path.dir you can close


IO::Dir


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


IO::Maildir

About

Synopsis

License

IO::Maildir v0.0.1

Authors

License

Dependencies

Test Dependencies

Provides

Documentation