TITLE

Augment IO::Path with a .mode() method to get the file mode


SUBTITLE

data

=begin data
{"type":"page","file":"work_mods/zef/IO::Path::Mode/IO-Path-Mode-0.0.9/README.md","sources":[],"node":{"type":"block","id":"54s5W234fwKO3dtBUiqf2","margin":"","name":"root","content":[{"type":"block","id":"BHN9okss8rMs8ePnDUOW-","margin":"","level":1,"name":"head","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":17,"offset":16}},"content":["IO::Path::Mode"]},{"type":"para","id":"8QD08zPuV_ubUojh0T03m","margin":"","location":{"start":{"line":3,"column":1,"offset":18},"end":{"line":3,"column":67,"offset":84}},"text":"text","content":["Augment Raku's IO::Path with a .mode() method to get the file mode"]},{"type":"para","id":"IkBh5GOHv_F_jUYw7KlvR","margin":"","location":{"start":{"line":5,"column":1,"offset":86},"end":{"line":5,"column":86,"offset":171}},"text":"text","content":[{"type":"block","id":"EDJowIap-2wIxg-fNB3W5","margin":"","name":"Image","config":[],"location":{"start":{"line":5,"column":1,"offset":86},"end":{"line":5,"column":86,"offset":171}},"content":[{"type":"image","src":"https://github.com/jonathanstowe/IO-Path-Mode/workflows/CI/badge.svg","alt":"Build Status"}]}]},{"type":"block","id":"pv8T5akWhPBEL2VCXkJPI","margin":"","level":2,"name":"head","location":{"start":{"line":7,"column":1,"offset":173},"end":{"line":7,"column":12,"offset":184}},"content":["Synopsis"]},{"type":"block","id":"Jkya0vKjjgsWCq-ClQ3_l","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":9,"column":1,"offset":186},"end":{"line":24,"column":4,"offset":467}},"content":[{"type":"verbatim","value":"\nuse IO::Path::Mode;\n\nmy $mode = \"some-file\".IO.mode;\n\nsay $mode.set-user-id ?? 'setuid' !! 'not setuid';\n\nsay $mode.user.execute ?? 'executable' !! 'not executable';\n\nsay $mode.file-type == IO::Path::Mode::File ?? 'file' !! 'something other than a normal file';\n\n...\n\n"}]},{"type":"block","id":"b2-MjfqhtbdvU8y5HvG3n","margin":"","level":2,"name":"head","location":{"start":{"line":26,"column":1,"offset":469},"end":{"line":26,"column":15,"offset":483}},"content":["Description"]},{"type":"para","id":"eF-oUlIgEl2TKVgP5UUDD","margin":"","location":{"start":{"line":28,"column":1,"offset":485},"end":{"line":32,"column":68,"offset":827}},"text":"text","content":["This augments the type ",{"type":"fcode","name":"C","content":["IO::Path"]}," to provide a ",{"type":"fcode","name":"C","content":[".mode"]}," method\nthat allows you to get at the file permissions (or mode.) It follows\nthe POSIX model pf user, group and other permissions and consequently\nmay not make a meaningful result on e.g. Windows (although the underlying\ncalls appear to return something approximating the correct answer.)"]},{"type":"para","id":"2GjytxyEzoRk2TUixMlCv","margin":"","location":{"start":{"line":34,"column":1,"offset":829},"end":{"line":38,"column":13,"offset":1110}},"text":"text","content":["If you have a more recent rakudo that provides a ",{"type":"fcode","name":"C","content":["mode"]}," method, it\nwill replace that method with one that returns an ",{"type":"fcode","name":"C","content":["IO::Path::Mode"]},"\nobject rather than an ",{"type":"fcode","name":"C","content":["IntStr"]},", this is a transitional arrangement\nand will be deprecated in a future release in favour of a different\nmethod name."]},{"type":"para","id":"GyzKazTkZWPR2-8kMTedW","margin":"","location":{"start":{"line":40,"column":1,"offset":1112},"end":{"line":41,"column":33,"offset":1216}},"text":"text","content":["It relies on some non-specified functionality in the VM so may probably\nonly work with Rakudo on MoarVM."]},{"type":"para","id":"i7DVdfUccBe08I6yi13jB","margin":"","location":{"start":{"line":43,"column":1,"offset":1218},"end":{"line":45,"column":49,"offset":1408}},"text":"text","content":["This is mostly provided as some relief for not having the functionality\ndirectly exposed in Rakudo and as a discussion board for the best way\nof implementing the functionality going forward."]},{"type":"block","id":"8QfkS1w4xJVsgcG2hb-3e","margin":"","level":2,"name":"head","location":{"start":{"line":47,"column":1,"offset":1410},"end":{"line":47,"column":16,"offset":1425}},"content":["Installation"]},{"type":"para","id":"aPoowC-QrlXgFT_g1CFKk","margin":"","location":{"start":{"line":49,"column":1,"offset":1427},"end":{"line":49,"column":96,"offset":1522}},"text":"text","content":["Assuming you have a working Rakudo installation you should be able to install this with ",{"type":"fcode","name":"I","content":["zef"]}," :"]},{"type":"block","id":"ykFf3dr7PzwxZNdbNLBn3","margin":"","name":"code","config":[],"location":{"start":{"line":51,"column":1,"offset":1524},"end":{"line":57,"column":31,"offset":1633}},"content":[{"type":"verbatim","value":"# From the source directory\n\nzef install .\n\n# Remote installation\n\nzef install IO::Path::Mode"}]},{"type":"block","id":"pHQS1lB40X7Z6JBht7TzG","margin":"","level":2,"name":"head","location":{"start":{"line":59,"column":1,"offset":1635},"end":{"line":59,"column":11,"offset":1645}},"content":["Support"]},{"type":"para","id":"xlOSDt8t91ny2MM_D5lNq","margin":"","location":{"start":{"line":61,"column":1,"offset":1647},"end":{"line":61,"column":103,"offset":1749}},"text":"text","content":["I welcome suggestions, patches and bug reports at ",{"meta":"https://github.com/jonathanstowe/IO-Path-Mode/issues","type":"fcode","name":"L","content":["https://github.com/jonathanstowe/IO-Path-Mode/issues"]}]},{"type":"para","id":"LoNvk7rW1Q5bVNHiXjFoK","margin":"","location":{"start":{"line":63,"column":1,"offset":1751},"end":{"line":65,"column":37,"offset":1915}},"text":"text","content":["I'd be particularly interested in suggestions relating to making\nthe mode mutable and adding a multi candidate for 'chmod' that\ncan take an ",{"type":"fcode","name":"C","content":["IO::Path::Mode"]}," object."]},{"type":"block","id":"r8OndLZNsYSOghHirJgdW","margin":"","level":2,"name":"head","location":{"start":{"line":67,"column":1,"offset":1917},"end":{"line":67,"column":11,"offset":1927}},"content":["Licence"]},{"type":"para","id":"PXxTxWtcdY47MDTYIVVll","margin":"","location":{"start":{"line":69,"column":1,"offset":1929},"end":{"line":69,"column":23,"offset":1951}},"text":"text","content":["This is free software."]},{"type":"para","id":"noxpMp3Wzd4M-DwHXT6mI","margin":"","location":{"start":{"line":71,"column":1,"offset":1953},"end":{"line":71,"column":59,"offset":2011}},"text":"text","content":["Please see the ",{"meta":"LICENCE","type":"fcode","name":"L","content":["LICENCE"]}," file in the distribution"]},{"type":"para","id":"k6nCX-Ca3407ZL0yNt52W","margin":"","location":{"start":{"line":73,"column":1,"offset":2013},"end":{"line":73,"column":29,"offset":2041}},"text":"text","content":["© Jonathan Stowe 2016 - 2021"]}]},"publishUrl":"/mods/zef/IO::Path::Mode/IO-Path-Mode-0.0.9/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"1.0","auth":"zef:jonathanstowe","authors":["Jonathan Stowe <jns+git@gellyfish.co.uk>"],"build-depends":[],"depends":[],"description":"Augment IO::Path with a .mode() method to get the file mode","dist":"IO::Path::Mode:ver<0.0.9>:auth<zef:jonathanstowe>","license":"Artistic-2.0","meta-version":"1","name":"IO::Path::Mode","path":"I/O_/IO_PATH_MODE/3827d99b0b9f8912ae2190ee2062bc05ceb6de6b.tar.gz","provides":{"IO::Path::Mode":"lib/IO/Path/Mode.pm"},"raku":"6.*","resources":[],"source-url":"git://github.com/jonathanstowe/IO-Path-Mode.git","support":{"bugtracker":"https://github.com/jonathanstowe/IO-Path-Mode/issues","email":"jns+git@gellyfish.co.uk","source":"git://github.com/jonathanstowe/IO-Path-Mode.git"},"tags":["IO","permissions","mode","utility"],"test-depends":["Test"],"version":"0.0.9"},"files":[{"file":"work_mods/zef/IO::Path::Mode/IO-Path-Mode-0.0.9/README.md","publishUrl":"/mods/zef/IO::Path::Mode/IO-Path-Mode-0.0.9/README.md"},{"file":"work_mods/zef/IO::Path::Mode/IO-Path-Mode-0.0.9/lib/IO/Path/Mode.pm","publishUrl":"/mods/zef/IO::Path::Mode/IO-Path-Mode-0.0.9/lib/IO/Path/Mode.pm"}],"src":"zef","url":"/mods/zef/IO::Path::Mode"}}}
=end data


React

    =begin React :component<RenderItem>
    =begin data
    {"type":"page","file":"work_mods/zef/IO::Path::Mode/IO-Path-Mode-0.0.9/README.md","sources":[],"node":{"type":"block","id":"54s5W234fwKO3dtBUiqf2","margin":"","name":"root","content":[{"type":"block","id":"BHN9okss8rMs8ePnDUOW-","margin":"","level":1,"name":"head","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":17,"offset":16}},"content":["IO::Path::Mode"]},{"type":"para","id":"8QD08zPuV_ubUojh0T03m","margin":"","location":{"start":{"line":3,"column":1,"offset":18},"end":{"line":3,"column":67,"offset":84}},"text":"text","content":["Augment Raku's IO::Path with a .mode() method to get the file mode"]},{"type":"para","id":"IkBh5GOHv_F_jUYw7KlvR","margin":"","location":{"start":{"line":5,"column":1,"offset":86},"end":{"line":5,"column":86,"offset":171}},"text":"text","content":[{"type":"block","id":"EDJowIap-2wIxg-fNB3W5","margin":"","name":"Image","config":[],"location":{"start":{"line":5,"column":1,"offset":86},"end":{"line":5,"column":86,"offset":171}},"content":[{"type":"image","src":"https://github.com/jonathanstowe/IO-Path-Mode/workflows/CI/badge.svg","alt":"Build Status"}]}]},{"type":"block","id":"pv8T5akWhPBEL2VCXkJPI","margin":"","level":2,"name":"head","location":{"start":{"line":7,"column":1,"offset":173},"end":{"line":7,"column":12,"offset":184}},"content":["Synopsis"]},{"type":"block","id":"Jkya0vKjjgsWCq-ClQ3_l","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":9,"column":1,"offset":186},"end":{"line":24,"column":4,"offset":467}},"content":[{"type":"verbatim","value":"\nuse IO::Path::Mode;\n\nmy $mode = \"some-file\".IO.mode;\n\nsay $mode.set-user-id ?? 'setuid' !! 'not setuid';\n\nsay $mode.user.execute ?? 'executable' !! 'not executable';\n\nsay $mode.file-type == IO::Path::Mode::File ?? 'file' !! 'something other than a normal file';\n\n...\n\n"}]},{"type":"block","id":"b2-MjfqhtbdvU8y5HvG3n","margin":"","level":2,"name":"head","location":{"start":{"line":26,"column":1,"offset":469},"end":{"line":26,"column":15,"offset":483}},"content":["Description"]},{"type":"para","id":"eF-oUlIgEl2TKVgP5UUDD","margin":"","location":{"start":{"line":28,"column":1,"offset":485},"end":{"line":32,"column":68,"offset":827}},"text":"text","content":["This augments the type ",{"type":"fcode","name":"C","content":["IO::Path"]}," to provide a ",{"type":"fcode","name":"C","content":[".mode"]}," method\nthat allows you to get at the file permissions (or mode.) It follows\nthe POSIX model pf user, group and other permissions and consequently\nmay not make a meaningful result on e.g. Windows (although the underlying\ncalls appear to return something approximating the correct answer.)"]},{"type":"para","id":"2GjytxyEzoRk2TUixMlCv","margin":"","location":{"start":{"line":34,"column":1,"offset":829},"end":{"line":38,"column":13,"offset":1110}},"text":"text","content":["If you have a more recent rakudo that provides a ",{"type":"fcode","name":"C","content":["mode"]}," method, it\nwill replace that method with one that returns an ",{"type":"fcode","name":"C","content":["IO::Path::Mode"]},"\nobject rather than an ",{"type":"fcode","name":"C","content":["IntStr"]},", this is a transitional arrangement\nand will be deprecated in a future release in favour of a different\nmethod name."]},{"type":"para","id":"GyzKazTkZWPR2-8kMTedW","margin":"","location":{"start":{"line":40,"column":1,"offset":1112},"end":{"line":41,"column":33,"offset":1216}},"text":"text","content":["It relies on some non-specified functionality in the VM so may probably\nonly work with Rakudo on MoarVM."]},{"type":"para","id":"i7DVdfUccBe08I6yi13jB","margin":"","location":{"start":{"line":43,"column":1,"offset":1218},"end":{"line":45,"column":49,"offset":1408}},"text":"text","content":["This is mostly provided as some relief for not having the functionality\ndirectly exposed in Rakudo and as a discussion board for the best way\nof implementing the functionality going forward."]},{"type":"block","id":"8QfkS1w4xJVsgcG2hb-3e","margin":"","level":2,"name":"head","location":{"start":{"line":47,"column":1,"offset":1410},"end":{"line":47,"column":16,"offset":1425}},"content":["Installation"]},{"type":"para","id":"aPoowC-QrlXgFT_g1CFKk","margin":"","location":{"start":{"line":49,"column":1,"offset":1427},"end":{"line":49,"column":96,"offset":1522}},"text":"text","content":["Assuming you have a working Rakudo installation you should be able to install this with ",{"type":"fcode","name":"I","content":["zef"]}," :"]},{"type":"block","id":"ykFf3dr7PzwxZNdbNLBn3","margin":"","name":"code","config":[],"location":{"start":{"line":51,"column":1,"offset":1524},"end":{"line":57,"column":31,"offset":1633}},"content":[{"type":"verbatim","value":"# From the source directory\n\nzef install .\n\n# Remote installation\n\nzef install IO::Path::Mode"}]},{"type":"block","id":"pHQS1lB40X7Z6JBht7TzG","margin":"","level":2,"name":"head","location":{"start":{"line":59,"column":1,"offset":1635},"end":{"line":59,"column":11,"offset":1645}},"content":["Support"]},{"type":"para","id":"xlOSDt8t91ny2MM_D5lNq","margin":"","location":{"start":{"line":61,"column":1,"offset":1647},"end":{"line":61,"column":103,"offset":1749}},"text":"text","content":["I welcome suggestions, patches and bug reports at ",{"meta":"https://github.com/jonathanstowe/IO-Path-Mode/issues","type":"fcode","name":"L","content":["https://github.com/jonathanstowe/IO-Path-Mode/issues"]}]},{"type":"para","id":"LoNvk7rW1Q5bVNHiXjFoK","margin":"","location":{"start":{"line":63,"column":1,"offset":1751},"end":{"line":65,"column":37,"offset":1915}},"text":"text","content":["I'd be particularly interested in suggestions relating to making\nthe mode mutable and adding a multi candidate for 'chmod' that\ncan take an ",{"type":"fcode","name":"C","content":["IO::Path::Mode"]}," object."]},{"type":"block","id":"r8OndLZNsYSOghHirJgdW","margin":"","level":2,"name":"head","location":{"start":{"line":67,"column":1,"offset":1917},"end":{"line":67,"column":11,"offset":1927}},"content":["Licence"]},{"type":"para","id":"PXxTxWtcdY47MDTYIVVll","margin":"","location":{"start":{"line":69,"column":1,"offset":1929},"end":{"line":69,"column":23,"offset":1951}},"text":"text","content":["This is free software."]},{"type":"para","id":"noxpMp3Wzd4M-DwHXT6mI","margin":"","location":{"start":{"line":71,"column":1,"offset":1953},"end":{"line":71,"column":59,"offset":2011}},"text":"text","content":["Please see the ",{"meta":"LICENCE","type":"fcode","name":"L","content":["LICENCE"]}," file in the distribution"]},{"type":"para","id":"k6nCX-Ca3407ZL0yNt52W","margin":"","location":{"start":{"line":73,"column":1,"offset":2013},"end":{"line":73,"column":29,"offset":2041}},"text":"text","content":["© Jonathan Stowe 2016 - 2021"]}]},"publishUrl":"/mods/zef/IO::Path::Mode/IO-Path-Mode-0.0.9/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"1.0","auth":"zef:jonathanstowe","authors":["Jonathan Stowe <jns+git@gellyfish.co.uk>"],"build-depends":[],"depends":[],"description":"Augment IO::Path with a .mode() method to get the file mode","dist":"IO::Path::Mode:ver<0.0.9>:auth<zef:jonathanstowe>","license":"Artistic-2.0","meta-version":"1","name":"IO::Path::Mode","path":"I/O_/IO_PATH_MODE/3827d99b0b9f8912ae2190ee2062bc05ceb6de6b.tar.gz","provides":{"IO::Path::Mode":"lib/IO/Path/Mode.pm"},"raku":"6.*","resources":[],"source-url":"git://github.com/jonathanstowe/IO-Path-Mode.git","support":{"bugtracker":"https://github.com/jonathanstowe/IO-Path-Mode/issues","email":"jns+git@gellyfish.co.uk","source":"git://github.com/jonathanstowe/IO-Path-Mode.git"},"tags":["IO","permissions","mode","utility"],"test-depends":["Test"],"version":"0.0.9"},"files":[{"file":"work_mods/zef/IO::Path::Mode/IO-Path-Mode-0.0.9/README.md","publishUrl":"/mods/zef/IO::Path::Mode/IO-Path-Mode-0.0.9/README.md"},{"file":"work_mods/zef/IO::Path::Mode/IO-Path-Mode-0.0.9/lib/IO/Path/Mode.pm","publishUrl":"/mods/zef/IO::Path::Mode/IO-Path-Mode-0.0.9/lib/IO/Path/Mode.pm"}],"src":"zef","url":"/mods/zef/IO::Path::Mode"}}}
    =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

IO::Path::Mode


This is a generic module for interactive prompting from the console.


=begin data
{"type":"page","file":"work_mods/zef/IO::Prompt/dist/README.md","sources":[],"node":{"type":"block","id":"orE_VYBNDQX2QMkI_YrBw","margin":"","name":"root","content":[{"type":"para","id":"SFJiP1DIJ3OchY0-ggQZh","margin":"","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":53,"offset":52}},"text":"text","content":["IO::Prompt -- Interactive validating terminal prompt"]},{"type":"block","id":"m6VkXOIn59O3p5WdtK5fX","margin":"","level":1,"name":"head","location":{"start":{"line":3,"column":1,"offset":54},"end":{"line":3,"column":7,"offset":60}},"content":["HTML"]},{"type":"para","id":"52DLIOwaZ7V_5gMZrwulD","margin":"","location":{"start":{"line":5,"column":1,"offset":62},"end":{"line":5,"column":122,"offset":183}},"text":"text","content":[{"type":"block","id":"6yzqO0PtGqIrDcAjCwRqU","margin":"","name":"Html","location":{"start":{"line":5,"column":1,"offset":62},"end":{"line":5,"column":50,"offset":111}},"content":[{"type":"verbatim","value":"<a href=\"https://travis-ci.org/wbiker/io-prompt\">"}]},{"type":"block","id":"jZqYLe6K78wUzzzJhW9FF","margin":"","name":"Html","location":{"start":{"line":5,"column":50,"offset":111},"end":{"line":5,"column":118,"offset":179}},"content":[{"type":"verbatim","value":"<img src=\"https://travis-ci.org/wbiker/io-prompt.svg?branch=master\">"}]},{"type":"block","id":"aQ_ajwhFz8KqvU-yUeZN1","margin":"","name":"Html","location":{"start":{"line":5,"column":118,"offset":179},"end":{"line":5,"column":122,"offset":183}},"content":[{"type":"verbatim","value":"</a>"}]}]},{"type":"block","id":"gZ7uTxK0eJSPmFjx75e56","margin":"","level":1,"name":"head","location":{"start":{"line":7,"column":1,"offset":185},"end":{"line":7,"column":11,"offset":195}},"content":["SYNOPSIS"]},{"type":"block","id":"j0mchqnhJmnsgcXE4tXoT","margin":"","name":"code","config":[],"location":{"start":{"line":9,"column":1,"offset":197},"end":{"line":78,"column":42,"offset":2566}},"content":[{"type":"verbatim","value":"use v6;\nuse IO::Prompt;\n\nmy $a = ask( \"Defaults to 42, type Num?\", 42, :type(Num) );\nsay $a.perl;\nsay '------------------------------';\n\n$a = ask( \"Defaults to false?\", Bool::False );\nsay $a.perl;\nsay '------------------------------';\n\n$a = ask( \"No default but type Bool?\", :type(Bool) );\nsay $a.perl;\nsay '------------------------------';\n\n\n## OO style ##\nmy $prompt = IO::Prompt.new();\n\n$a = $prompt.ask( \"Dot notation?\", Bool::False );\nsay $a.perl;\nsay '------------------------------';\n\n\n## You can override the IO methods for testing purposes\nclass IO::Prompt::Testable is IO::Prompt {\n    method !do_say( Str $question ) returns Bool {\n        say \"Testable saying    '$question'\";\n        say 'Please do not continue questioning';\n        return Bool::False; # do not continue\n    }\n    method !do_prompt( Str $question ) returns Str {\n        say \"Testable saying    '$question'\";\n        say \"Testable answering 'daa'\";\n        return 'daa';\n    }\n}\n\nmy $prompt_test = IO::Prompt::Testable.new();\n$a = $prompt_test.ask_yn( \"Testable, defaults to false?\", Bool::False );\nsay $a.perl;\nsay '------------------------------';\n\n\n## You can override the language class attributes\nclass IO::Prompt::Finnish is IO::Prompt {\n    our $.lang_prompt_Yn        = 'K/e';\n    our $.lang_prompt_yN        = 'k/E';\n    our $.lang_prompt_yn        = 'k/e';\n    our $.lang_prompt_yn_retry  = 'Sano kyllä tai ei';\n    our $.lang_prompt_match_y   = m/ ^^ <[kK]> /;\n    our $.lang_prompt_match_n   = m/ ^^ <[eE]> /;\n    our $.lang_prompt_int       = 'Int';\n    our $.lang_prompt_int_retry = 'Anna kokonaisluku';\n    our $.lang_prompt_num       = 'Num';\n    our $.lang_prompt_num_retry = 'Anna luku';\n    our $.lang_prompt_str       = 'Str';\n    our $.lang_prompt_str_retry = 'Anna merkkijono';\n}\n\nmy $prompt_fi = IO::Prompt::Finnish.new();\n$a = $prompt_fi.ask( \"Suomeksi Bool?\", :type(Bool) );\nsay $a.perl;\nsay '------------------------------';\n$a = $prompt_fi.ask( \"Suomeksi Num?\", :type(Num) );\nsay $a.perl;\nsay '------------------------------';\n$a = $prompt_fi.ask( \"Suomeksi Str?\", :type(Str) );\nsay $a.perl;\nsay '------------------------------';"}]},{"type":"block","id":"9wBrLsQE2ceWugBtWmNL0","margin":"","level":1,"name":"head","location":{"start":{"line":80,"column":1,"offset":2568},"end":{"line":80,"column":14,"offset":2581}},"content":["DESCRIPTION"]},{"type":"para","id":"pv_qtAuXkn4LxHz1LBEYn","margin":"","location":{"start":{"line":82,"column":1,"offset":2583},"end":{"line":82,"column":69,"offset":2651}},"text":"text","content":["This is a generic module for interactive prompting from the console."]},{"type":"para","id":"1RlbvEEvrk7dmaCx62OSA","margin":"","location":{"start":{"line":84,"column":1,"offset":2653},"end":{"line":84,"column":134,"offset":2786}},"text":"text","content":["The build-in function prompt is great, but sometimes it is convenient to have default values and/or the control over the return type."]},{"type":"para","id":"k-TuCYO-2t9QPGbvAlwpo","margin":"","location":{"start":{"line":86,"column":1,"offset":2788},"end":{"line":86,"column":26,"offset":2813}},"text":"text","content":["IO::Prompt provides both."]},{"type":"para","id":"xZWJUEVBH41j2m0OWBQSc","margin":"","location":{"start":{"line":88,"column":1,"offset":2815},"end":{"line":88,"column":26,"offset":2840}},"text":"text","content":["Original written bei pnu."]},{"type":"block","id":"RyT1W-3522NcPpPVuIUBG","margin":"","level":2,"name":"head","location":{"start":{"line":90,"column":1,"offset":2842},"end":{"line":90,"column":22,"offset":2863}},"content":["FUNCTIONAL METHODS"]},{"type":"para","id":"S_itCnB3e7rq71ViahgAi","margin":"","location":{"start":{"line":92,"column":1,"offset":2865},"end":{"line":92,"column":98,"offset":2962}},"text":"text","content":["IO::Prompt provides method ask to set the question string, a default answer and/or a return type."]},{"type":"para","id":"PC0d2XlC5_kh55f3SiaW_","margin":"","location":{"start":{"line":94,"column":1,"offset":2964},"end":{"line":94,"column":10,"offset":2973}},"text":"text","content":["Examples:"]},{"type":"block","id":"lFHrQfZiEi9jts3WWDJ-Z","margin":"","name":"code","config":[],"location":{"start":{"line":96,"column":1,"offset":2975},"end":{"line":99,"column":86,"offset":3147}},"content":[{"type":"verbatim","value":"use IO::Prompt;\n\nmy $answer = ask(\"What do you want for Christmas?\", \"Perl6\");\n$answer = Whatever the user entered or if just Enter was pressed the string Perl6"}]},{"type":"block","id":"7Pp7yDlyX0iZGOyBb3q-v","margin":"","level":2,"name":"head","location":{"start":{"line":101,"column":1,"offset":3149},"end":{"line":101,"column":6,"offset":3154}},"content":["OO"]},{"type":"para","id":"IdvzKREUQ0S7K0pnfOrjQ","margin":"","location":{"start":{"line":103,"column":1,"offset":3156},"end":{"line":103,"column":41,"offset":3196}},"text":"text","content":["IO::Prompt provides also a OO interface."]},{"type":"para","id":"6-ZjxUevPmYdb-OtKZ-SX","margin":"","location":{"start":{"line":105,"column":1,"offset":3198},"end":{"line":105,"column":9,"offset":3206}},"text":"text","content":["Example:"]},{"type":"block","id":"r8VjqDXi9l3tVA7pVtdWq","margin":"","name":"code","config":[],"location":{"start":{"line":107,"column":1,"offset":3208},"end":{"line":110,"column":67,"offset":3327}},"content":[{"type":"verbatim","value":"use IO::Prompt;\n\nmy $asker = IO::Prompt.new;\nmy $answer = $asker.ask(\"Wanna some money?\", 2e9, :type(Num));"}]},{"type":"block","id":"AFRmOIVypM9EEVtSiV6cE","margin":"","level":1,"name":"head","location":{"start":{"line":112,"column":1,"offset":3329},"end":{"line":112,"column":12,"offset":3340}},"content":["COPYRIGHT"]},{"type":"para","id":"1TqzNqmJh-bMtL1GV6rlq","margin":"","location":{"start":{"line":114,"column":1,"offset":3342},"end":{"line":114,"column":37,"offset":3378}},"text":"text","content":["Written by pnu, maintained by wbiker"]}]},"publishUrl":"/mods/zef/IO::Prompt/dist/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"","auth":"zef:wbiker","authors":["pnu","wbiker"],"build-depends":[],"depends":[],"description":"This is a generic module for interactive prompting from the console.","dist":"IO::Prompt:ver<0.0.3>:auth<zef:wbiker>","license":"Artistic-2.0","name":"IO::Prompt","path":"I/O_/IO_PROMPT/ef587aec4aed2db06d9d8049a0398dbe022efd3a.tar.gz","perl":"6.*","provides":{"IO::Prompt":"lib/IO/Prompt.rakumod"},"resources":[],"source-url":"git://github.com/wbiker/io-prompt.git","tags":[],"test-depends":["Test"],"version":"0.0.3"},"files":[{"file":"work_mods/zef/IO::Prompt/dist/README.md","publishUrl":"/mods/zef/IO::Prompt/dist/README.md"},{"file":"work_mods/zef/IO::Prompt/dist/README.rakudoc","publishUrl":"/mods/zef/IO::Prompt/dist/README.rakudoc"},{"file":"work_mods/zef/IO::Prompt/dist/lib/IO/Prompt.rakudoc","publishUrl":"/mods/zef/IO::Prompt/dist/lib/IO/Prompt.rakudoc"}],"src":"zef","url":"/mods/zef/IO::Prompt"}}}
=end data


    =begin React :component<RenderItem>
    =begin data
    {"type":"page","file":"work_mods/zef/IO::Prompt/dist/README.md","sources":[],"node":{"type":"block","id":"orE_VYBNDQX2QMkI_YrBw","margin":"","name":"root","content":[{"type":"para","id":"SFJiP1DIJ3OchY0-ggQZh","margin":"","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":53,"offset":52}},"text":"text","content":["IO::Prompt -- Interactive validating terminal prompt"]},{"type":"block","id":"m6VkXOIn59O3p5WdtK5fX","margin":"","level":1,"name":"head","location":{"start":{"line":3,"column":1,"offset":54},"end":{"line":3,"column":7,"offset":60}},"content":["HTML"]},{"type":"para","id":"52DLIOwaZ7V_5gMZrwulD","margin":"","location":{"start":{"line":5,"column":1,"offset":62},"end":{"line":5,"column":122,"offset":183}},"text":"text","content":[{"type":"block","id":"6yzqO0PtGqIrDcAjCwRqU","margin":"","name":"Html","location":{"start":{"line":5,"column":1,"offset":62},"end":{"line":5,"column":50,"offset":111}},"content":[{"type":"verbatim","value":"<a href=\"https://travis-ci.org/wbiker/io-prompt\">"}]},{"type":"block","id":"jZqYLe6K78wUzzzJhW9FF","margin":"","name":"Html","location":{"start":{"line":5,"column":50,"offset":111},"end":{"line":5,"column":118,"offset":179}},"content":[{"type":"verbatim","value":"<img src=\"https://travis-ci.org/wbiker/io-prompt.svg?branch=master\">"}]},{"type":"block","id":"aQ_ajwhFz8KqvU-yUeZN1","margin":"","name":"Html","location":{"start":{"line":5,"column":118,"offset":179},"end":{"line":5,"column":122,"offset":183}},"content":[{"type":"verbatim","value":"</a>"}]}]},{"type":"block","id":"gZ7uTxK0eJSPmFjx75e56","margin":"","level":1,"name":"head","location":{"start":{"line":7,"column":1,"offset":185},"end":{"line":7,"column":11,"offset":195}},"content":["SYNOPSIS"]},{"type":"block","id":"j0mchqnhJmnsgcXE4tXoT","margin":"","name":"code","config":[],"location":{"start":{"line":9,"column":1,"offset":197},"end":{"line":78,"column":42,"offset":2566}},"content":[{"type":"verbatim","value":"use v6;\nuse IO::Prompt;\n\nmy $a = ask( \"Defaults to 42, type Num?\", 42, :type(Num) );\nsay $a.perl;\nsay '------------------------------';\n\n$a = ask( \"Defaults to false?\", Bool::False );\nsay $a.perl;\nsay '------------------------------';\n\n$a = ask( \"No default but type Bool?\", :type(Bool) );\nsay $a.perl;\nsay '------------------------------';\n\n\n## OO style ##\nmy $prompt = IO::Prompt.new();\n\n$a = $prompt.ask( \"Dot notation?\", Bool::False );\nsay $a.perl;\nsay '------------------------------';\n\n\n## You can override the IO methods for testing purposes\nclass IO::Prompt::Testable is IO::Prompt {\n    method !do_say( Str $question ) returns Bool {\n        say \"Testable saying    '$question'\";\n        say 'Please do not continue questioning';\n        return Bool::False; # do not continue\n    }\n    method !do_prompt( Str $question ) returns Str {\n        say \"Testable saying    '$question'\";\n        say \"Testable answering 'daa'\";\n        return 'daa';\n    }\n}\n\nmy $prompt_test = IO::Prompt::Testable.new();\n$a = $prompt_test.ask_yn( \"Testable, defaults to false?\", Bool::False );\nsay $a.perl;\nsay '------------------------------';\n\n\n## You can override the language class attributes\nclass IO::Prompt::Finnish is IO::Prompt {\n    our $.lang_prompt_Yn        = 'K/e';\n    our $.lang_prompt_yN        = 'k/E';\n    our $.lang_prompt_yn        = 'k/e';\n    our $.lang_prompt_yn_retry  = 'Sano kyllä tai ei';\n    our $.lang_prompt_match_y   = m/ ^^ <[kK]> /;\n    our $.lang_prompt_match_n   = m/ ^^ <[eE]> /;\n    our $.lang_prompt_int       = 'Int';\n    our $.lang_prompt_int_retry = 'Anna kokonaisluku';\n    our $.lang_prompt_num       = 'Num';\n    our $.lang_prompt_num_retry = 'Anna luku';\n    our $.lang_prompt_str       = 'Str';\n    our $.lang_prompt_str_retry = 'Anna merkkijono';\n}\n\nmy $prompt_fi = IO::Prompt::Finnish.new();\n$a = $prompt_fi.ask( \"Suomeksi Bool?\", :type(Bool) );\nsay $a.perl;\nsay '------------------------------';\n$a = $prompt_fi.ask( \"Suomeksi Num?\", :type(Num) );\nsay $a.perl;\nsay '------------------------------';\n$a = $prompt_fi.ask( \"Suomeksi Str?\", :type(Str) );\nsay $a.perl;\nsay '------------------------------';"}]},{"type":"block","id":"9wBrLsQE2ceWugBtWmNL0","margin":"","level":1,"name":"head","location":{"start":{"line":80,"column":1,"offset":2568},"end":{"line":80,"column":14,"offset":2581}},"content":["DESCRIPTION"]},{"type":"para","id":"pv_qtAuXkn4LxHz1LBEYn","margin":"","location":{"start":{"line":82,"column":1,"offset":2583},"end":{"line":82,"column":69,"offset":2651}},"text":"text","content":["This is a generic module for interactive prompting from the console."]},{"type":"para","id":"1RlbvEEvrk7dmaCx62OSA","margin":"","location":{"start":{"line":84,"column":1,"offset":2653},"end":{"line":84,"column":134,"offset":2786}},"text":"text","content":["The build-in function prompt is great, but sometimes it is convenient to have default values and/or the control over the return type."]},{"type":"para","id":"k-TuCYO-2t9QPGbvAlwpo","margin":"","location":{"start":{"line":86,"column":1,"offset":2788},"end":{"line":86,"column":26,"offset":2813}},"text":"text","content":["IO::Prompt provides both."]},{"type":"para","id":"xZWJUEVBH41j2m0OWBQSc","margin":"","location":{"start":{"line":88,"column":1,"offset":2815},"end":{"line":88,"column":26,"offset":2840}},"text":"text","content":["Original written bei pnu."]},{"type":"block","id":"RyT1W-3522NcPpPVuIUBG","margin":"","level":2,"name":"head","location":{"start":{"line":90,"column":1,"offset":2842},"end":{"line":90,"column":22,"offset":2863}},"content":["FUNCTIONAL METHODS"]},{"type":"para","id":"S_itCnB3e7rq71ViahgAi","margin":"","location":{"start":{"line":92,"column":1,"offset":2865},"end":{"line":92,"column":98,"offset":2962}},"text":"text","content":["IO::Prompt provides method ask to set the question string, a default answer and/or a return type."]},{"type":"para","id":"PC0d2XlC5_kh55f3SiaW_","margin":"","location":{"start":{"line":94,"column":1,"offset":2964},"end":{"line":94,"column":10,"offset":2973}},"text":"text","content":["Examples:"]},{"type":"block","id":"lFHrQfZiEi9jts3WWDJ-Z","margin":"","name":"code","config":[],"location":{"start":{"line":96,"column":1,"offset":2975},"end":{"line":99,"column":86,"offset":3147}},"content":[{"type":"verbatim","value":"use IO::Prompt;\n\nmy $answer = ask(\"What do you want for Christmas?\", \"Perl6\");\n$answer = Whatever the user entered or if just Enter was pressed the string Perl6"}]},{"type":"block","id":"7Pp7yDlyX0iZGOyBb3q-v","margin":"","level":2,"name":"head","location":{"start":{"line":101,"column":1,"offset":3149},"end":{"line":101,"column":6,"offset":3154}},"content":["OO"]},{"type":"para","id":"IdvzKREUQ0S7K0pnfOrjQ","margin":"","location":{"start":{"line":103,"column":1,"offset":3156},"end":{"line":103,"column":41,"offset":3196}},"text":"text","content":["IO::Prompt provides also a OO interface."]},{"type":"para","id":"6-ZjxUevPmYdb-OtKZ-SX","margin":"","location":{"start":{"line":105,"column":1,"offset":3198},"end":{"line":105,"column":9,"offset":3206}},"text":"text","content":["Example:"]},{"type":"block","id":"r8VjqDXi9l3tVA7pVtdWq","margin":"","name":"code","config":[],"location":{"start":{"line":107,"column":1,"offset":3208},"end":{"line":110,"column":67,"offset":3327}},"content":[{"type":"verbatim","value":"use IO::Prompt;\n\nmy $asker = IO::Prompt.new;\nmy $answer = $asker.ask(\"Wanna some money?\", 2e9, :type(Num));"}]},{"type":"block","id":"AFRmOIVypM9EEVtSiV6cE","margin":"","level":1,"name":"head","location":{"start":{"line":112,"column":1,"offset":3329},"end":{"line":112,"column":12,"offset":3340}},"content":["COPYRIGHT"]},{"type":"para","id":"1TqzNqmJh-bMtL1GV6rlq","margin":"","location":{"start":{"line":114,"column":1,"offset":3342},"end":{"line":114,"column":37,"offset":3378}},"text":"text","content":["Written by pnu, maintained by wbiker"]}]},"publishUrl":"/mods/zef/IO::Prompt/dist/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"","auth":"zef:wbiker","authors":["pnu","wbiker"],"build-depends":[],"depends":[],"description":"This is a generic module for interactive prompting from the console.","dist":"IO::Prompt:ver<0.0.3>:auth<zef:wbiker>","license":"Artistic-2.0","name":"IO::Prompt","path":"I/O_/IO_PROMPT/ef587aec4aed2db06d9d8049a0398dbe022efd3a.tar.gz","perl":"6.*","provides":{"IO::Prompt":"lib/IO/Prompt.rakumod"},"resources":[],"source-url":"git://github.com/wbiker/io-prompt.git","tags":[],"test-depends":["Test"],"version":"0.0.3"},"files":[{"file":"work_mods/zef/IO::Prompt/dist/README.md","publishUrl":"/mods/zef/IO::Prompt/dist/README.md"},{"file":"work_mods/zef/IO::Prompt/dist/README.rakudoc","publishUrl":"/mods/zef/IO::Prompt/dist/README.rakudoc"},{"file":"work_mods/zef/IO::Prompt/dist/lib/IO/Prompt.rakudoc","publishUrl":"/mods/zef/IO::Prompt/dist/lib/IO/Prompt.rakudoc"}],"src":"zef","url":"/mods/zef/IO::Prompt"}}}
    =end data
    =end React


IO::Prompt


=begin data
{"type":"page","file":"work_mods/zef/IO::Path::ChildSecure/IO-Path-ChildSecure-1.1/README.md","sources":[],"node":{"type":"block","id":"7iY9q3_HT--rYhhUQ0zQK","margin":"","name":"root","content":[{"type":"para","id":"vNsa3wS6Qcy-DCgm3ygcE","margin":"","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":191,"offset":190}},"text":"text","content":[{"meta":"https://github.com/raku-community-modules/IO-Path-ChildSecure/actions","type":"fcode","name":"L","content":[{"type":"block","id":"Tz7Mn1vRQZJuxwlnzSM4O","margin":"","name":"Image","config":[],"location":{"start":{"line":1,"column":2,"offset":1},"end":{"line":1,"column":119,"offset":118}},"content":[{"type":"image","src":"https://github.com/raku-community-modules/IO-Path-ChildSecure/actions/workflows/test.yml/badge.svg","alt":"Actions Status"}]}]}]},{"type":"block","id":"X3HqbCkuWO3F01Mhy1TgS","margin":"","level":1,"name":"head","location":{"start":{"line":3,"column":1,"offset":192},"end":{"line":3,"column":7,"offset":198}},"content":["NAME"]},{"type":"para","id":"r6m03_x60rsUvfG8o0S75","margin":"","location":{"start":{"line":5,"column":1,"offset":200},"end":{"line":5,"column":57,"offset":256}},"text":"text","content":["IO::Path::ChildSecure - Secure version of IO::Path.child"]},{"type":"block","id":"UVeD-pe3sGT1TrKGjahoq","margin":"","level":1,"name":"head","location":{"start":{"line":7,"column":1,"offset":258},"end":{"line":7,"column":11,"offset":268}},"content":["SYNOPSIS"]},{"type":"block","id":"rZdVYbFOotG27u6QM30Lu","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":9,"column":1,"offset":270},"end":{"line":20,"column":4,"offset":559}},"content":[{"type":"verbatim","value":"use IO::Path::ChildSecure;\n\n# good; you get IO::Path\n\"foo\".IO.&child-secure: 'meow';\n\n# still good if 'foo/meow/foo/bar/../' exists; Failure if it doesn't\n\"foo\".IO.&child-secure: 'meow/foo/bar/../meow';\n\n# bad; path isn't a child; you get Failure\n\"foo\".IO.&child-secure: '../';"}]},{"type":"block","id":"7GJD1WRDMjuG2OyYKlmrp","margin":"","level":1,"name":"head","location":{"start":{"line":22,"column":1,"offset":561},"end":{"line":22,"column":14,"offset":574}},"content":["DESCRIPTION"]},{"type":"para","id":"MDsgQ2u2E0TPXK1EvZg5c","margin":"","location":{"start":{"line":24,"column":1,"offset":576},"end":{"line":24,"column":222,"offset":797}},"text":"text","content":["In the Raku Programming Language, ",{"meta":"https://docs.raku.org/type/IO::Path#method_child","type":"fcode","name":"L","content":["IO::Path.child"]}," isn't secure, in a sense that it does no checks for whether the resultant path is actually a child of the original path."]},{"type":"para","id":"1Wg_xPwd3vuq9okjjUGeZ","margin":"","location":{"start":{"line":26,"column":1,"offset":799},"end":{"line":26,"column":149,"offset":947}},"text":"text","content":["This module provides a subroutine that can be used as an alternative that ",{"type":"fcode","name":"B","content":["will"]}," check whether the resultant path is a child of the original path."]},{"type":"block","id":"bJf2mXGjER7HMBNHF3_e0","margin":"","level":1,"name":"head","location":{"start":{"line":28,"column":1,"offset":949},"end":{"line":28,"column":23,"offset":971}},"content":["EXPORTED SUBROUTINES"]},{"type":"block","id":"NMGvGkMITiXJu-K7ZJ5JL","margin":"","level":2,"name":"head","location":{"start":{"line":30,"column":1,"offset":973},"end":{"line":30,"column":16,"offset":988}},"content":["child-secure"]},{"type":"block","id":"jsop2m5lVcdLWg9IQRz2p","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":32,"column":1,"offset":990},"end":{"line":38,"column":4,"offset":1257}},"content":[{"type":"verbatim","value":"\"foo\".IO.&child-secure: 'meow'; # good; you get IO::Path\n\"foo\".IO.&child-secure: 'meow/foo/bar/../meow'; # still good\n\"foo\".IO.&child-secure: '../';  # bad; path isn't a child; you get Failure\n\nchild-secure \"foo\".IO, '../';  # can also use as a proper sub"}]},{"type":"para","id":"Rb9ECILe2HhCJMeP7E2XE","margin":"","location":{"start":{"line":40,"column":1,"offset":1259},"end":{"line":40,"column":263,"offset":1521}},"text":"text","content":["Appends the given path chunk to the invocant and ensures the resultant path is, in fact, a child of the invocant, by accessing the filesystem and fully-resolving the path. The last chunk of the resultant path does not have to exist for the resolution to succeed."]},{"type":"para","id":"O_5DoFybl6pWX3J7uk2RG","margin":"","location":{"start":{"line":42,"column":1,"offset":1523},"end":{"line":42,"column":197,"offset":1719}},"text":"text","content":["Will ",{"meta":"https://docs.raku.org/routine/fail","type":"fcode","name":"L","content":["fail"]}," with ",{"type":"fcode","name":"C","content":["X::IO::Resolve"]}," if failed to fully resolve the resultant path or with ",{"type":"fcode","name":"C","content":["X::IO::NotAChild"]}," if the resultant path is not a child of the invocant."]},{"type":"block","id":"Qk3H82P4a8z21xVPukokj","margin":"","level":1,"name":"head","location":{"start":{"line":44,"column":1,"offset":1721},"end":{"line":44,"column":16,"offset":1736}},"content":["SPECIAL NOTES"]},{"type":"para","id":"bs8UDHiPvLJeOldzYqfwo","margin":"","location":{"start":{"line":46,"column":1,"offset":1738},"end":{"line":46,"column":137,"offset":1874}},"text":"text","content":["If you don't need to ensure secureness, use the much-faster core ",{"meta":"https://docs.raku.org/type/IO::Path#method_add","type":"fcode","name":"L","content":[{"type":"fcode","name":"C","content":["IO::Path.add"]}," method"]}]},{"type":"block","id":"CGU3wp2Wg9S-qI3zps6QF","margin":"","level":1,"name":"head","location":{"start":{"line":48,"column":1,"offset":1876},"end":{"line":48,"column":9,"offset":1884}},"content":["AUTHOR"]},{"type":"para","id":"Wugs-Z8iPVYyC14X4xkEs","margin":"","location":{"start":{"line":50,"column":1,"offset":1886},"end":{"line":50,"column":12,"offset":1897}},"text":"text","content":["Zoffix Znet"]},{"type":"block","id":"zC88jpabsQnzYztRQmzdb","margin":"","level":1,"name":"head","location":{"start":{"line":52,"column":1,"offset":1899},"end":{"line":52,"column":24,"offset":1922}},"content":["COPYRIGHT AND LICENSE"]},{"type":"para","id":"KCGCDvWil9aqLCJU2x6cR","margin":"","location":{"start":{"line":54,"column":1,"offset":1924},"end":{"line":54,"column":32,"offset":1955}},"text":"text","content":["Copyright 2017-2018 Zoffix Znet"]},{"type":"para","id":"bINJUL2i3wwuLgHan-s4m","margin":"","location":{"start":{"line":56,"column":1,"offset":1957},"end":{"line":56,"column":35,"offset":1991}},"text":"text","content":["Copyright 2019-2022 Raku Community"]},{"type":"para","id":"5ykvM8EyhEBz3ReqVYQK4","margin":"","location":{"start":{"line":58,"column":1,"offset":1993},"end":{"line":58,"column":104,"offset":2096}},"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/IO::Path::ChildSecure/IO-Path-ChildSecure-1.1/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"","auth":"zef:raku-community-modules","authors":["Zoffix Znet"],"build-depends":[],"depends":[],"description":"Secure version of IO::Path.child","dist":"IO::Path::ChildSecure:ver<1.1>:auth<zef:raku-community-modules>","license":"Artistic-2.0","name":"IO::Path::ChildSecure","path":"I/O_/IO_PATH_CHILDSECURE/e4b1c51719abc21da843fc35152b0fdae1f8af8e.tar.gz","perl":"6.c","provides":{"IO::Path::ChildSecure":"lib/IO/Path/ChildSecure.rakumod"},"resources":[],"source-url":"https://github.com/raku-community-modules/IO-Path-ChildSecure.git","tags":["file","file system"],"test-depends":["Test"],"version":"1.1"},"files":[{"file":"work_mods/zef/IO::Path::ChildSecure/IO-Path-ChildSecure-1.1/README.md","publishUrl":"/mods/zef/IO::Path::ChildSecure/IO-Path-ChildSecure-1.1/README.md"},{"file":"work_mods/zef/IO::Path::ChildSecure/IO-Path-ChildSecure-1.1/lib/IO/Path/ChildSecure.rakumod","publishUrl":"/mods/zef/IO::Path::ChildSecure/IO-Path-ChildSecure-1.1/lib/IO/Path/ChildSecure.rakumod"}],"src":"zef","url":"/mods/zef/IO::Path::ChildSecure"}}}
=end data


    =begin React :component<RenderItem>
    =begin data
    {"type":"page","file":"work_mods/zef/IO::Path::ChildSecure/IO-Path-ChildSecure-1.1/README.md","sources":[],"node":{"type":"block","id":"7iY9q3_HT--rYhhUQ0zQK","margin":"","name":"root","content":[{"type":"para","id":"vNsa3wS6Qcy-DCgm3ygcE","margin":"","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":191,"offset":190}},"text":"text","content":[{"meta":"https://github.com/raku-community-modules/IO-Path-ChildSecure/actions","type":"fcode","name":"L","content":[{"type":"block","id":"Tz7Mn1vRQZJuxwlnzSM4O","margin":"","name":"Image","config":[],"location":{"start":{"line":1,"column":2,"offset":1},"end":{"line":1,"column":119,"offset":118}},"content":[{"type":"image","src":"https://github.com/raku-community-modules/IO-Path-ChildSecure/actions/workflows/test.yml/badge.svg","alt":"Actions Status"}]}]}]},{"type":"block","id":"X3HqbCkuWO3F01Mhy1TgS","margin":"","level":1,"name":"head","location":{"start":{"line":3,"column":1,"offset":192},"end":{"line":3,"column":7,"offset":198}},"content":["NAME"]},{"type":"para","id":"r6m03_x60rsUvfG8o0S75","margin":"","location":{"start":{"line":5,"column":1,"offset":200},"end":{"line":5,"column":57,"offset":256}},"text":"text","content":["IO::Path::ChildSecure - Secure version of IO::Path.child"]},{"type":"block","id":"UVeD-pe3sGT1TrKGjahoq","margin":"","level":1,"name":"head","location":{"start":{"line":7,"column":1,"offset":258},"end":{"line":7,"column":11,"offset":268}},"content":["SYNOPSIS"]},{"type":"block","id":"rZdVYbFOotG27u6QM30Lu","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":9,"column":1,"offset":270},"end":{"line":20,"column":4,"offset":559}},"content":[{"type":"verbatim","value":"use IO::Path::ChildSecure;\n\n# good; you get IO::Path\n\"foo\".IO.&child-secure: 'meow';\n\n# still good if 'foo/meow/foo/bar/../' exists; Failure if it doesn't\n\"foo\".IO.&child-secure: 'meow/foo/bar/../meow';\n\n# bad; path isn't a child; you get Failure\n\"foo\".IO.&child-secure: '../';"}]},{"type":"block","id":"7GJD1WRDMjuG2OyYKlmrp","margin":"","level":1,"name":"head","location":{"start":{"line":22,"column":1,"offset":561},"end":{"line":22,"column":14,"offset":574}},"content":["DESCRIPTION"]},{"type":"para","id":"MDsgQ2u2E0TPXK1EvZg5c","margin":"","location":{"start":{"line":24,"column":1,"offset":576},"end":{"line":24,"column":222,"offset":797}},"text":"text","content":["In the Raku Programming Language, ",{"meta":"https://docs.raku.org/type/IO::Path#method_child","type":"fcode","name":"L","content":["IO::Path.child"]}," isn't secure, in a sense that it does no checks for whether the resultant path is actually a child of the original path."]},{"type":"para","id":"1Wg_xPwd3vuq9okjjUGeZ","margin":"","location":{"start":{"line":26,"column":1,"offset":799},"end":{"line":26,"column":149,"offset":947}},"text":"text","content":["This module provides a subroutine that can be used as an alternative that ",{"type":"fcode","name":"B","content":["will"]}," check whether the resultant path is a child of the original path."]},{"type":"block","id":"bJf2mXGjER7HMBNHF3_e0","margin":"","level":1,"name":"head","location":{"start":{"line":28,"column":1,"offset":949},"end":{"line":28,"column":23,"offset":971}},"content":["EXPORTED SUBROUTINES"]},{"type":"block","id":"NMGvGkMITiXJu-K7ZJ5JL","margin":"","level":2,"name":"head","location":{"start":{"line":30,"column":1,"offset":973},"end":{"line":30,"column":16,"offset":988}},"content":["child-secure"]},{"type":"block","id":"jsop2m5lVcdLWg9IQRz2p","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":32,"column":1,"offset":990},"end":{"line":38,"column":4,"offset":1257}},"content":[{"type":"verbatim","value":"\"foo\".IO.&child-secure: 'meow'; # good; you get IO::Path\n\"foo\".IO.&child-secure: 'meow/foo/bar/../meow'; # still good\n\"foo\".IO.&child-secure: '../';  # bad; path isn't a child; you get Failure\n\nchild-secure \"foo\".IO, '../';  # can also use as a proper sub"}]},{"type":"para","id":"Rb9ECILe2HhCJMeP7E2XE","margin":"","location":{"start":{"line":40,"column":1,"offset":1259},"end":{"line":40,"column":263,"offset":1521}},"text":"text","content":["Appends the given path chunk to the invocant and ensures the resultant path is, in fact, a child of the invocant, by accessing the filesystem and fully-resolving the path. The last chunk of the resultant path does not have to exist for the resolution to succeed."]},{"type":"para","id":"O_5DoFybl6pWX3J7uk2RG","margin":"","location":{"start":{"line":42,"column":1,"offset":1523},"end":{"line":42,"column":197,"offset":1719}},"text":"text","content":["Will ",{"meta":"https://docs.raku.org/routine/fail","type":"fcode","name":"L","content":["fail"]}," with ",{"type":"fcode","name":"C","content":["X::IO::Resolve"]}," if failed to fully resolve the resultant path or with ",{"type":"fcode","name":"C","content":["X::IO::NotAChild"]}," if the resultant path is not a child of the invocant."]},{"type":"block","id":"Qk3H82P4a8z21xVPukokj","margin":"","level":1,"name":"head","location":{"start":{"line":44,"column":1,"offset":1721},"end":{"line":44,"column":16,"offset":1736}},"content":["SPECIAL NOTES"]},{"type":"para","id":"bs8UDHiPvLJeOldzYqfwo","margin":"","location":{"start":{"line":46,"column":1,"offset":1738},"end":{"line":46,"column":137,"offset":1874}},"text":"text","content":["If you don't need to ensure secureness, use the much-faster core ",{"meta":"https://docs.raku.org/type/IO::Path#method_add","type":"fcode","name":"L","content":[{"type":"fcode","name":"C","content":["IO::Path.add"]}," method"]}]},{"type":"block","id":"CGU3wp2Wg9S-qI3zps6QF","margin":"","level":1,"name":"head","location":{"start":{"line":48,"column":1,"offset":1876},"end":{"line":48,"column":9,"offset":1884}},"content":["AUTHOR"]},{"type":"para","id":"Wugs-Z8iPVYyC14X4xkEs","margin":"","location":{"start":{"line":50,"column":1,"offset":1886},"end":{"line":50,"column":12,"offset":1897}},"text":"text","content":["Zoffix Znet"]},{"type":"block","id":"zC88jpabsQnzYztRQmzdb","margin":"","level":1,"name":"head","location":{"start":{"line":52,"column":1,"offset":1899},"end":{"line":52,"column":24,"offset":1922}},"content":["COPYRIGHT AND LICENSE"]},{"type":"para","id":"KCGCDvWil9aqLCJU2x6cR","margin":"","location":{"start":{"line":54,"column":1,"offset":1924},"end":{"line":54,"column":32,"offset":1955}},"text":"text","content":["Copyright 2017-2018 Zoffix Znet"]},{"type":"para","id":"bINJUL2i3wwuLgHan-s4m","margin":"","location":{"start":{"line":56,"column":1,"offset":1957},"end":{"line":56,"column":35,"offset":1991}},"text":"text","content":["Copyright 2019-2022 Raku Community"]},{"type":"para","id":"5ykvM8EyhEBz3ReqVYQK4","margin":"","location":{"start":{"line":58,"column":1,"offset":1993},"end":{"line":58,"column":104,"offset":2096}},"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/IO::Path::ChildSecure/IO-Path-ChildSecure-1.1/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"","auth":"zef:raku-community-modules","authors":["Zoffix Znet"],"build-depends":[],"depends":[],"description":"Secure version of IO::Path.child","dist":"IO::Path::ChildSecure:ver<1.1>:auth<zef:raku-community-modules>","license":"Artistic-2.0","name":"IO::Path::ChildSecure","path":"I/O_/IO_PATH_CHILDSECURE/e4b1c51719abc21da843fc35152b0fdae1f8af8e.tar.gz","perl":"6.c","provides":{"IO::Path::ChildSecure":"lib/IO/Path/ChildSecure.rakumod"},"resources":[],"source-url":"https://github.com/raku-community-modules/IO-Path-ChildSecure.git","tags":["file","file system"],"test-depends":["Test"],"version":"1.1"},"files":[{"file":"work_mods/zef/IO::Path::ChildSecure/IO-Path-ChildSecure-1.1/README.md","publishUrl":"/mods/zef/IO::Path::ChildSecure/IO-Path-ChildSecure-1.1/README.md"},{"file":"work_mods/zef/IO::Path::ChildSecure/IO-Path-ChildSecure-1.1/lib/IO/Path/ChildSecure.rakumod","publishUrl":"/mods/zef/IO::Path::ChildSecure/IO-Path-ChildSecure-1.1/lib/IO/Path/ChildSecure.rakumod"}],"src":"zef","url":"/mods/zef/IO::Path::ChildSecure"}}}
    =end data
    =end React


Secure version of IO::Path.child


IO::Path::ChildSecure


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::Path::Mode

IO::Path::Mode

image https://github.com/jonathanstowe/IO-Path-Mode/workflows/CI/badge.svg not found

Synopsis

Description

Installation

Support

Licence

IO::Path::Mode v0.0.9

Authors

License

Dependencies

Test Dependencies

Provides

Documentation