TITLE

SUBTITLE

data

=begin data
{"type":"page","file":"work_mods/zef/Trait::IO/Trait-IO-1.1/README.md","sources":[],"node":{"type":"block","id":"Ltj-cMGCirF2yBc9NDNqn","margin":"","name":"root","content":[{"type":"para","id":"Hxf7RuqY6Ee-MMPYGF0xW","margin":"","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":169,"offset":168}},"text":"text","content":[{"meta":"https://github.com/raku-community-modules/Trait-IO/actions","type":"fcode","name":"L","content":[{"type":"block","id":"UwXMCW1j7AN1k-S5kRWH4","margin":"","name":"Image","config":[],"location":{"start":{"line":1,"column":2,"offset":1},"end":{"line":1,"column":108,"offset":107}},"content":[{"type":"image","src":"https://github.com/raku-community-modules/Trait-IO/actions/workflows/test.yml/badge.svg","alt":"Actions Status"}]}]}]},{"type":"block","id":"kCldxKdG_ipKsCDclsc1s","margin":"","level":1,"name":"head","location":{"start":{"line":3,"column":1,"offset":170},"end":{"line":4,"column":5,"offset":179}},"content":["NAME"]},{"type":"para","id":"Z5e9zhXGGrQxOv4C4SM-r","margin":"","location":{"start":{"line":6,"column":1,"offset":181},"end":{"line":6,"column":29,"offset":209}},"text":"text","content":["Trait::IO - Helper IO traits"]},{"type":"block","id":"OKuT92ieoKQUxxYRdP-Mj","margin":"","level":1,"name":"head","location":{"start":{"line":8,"column":1,"offset":211},"end":{"line":9,"column":9,"offset":228}},"content":["SYNOPSIS"]},{"type":"block","id":"xTGMRPsy24wZsWyYFFko1","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":11,"column":1,"offset":230},"end":{"line":23,"column":4,"offset":497}},"content":[{"type":"verbatim","value":"use Trait::IO;\n\nfor <a b c> {\n    my $fh does auto-close = .IO.open: :w;\n    # ... do things with the file handle\n    # $fh is auto-closed on block leave\n}\n\n# Top-level is OK too; will close on scope leave\nmy $fh does auto-close = \"foo\".IO.open: :w;\n# ..."}]},{"type":"block","id":"cJgzPgrWDWdmNT7btmqyH","margin":"","level":1,"name":"head","location":{"start":{"line":25,"column":1,"offset":499},"end":{"line":26,"column":12,"offset":522}},"content":["DESCRIPTION"]},{"type":"para","id":"mcQYZm_fOZgECteoYO9ZK","margin":"","location":{"start":{"line":28,"column":1,"offset":524},"end":{"line":28,"column":40,"offset":563}},"text":"text","content":["Useful traits for working with Raku IO."]},{"type":"block","id":"YETZvMsKGlx-AigXjKhQA","margin":"","level":1,"name":"head","location":{"start":{"line":30,"column":1,"offset":565},"end":{"line":31,"column":8,"offset":580}},"content":["EXPORTS"]},{"type":"para","id":"jUCY151069R_Y_14JW2oz","margin":"","location":{"start":{"line":33,"column":1,"offset":582},"end":{"line":33,"column":23,"offset":604}},"text":"text","content":["-head2 does auto-close"]},{"type":"block","id":"oFlJo5H0stCKUGMGdi2y9","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":35,"column":1,"offset":606},"end":{"line":37,"column":4,"offset":661}},"content":[{"type":"verbatim","value":"my $fh does auto-close = \"foo\".IO.open: :w;"}]},{"type":"para","id":"fuu4aaimdaeTPWjASJjln","margin":"","location":{"start":{"line":39,"column":1,"offset":663},"end":{"line":39,"column":85,"offset":747}},"text":"text","content":["Installs a ",{"type":"fcode","name":"C","content":["LEAVE"]}," phaser to automatically close the file handle when scope is left."]},{"type":"para","id":"F2WWTnPfPzfn2nhWbqbSX","margin":"","location":{"start":{"line":41,"column":1,"offset":749},"end":{"line":41,"column":95,"offset":843}},"text":"text","content":["Exports the ",{"type":"block","id":"eNDsv-cYdELWRx-vl7kpW","margin":"","name":"Html","location":{"start":{"line":41,"column":13,"offset":761},"end":{"line":41,"column":25,"offset":773}},"content":[{"type":"verbatim","value":"<auto-close>"}]}," constant and the ",{"type":"fcode","name":"C","content":["trait_mod:<does>"]}," multi that accepts it as a value."]},{"type":"para","id":"jPkcfzLNnWEzw54l4g5MU","margin":"","location":{"start":{"line":43,"column":1,"offset":845},"end":{"line":43,"column":92,"offset":936}},"text":"text","content":["Currently works only with variables and not with attributes or parameters. Patches welcome."]},{"type":"block","id":"cbtaDGVK-UUoyIsEr4SLC","margin":"","level":1,"name":"head","location":{"start":{"line":45,"column":1,"offset":938},"end":{"line":46,"column":7,"offset":951}},"content":["AUTHOR"]},{"type":"para","id":"pfEwt-BG_3f8cNLYjcW05","margin":"","location":{"start":{"line":48,"column":1,"offset":953},"end":{"line":48,"column":12,"offset":964}},"text":"text","content":["Zoffix Znet"]},{"type":"block","id":"ENTQqeG5tCHRY6JuqX8Gj","margin":"","level":1,"name":"head","location":{"start":{"line":50,"column":1,"offset":966},"end":{"line":51,"column":22,"offset":1009}},"content":["COPYRIGHT AND LICENSE"]},{"type":"para","id":"1jGwEkohRJa8wcguKRqPs","margin":"","location":{"start":{"line":53,"column":1,"offset":1011},"end":{"line":53,"column":34,"offset":1044}},"text":"text","content":["Copyright 2017 - 2018 Zoffix Znet"]},{"type":"para","id":"lbs-8qDeLOF80T6AEmNIK","margin":"","location":{"start":{"line":55,"column":1,"offset":1046},"end":{"line":55,"column":37,"offset":1082}},"text":"text","content":["Copyright 2019 - 2022 Raku Community"]},{"type":"para","id":"3g0JS4q1lcoKtV8PmrMxJ","margin":"","location":{"start":{"line":57,"column":1,"offset":1084},"end":{"line":57,"column":104,"offset":1187}},"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/Trait::IO/Trait-IO-1.1/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"","auth":"zef:raku-community-modules","authors":["Zoffix Znet"],"build-depends":[],"depends":[],"description":"Helper IO traits","dist":"Trait::IO:ver<1.1>:auth<zef:raku-community-modules>","license":"Artistic-2.0","name":"Trait::IO","path":"T/RA/TRAIT_IO/632e113f88ee647b6ed5368271c0a4f80031fb3a.tar.gz","perl":"6.c","provides":{"Trait::IO":"lib/Trait/IO.rakumod"},"resources":[],"source-url":"git://github.com/raku-community-modules/Trait-IO.git","tags":["IO"],"test-depends":[],"version":"1.1"},"files":[{"file":"work_mods/zef/Trait::IO/Trait-IO-1.1/README.md","publishUrl":"/mods/zef/Trait::IO/Trait-IO-1.1/README.md"},{"file":"work_mods/zef/Trait::IO/Trait-IO-1.1/lib/Trait/IO.rakumod","publishUrl":"/mods/zef/Trait::IO/Trait-IO-1.1/lib/Trait/IO.rakumod"}],"src":"zef","url":"/mods/zef/Trait::IO"}}}
=end data


React

    =begin React :component<RenderItem>
    =begin data
    {"type":"page","file":"work_mods/zef/Trait::IO/Trait-IO-1.1/README.md","sources":[],"node":{"type":"block","id":"Ltj-cMGCirF2yBc9NDNqn","margin":"","name":"root","content":[{"type":"para","id":"Hxf7RuqY6Ee-MMPYGF0xW","margin":"","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":169,"offset":168}},"text":"text","content":[{"meta":"https://github.com/raku-community-modules/Trait-IO/actions","type":"fcode","name":"L","content":[{"type":"block","id":"UwXMCW1j7AN1k-S5kRWH4","margin":"","name":"Image","config":[],"location":{"start":{"line":1,"column":2,"offset":1},"end":{"line":1,"column":108,"offset":107}},"content":[{"type":"image","src":"https://github.com/raku-community-modules/Trait-IO/actions/workflows/test.yml/badge.svg","alt":"Actions Status"}]}]}]},{"type":"block","id":"kCldxKdG_ipKsCDclsc1s","margin":"","level":1,"name":"head","location":{"start":{"line":3,"column":1,"offset":170},"end":{"line":4,"column":5,"offset":179}},"content":["NAME"]},{"type":"para","id":"Z5e9zhXGGrQxOv4C4SM-r","margin":"","location":{"start":{"line":6,"column":1,"offset":181},"end":{"line":6,"column":29,"offset":209}},"text":"text","content":["Trait::IO - Helper IO traits"]},{"type":"block","id":"OKuT92ieoKQUxxYRdP-Mj","margin":"","level":1,"name":"head","location":{"start":{"line":8,"column":1,"offset":211},"end":{"line":9,"column":9,"offset":228}},"content":["SYNOPSIS"]},{"type":"block","id":"xTGMRPsy24wZsWyYFFko1","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":11,"column":1,"offset":230},"end":{"line":23,"column":4,"offset":497}},"content":[{"type":"verbatim","value":"use Trait::IO;\n\nfor <a b c> {\n    my $fh does auto-close = .IO.open: :w;\n    # ... do things with the file handle\n    # $fh is auto-closed on block leave\n}\n\n# Top-level is OK too; will close on scope leave\nmy $fh does auto-close = \"foo\".IO.open: :w;\n# ..."}]},{"type":"block","id":"cJgzPgrWDWdmNT7btmqyH","margin":"","level":1,"name":"head","location":{"start":{"line":25,"column":1,"offset":499},"end":{"line":26,"column":12,"offset":522}},"content":["DESCRIPTION"]},{"type":"para","id":"mcQYZm_fOZgECteoYO9ZK","margin":"","location":{"start":{"line":28,"column":1,"offset":524},"end":{"line":28,"column":40,"offset":563}},"text":"text","content":["Useful traits for working with Raku IO."]},{"type":"block","id":"YETZvMsKGlx-AigXjKhQA","margin":"","level":1,"name":"head","location":{"start":{"line":30,"column":1,"offset":565},"end":{"line":31,"column":8,"offset":580}},"content":["EXPORTS"]},{"type":"para","id":"jUCY151069R_Y_14JW2oz","margin":"","location":{"start":{"line":33,"column":1,"offset":582},"end":{"line":33,"column":23,"offset":604}},"text":"text","content":["-head2 does auto-close"]},{"type":"block","id":"oFlJo5H0stCKUGMGdi2y9","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":35,"column":1,"offset":606},"end":{"line":37,"column":4,"offset":661}},"content":[{"type":"verbatim","value":"my $fh does auto-close = \"foo\".IO.open: :w;"}]},{"type":"para","id":"fuu4aaimdaeTPWjASJjln","margin":"","location":{"start":{"line":39,"column":1,"offset":663},"end":{"line":39,"column":85,"offset":747}},"text":"text","content":["Installs a ",{"type":"fcode","name":"C","content":["LEAVE"]}," phaser to automatically close the file handle when scope is left."]},{"type":"para","id":"F2WWTnPfPzfn2nhWbqbSX","margin":"","location":{"start":{"line":41,"column":1,"offset":749},"end":{"line":41,"column":95,"offset":843}},"text":"text","content":["Exports the ",{"type":"block","id":"eNDsv-cYdELWRx-vl7kpW","margin":"","name":"Html","location":{"start":{"line":41,"column":13,"offset":761},"end":{"line":41,"column":25,"offset":773}},"content":[{"type":"verbatim","value":"<auto-close>"}]}," constant and the ",{"type":"fcode","name":"C","content":["trait_mod:<does>"]}," multi that accepts it as a value."]},{"type":"para","id":"jPkcfzLNnWEzw54l4g5MU","margin":"","location":{"start":{"line":43,"column":1,"offset":845},"end":{"line":43,"column":92,"offset":936}},"text":"text","content":["Currently works only with variables and not with attributes or parameters. Patches welcome."]},{"type":"block","id":"cbtaDGVK-UUoyIsEr4SLC","margin":"","level":1,"name":"head","location":{"start":{"line":45,"column":1,"offset":938},"end":{"line":46,"column":7,"offset":951}},"content":["AUTHOR"]},{"type":"para","id":"pfEwt-BG_3f8cNLYjcW05","margin":"","location":{"start":{"line":48,"column":1,"offset":953},"end":{"line":48,"column":12,"offset":964}},"text":"text","content":["Zoffix Znet"]},{"type":"block","id":"ENTQqeG5tCHRY6JuqX8Gj","margin":"","level":1,"name":"head","location":{"start":{"line":50,"column":1,"offset":966},"end":{"line":51,"column":22,"offset":1009}},"content":["COPYRIGHT AND LICENSE"]},{"type":"para","id":"1jGwEkohRJa8wcguKRqPs","margin":"","location":{"start":{"line":53,"column":1,"offset":1011},"end":{"line":53,"column":34,"offset":1044}},"text":"text","content":["Copyright 2017 - 2018 Zoffix Znet"]},{"type":"para","id":"lbs-8qDeLOF80T6AEmNIK","margin":"","location":{"start":{"line":55,"column":1,"offset":1046},"end":{"line":55,"column":37,"offset":1082}},"text":"text","content":["Copyright 2019 - 2022 Raku Community"]},{"type":"para","id":"3g0JS4q1lcoKtV8PmrMxJ","margin":"","location":{"start":{"line":57,"column":1,"offset":1084},"end":{"line":57,"column":104,"offset":1187}},"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/Trait::IO/Trait-IO-1.1/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"","auth":"zef:raku-community-modules","authors":["Zoffix Znet"],"build-depends":[],"depends":[],"description":"Helper IO traits","dist":"Trait::IO:ver<1.1>:auth<zef:raku-community-modules>","license":"Artistic-2.0","name":"Trait::IO","path":"T/RA/TRAIT_IO/632e113f88ee647b6ed5368271c0a4f80031fb3a.tar.gz","perl":"6.c","provides":{"Trait::IO":"lib/Trait/IO.rakumod"},"resources":[],"source-url":"git://github.com/raku-community-modules/Trait-IO.git","tags":["IO"],"test-depends":[],"version":"1.1"},"files":[{"file":"work_mods/zef/Trait::IO/Trait-IO-1.1/README.md","publishUrl":"/mods/zef/Trait::IO/Trait-IO-1.1/README.md"},{"file":"work_mods/zef/Trait::IO/Trait-IO-1.1/lib/Trait/IO.rakumod","publishUrl":"/mods/zef/Trait::IO/Trait-IO-1.1/lib/Trait/IO.rakumod"}],"src":"zef","url":"/mods/zef/Trait::IO"}}}
    =end data
    =end React


root

Helper IO traits


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

Trait::IO


=begin data
{"type":"page","file":"work_mods/zef/Trap/Trap-0.0.1/README.md","sources":[],"node":{"type":"block","id":"S85wIU1X-xvziTK3c6iO8","margin":"","name":"root","content":[{"type":"para","id":"2UhF_jUSvHNGA8Kmcmesv","margin":"","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":129,"offset":128}},"text":"text","content":[{"meta":"https://github.com/lizmat/Trap/actions","type":"fcode","name":"L","content":[{"type":"block","id":"S9k1v0QcetWkvX5Ra7c4J","margin":"","name":"Image","config":[],"location":{"start":{"line":1,"column":2,"offset":1},"end":{"line":1,"column":88,"offset":87}},"content":[{"type":"image","src":"https://github.com/lizmat/Trap/actions/workflows/test.yml/badge.svg","alt":"Actions Status"}]}]}]},{"type":"block","id":"xqlcBK-5aRAwsdssH-6GU","margin":"","level":1,"name":"head","location":{"start":{"line":3,"column":1,"offset":130},"end":{"line":4,"column":5,"offset":139}},"content":["NAME"]},{"type":"para","id":"8nyXjm0FoJXG1QEKM5a4V","margin":"","location":{"start":{"line":6,"column":1,"offset":141},"end":{"line":6,"column":38,"offset":178}},"text":"text","content":["Trap - Trap ",{"type":"fcode","name":"F","content":[{"type":"text","value":"*OUT and/or "}]},"*ERR output"]},{"type":"block","id":"FArRZ7qFAikfluy6Doj8J","margin":"","level":1,"name":"head","location":{"start":{"line":8,"column":1,"offset":180},"end":{"line":9,"column":9,"offset":197}},"content":["SYNOPSIS"]},{"type":"block","id":"HHkB_efn3GoMhqkexbQfj","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":11,"column":1,"offset":199},"end":{"line":44,"column":4,"offset":893}},"content":[{"type":"verbatim","value":"use Trap;\n\nmy $out;\nmy $err;\n{   # separate capturing\n    $out = Trap(my $*OUT);\n    $err = Trap(my $*ERR);\n    say \"Hello world!\";\n    note \"Goodbye!\"\n}\nprint \"STDOUT: $out.text()\";  # SDDOUT: Hello world!␤\nprint \"STDERR: $err.text()\";  # STDERR: Goodbye!␤\n\nmy $merged;\n{   # merged capturing\n    $merged = Trap(my $*OUT, my $*ERR);\n    say \"Hello world!\";\n    note \"Goodbye!\"\n}\nprint $merged.text;  # Hello world!␤Goodbye!␤\n\nmy $new;\n{   # creating the object manually\n    $new = my $*OUT = Trap.new;\n    say \"Hello world!\";\n}\nprint \"with object: $new.text()\";  # with object: Hello world!␤\n\n{   # ignoring any output\n    Trap(my $*OUT, my $*ERR);\n    say \"shall never be seen\";\n}"}]},{"type":"block","id":"RLGaxhLQE789OexbaNABs","margin":"","level":1,"name":"head","location":{"start":{"line":46,"column":1,"offset":895},"end":{"line":47,"column":12,"offset":918}},"content":["DESCRIPTION"]},{"type":"para","id":"gadgxelCuMqFcqhGcRuVC","margin":"","location":{"start":{"line":49,"column":1,"offset":920},"end":{"line":49,"column":128,"offset":1047}},"text":"text","content":["Trap exports a class ",{"type":"fcode","name":"C","content":["Trap"]}," that can be called to capture standard output and/or standard error, typically for a lexical scope."]},{"type":"para","id":"O3eWwKjgLWp-_-673kn6a","margin":"","location":{"start":{"line":51,"column":1,"offset":1049},"end":{"line":51,"column":289,"offset":1337}},"text":"text","content":["The class can be called with either one or two arguments, each of which should be a writeable local dynamic variable ",{"type":"fcode","name":"C","content":["$*OUT"]}," or ",{"type":"fcode","name":"C","content":["$*OUT"]},". Or one can create the ",{"type":"fcode","name":"C","content":["Trap"]}," object manually. Or one can use ",{"type":"fcode","name":"C","content":["Trap"]}," to just trap the standard output and/or standard error (see SYNOPSIS for examples)."]},{"type":"para","id":"VVcK8hEd4XGJyJWQeFArq","margin":"","location":{"start":{"line":53,"column":1,"offset":1339},"end":{"line":53,"column":124,"offset":1462}},"text":"text","content":["Note that if you're only interested in surpressing output from ",{"type":"fcode","name":"B","content":["warnings"]},", you should use the ",{"type":"fcode","name":"C","content":["quietly"]}," statement prefix."]},{"type":"block","id":"JvWtc8s-e7auUzHue75d6","margin":"","level":1,"name":"head","location":{"start":{"line":55,"column":1,"offset":1464},"end":{"line":56,"column":7,"offset":1477}},"content":["AUTHOR"]},{"type":"para","id":"tuLzs_BXAqPJPqwZ2XJBv","margin":"","location":{"start":{"line":58,"column":1,"offset":1479},"end":{"line":58,"column":37,"offset":1515}},"text":"text","content":["Elizabeth Mattijsen ",{"meta":"mailto:liz@raku.rocks","type":"fcode","name":"L","content":["liz@raku.rocks"]}]},{"type":"para","id":"ya_RVwxDwBTDYhwBQLZB9","margin":"","location":{"start":{"line":60,"column":1,"offset":1517},"end":{"line":60,"column":99,"offset":1615}},"text":"text","content":["Source can be located at: ",{"meta":"https://github.com/lizmat/Trap","type":"fcode","name":"L","content":["https://github.com/lizmat/Trap"]}," . Comments and Pull Requests are welcome."]},{"type":"para","id":"DPCOO_QCUMcsCTMDEW6sM","margin":"","location":{"start":{"line":62,"column":1,"offset":1617},"end":{"line":62,"column":163,"offset":1779}},"text":"text","content":["If you like this module, or what I’m doing more generally, committing to a ",{"meta":"https://github.com/sponsors/lizmat/","type":"fcode","name":"L","content":["small sponsorship"]}," would mean a great deal to me!"]},{"type":"block","id":"oGyemMnDu2bLQYomoVxst","margin":"","level":1,"name":"head","location":{"start":{"line":64,"column":1,"offset":1781},"end":{"line":65,"column":22,"offset":1824}},"content":["COPYRIGHT AND LICENSE"]},{"type":"para","id":"_0NBB6wb5X9yPHwGtT3P-","margin":"","location":{"start":{"line":67,"column":1,"offset":1826},"end":{"line":67,"column":35,"offset":1860}},"text":"text","content":["Copyright 2022 Elizabeth Mattijsen"]},{"type":"para","id":"yhfj9A2-ExsOe5Vrz1Eok","margin":"","location":{"start":{"line":69,"column":1,"offset":1862},"end":{"line":69,"column":104,"offset":1965}},"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/Trap/Trap-0.0.1/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"","auth":"zef:lizmat","authors":["Elizabeth Mattijsen"],"build-depends":[],"depends":[],"description":"Trap $*OUT and/or $*ERR output","dist":"Trap:ver<0.0.1>:auth<zef:lizmat>","license":"Artistic-2.0","name":"Trap","path":"T/RA/TRAP/edccf93e95c4d920d5581bfb396c8ef3267d2b99.tar.gz","perl":"6.d","provides":{"Trap":"lib/Trap.rakumod"},"resources":[],"source-url":"https://github.com/lizmat/Trap.git","tags":["TRAP","STDOUT","STDERR"],"test-depends":[],"version":"0.0.1"},"files":[{"file":"work_mods/zef/Trap/Trap-0.0.1/README.md","publishUrl":"/mods/zef/Trap/Trap-0.0.1/README.md"},{"file":"work_mods/zef/Trap/Trap-0.0.1/lib/Trap.rakumod","publishUrl":"/mods/zef/Trap/Trap-0.0.1/lib/Trap.rakumod"}],"src":"zef","url":"/mods/zef/Trap"}}}
=end data


    =begin React :component<RenderItem>
    =begin data
    {"type":"page","file":"work_mods/zef/Trap/Trap-0.0.1/README.md","sources":[],"node":{"type":"block","id":"S85wIU1X-xvziTK3c6iO8","margin":"","name":"root","content":[{"type":"para","id":"2UhF_jUSvHNGA8Kmcmesv","margin":"","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":129,"offset":128}},"text":"text","content":[{"meta":"https://github.com/lizmat/Trap/actions","type":"fcode","name":"L","content":[{"type":"block","id":"S9k1v0QcetWkvX5Ra7c4J","margin":"","name":"Image","config":[],"location":{"start":{"line":1,"column":2,"offset":1},"end":{"line":1,"column":88,"offset":87}},"content":[{"type":"image","src":"https://github.com/lizmat/Trap/actions/workflows/test.yml/badge.svg","alt":"Actions Status"}]}]}]},{"type":"block","id":"xqlcBK-5aRAwsdssH-6GU","margin":"","level":1,"name":"head","location":{"start":{"line":3,"column":1,"offset":130},"end":{"line":4,"column":5,"offset":139}},"content":["NAME"]},{"type":"para","id":"8nyXjm0FoJXG1QEKM5a4V","margin":"","location":{"start":{"line":6,"column":1,"offset":141},"end":{"line":6,"column":38,"offset":178}},"text":"text","content":["Trap - Trap ",{"type":"fcode","name":"F","content":[{"type":"text","value":"*OUT and/or "}]},"*ERR output"]},{"type":"block","id":"FArRZ7qFAikfluy6Doj8J","margin":"","level":1,"name":"head","location":{"start":{"line":8,"column":1,"offset":180},"end":{"line":9,"column":9,"offset":197}},"content":["SYNOPSIS"]},{"type":"block","id":"HHkB_efn3GoMhqkexbQfj","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":11,"column":1,"offset":199},"end":{"line":44,"column":4,"offset":893}},"content":[{"type":"verbatim","value":"use Trap;\n\nmy $out;\nmy $err;\n{   # separate capturing\n    $out = Trap(my $*OUT);\n    $err = Trap(my $*ERR);\n    say \"Hello world!\";\n    note \"Goodbye!\"\n}\nprint \"STDOUT: $out.text()\";  # SDDOUT: Hello world!␤\nprint \"STDERR: $err.text()\";  # STDERR: Goodbye!␤\n\nmy $merged;\n{   # merged capturing\n    $merged = Trap(my $*OUT, my $*ERR);\n    say \"Hello world!\";\n    note \"Goodbye!\"\n}\nprint $merged.text;  # Hello world!␤Goodbye!␤\n\nmy $new;\n{   # creating the object manually\n    $new = my $*OUT = Trap.new;\n    say \"Hello world!\";\n}\nprint \"with object: $new.text()\";  # with object: Hello world!␤\n\n{   # ignoring any output\n    Trap(my $*OUT, my $*ERR);\n    say \"shall never be seen\";\n}"}]},{"type":"block","id":"RLGaxhLQE789OexbaNABs","margin":"","level":1,"name":"head","location":{"start":{"line":46,"column":1,"offset":895},"end":{"line":47,"column":12,"offset":918}},"content":["DESCRIPTION"]},{"type":"para","id":"gadgxelCuMqFcqhGcRuVC","margin":"","location":{"start":{"line":49,"column":1,"offset":920},"end":{"line":49,"column":128,"offset":1047}},"text":"text","content":["Trap exports a class ",{"type":"fcode","name":"C","content":["Trap"]}," that can be called to capture standard output and/or standard error, typically for a lexical scope."]},{"type":"para","id":"O3eWwKjgLWp-_-673kn6a","margin":"","location":{"start":{"line":51,"column":1,"offset":1049},"end":{"line":51,"column":289,"offset":1337}},"text":"text","content":["The class can be called with either one or two arguments, each of which should be a writeable local dynamic variable ",{"type":"fcode","name":"C","content":["$*OUT"]}," or ",{"type":"fcode","name":"C","content":["$*OUT"]},". Or one can create the ",{"type":"fcode","name":"C","content":["Trap"]}," object manually. Or one can use ",{"type":"fcode","name":"C","content":["Trap"]}," to just trap the standard output and/or standard error (see SYNOPSIS for examples)."]},{"type":"para","id":"VVcK8hEd4XGJyJWQeFArq","margin":"","location":{"start":{"line":53,"column":1,"offset":1339},"end":{"line":53,"column":124,"offset":1462}},"text":"text","content":["Note that if you're only interested in surpressing output from ",{"type":"fcode","name":"B","content":["warnings"]},", you should use the ",{"type":"fcode","name":"C","content":["quietly"]}," statement prefix."]},{"type":"block","id":"JvWtc8s-e7auUzHue75d6","margin":"","level":1,"name":"head","location":{"start":{"line":55,"column":1,"offset":1464},"end":{"line":56,"column":7,"offset":1477}},"content":["AUTHOR"]},{"type":"para","id":"tuLzs_BXAqPJPqwZ2XJBv","margin":"","location":{"start":{"line":58,"column":1,"offset":1479},"end":{"line":58,"column":37,"offset":1515}},"text":"text","content":["Elizabeth Mattijsen ",{"meta":"mailto:liz@raku.rocks","type":"fcode","name":"L","content":["liz@raku.rocks"]}]},{"type":"para","id":"ya_RVwxDwBTDYhwBQLZB9","margin":"","location":{"start":{"line":60,"column":1,"offset":1517},"end":{"line":60,"column":99,"offset":1615}},"text":"text","content":["Source can be located at: ",{"meta":"https://github.com/lizmat/Trap","type":"fcode","name":"L","content":["https://github.com/lizmat/Trap"]}," . Comments and Pull Requests are welcome."]},{"type":"para","id":"DPCOO_QCUMcsCTMDEW6sM","margin":"","location":{"start":{"line":62,"column":1,"offset":1617},"end":{"line":62,"column":163,"offset":1779}},"text":"text","content":["If you like this module, or what I’m doing more generally, committing to a ",{"meta":"https://github.com/sponsors/lizmat/","type":"fcode","name":"L","content":["small sponsorship"]}," would mean a great deal to me!"]},{"type":"block","id":"oGyemMnDu2bLQYomoVxst","margin":"","level":1,"name":"head","location":{"start":{"line":64,"column":1,"offset":1781},"end":{"line":65,"column":22,"offset":1824}},"content":["COPYRIGHT AND LICENSE"]},{"type":"para","id":"_0NBB6wb5X9yPHwGtT3P-","margin":"","location":{"start":{"line":67,"column":1,"offset":1826},"end":{"line":67,"column":35,"offset":1860}},"text":"text","content":["Copyright 2022 Elizabeth Mattijsen"]},{"type":"para","id":"yhfj9A2-ExsOe5Vrz1Eok","margin":"","location":{"start":{"line":69,"column":1,"offset":1862},"end":{"line":69,"column":104,"offset":1965}},"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/Trap/Trap-0.0.1/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"","auth":"zef:lizmat","authors":["Elizabeth Mattijsen"],"build-depends":[],"depends":[],"description":"Trap $*OUT and/or $*ERR output","dist":"Trap:ver<0.0.1>:auth<zef:lizmat>","license":"Artistic-2.0","name":"Trap","path":"T/RA/TRAP/edccf93e95c4d920d5581bfb396c8ef3267d2b99.tar.gz","perl":"6.d","provides":{"Trap":"lib/Trap.rakumod"},"resources":[],"source-url":"https://github.com/lizmat/Trap.git","tags":["TRAP","STDOUT","STDERR"],"test-depends":[],"version":"0.0.1"},"files":[{"file":"work_mods/zef/Trap/Trap-0.0.1/README.md","publishUrl":"/mods/zef/Trap/Trap-0.0.1/README.md"},{"file":"work_mods/zef/Trap/Trap-0.0.1/lib/Trap.rakumod","publishUrl":"/mods/zef/Trap/Trap-0.0.1/lib/Trap.rakumod"}],"src":"zef","url":"/mods/zef/Trap"}}}
    =end data
    =end React


Trap $*OUT and/or $*ERR output


Trap


Trait to set an attribute from an environment variable.


=begin data
{"type":"page","file":"work_mods/zef/Trait::Env/Trait-Env-1.1.2/README.md","sources":[],"node":{"type":"block","id":"bkfoYZ7-TBpQnu4ROk7-e","margin":"","name":"root","content":[{"type":"block","id":"r-XlT3OCoWNhzvm52z1Kf","margin":"","level":1,"name":"head","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":2,"column":5,"offset":9}},"content":["NAME"]},{"type":"para","id":"9WTCZ0imRKDdzO2S2BpVO","margin":"","location":{"start":{"line":4,"column":1,"offset":11},"end":{"line":4,"column":69,"offset":79}},"text":"text","content":["Trait::Env - Trait to set an attribute from an environment variable."]},{"type":"block","id":"gEW9sOnkX-u0Saf_9c5uU","margin":"","level":1,"name":"head","location":{"start":{"line":6,"column":1,"offset":81},"end":{"line":7,"column":9,"offset":98}},"content":["SYNOPSIS"]},{"type":"block","id":"s4HPUukiq_wkyYHqxLiFt","margin":"","name":"code","config":[],"location":{"start":{"line":9,"column":1,"offset":100},"end":{"line":52,"column":22,"offset":1580}},"content":[{"type":"verbatim","value":"use Trait::Env;\nclass Test {\n    # Sets from %*ENV{HOME}. Undef if the var doesn't exist\n    has $.home is env;\n\n    # Sets from %*ENV{TMPDIR}. Defaults to '/tmp'\n    has $.tmpdir is env is default \"/tmp\";\n\n    # Sets from %*ENV{EXTRA_DIR}. Defaults to '/tmp'\n    has $.extra-dir is env( :default</tmp> );\n\n    # Set from %*ENV{WORKDIR}. Dies if not set.\n    has $.workdir is env(:required);\n\n    # Set from %*ENV{READ_DIRS.+} ordered lexically\n    has @.read-dirs is env;\n\n    # Set from %*ENV{PATH} split on ':'\n    # has @.path is env(:sep<:>);\n    # Or default to the $*DISTRO.path-sep value\n    has @.path is env;      \n    \n    # Set from %*ENV{NAME_MAP} data split on ';' pairs split on ':'\n    # EG a:b;c:d => { \"a\" => \"b\", \"c\" => \"d\" }\n    has %.name-map is env( :sep<;>, :kvsep<:> );\n\n    # Get all pairs where the key ends with '_POST'\n    has %.post-map is env( :post_match<_POST> );\n\n    # Get all pairs where the Key starts with 'PRE_'\n    has %.pre-map is env( :pre_match<PRE_> );\n\n    # Get all pairs where the Key starts with 'PRE_' and ends with '_POST'\n    has %.both-map is env( :pre_match<PRE_>, :post_match<_POST> );\n\n    # Parses JSON data\n    has $.json-data is env( :json );\n}\n\n# Sets from %*ENV{HOME}. Undef if the var doesn't exist\nhas $home is env;\n\n# Sets from %*ENV{PATH}. Uses default path seperator\nhas @path is env;"}]},{"type":"block","id":"ZIjHIrYmneksEzOznq0mW","margin":"","level":1,"name":"head","location":{"start":{"line":54,"column":1,"offset":1582},"end":{"line":55,"column":12,"offset":1605}},"content":["DESCRIPTION"]},{"type":"para","id":"SHbOXILQv0h6ghKhxJ9iQ","margin":"","location":{"start":{"line":57,"column":1,"offset":1607},"end":{"line":57,"column":46,"offset":1652}},"text":"text","content":["Trait::Env is exports the new trait ",{"type":"fcode","name":"C","content":["is env"]},"."]},{"type":"para","id":"Ce7X7fMH_99nyTEHgst23","margin":"","location":{"start":{"line":59,"column":1,"offset":1654},"end":{"line":59,"column":177,"offset":1830}},"text":"text","content":["Note the the variable name will be uppercased and any dashes changed to underscores before matching against the environment. This functionality may be modifiable in the future."]},{"type":"para","id":"ZlRDivdjFO7LXdPg4Mgsw","margin":"","location":{"start":{"line":61,"column":1,"offset":1832},"end":{"line":61,"column":180,"offset":2011}},"text":"text","content":["For Booleans the standard Empty String == ",{"type":"fcode","name":"C","content":["False"]}," other String == ",{"type":"fcode","name":"C","content":["True"]}," works but the string \"True\" and \"False\" (any capitalization) will also map to True and False respectively."]},{"type":"para","id":"DyBLWbDH7li-MHwAxKc7C","margin":"","location":{"start":{"line":63,"column":1,"offset":2013},"end":{"line":63,"column":104,"offset":2116}},"text":"text","content":["If a required attribute is not set the code will raise a ",{"type":"fcode","name":"C","content":["X::Trait::Env::Required::Not::Set"]}," Exception."]},{"type":"para","id":"g_cuXTl1efggOfg4ju3DX","margin":"","location":{"start":{"line":65,"column":1,"offset":2118},"end":{"line":65,"column":148,"offset":2265}},"text":"text","content":["Defaults can be set using the standard ",{"type":"fcode","name":"C","content":["is default"]}," trait or the ",{"type":"fcode","name":"C","content":[":default"]}," key. Note that for Positional attributes only the ",{"type":"fcode","name":"C","content":[":default"]}," key works."]},{"type":"para","id":"0fNBA6JpFdighxc3aiLXg","margin":"","location":{"start":{"line":67,"column":1,"offset":2267},"end":{"line":67,"column":218,"offset":2484}},"text":"text","content":["Positional attributes will use the attribute name (after coercing) as the prefix to scan %*ENV for. Any keys starting with that prefix will be ordered by the key name lexically and their values put into the attribute."]},{"type":"para","id":"2vB1kV1CqVgYQWro17FoO","margin":"","location":{"start":{"line":69,"column":1,"offset":2486},"end":{"line":69,"column":184,"offset":2669}},"text":"text","content":["Alternatively you can use the ",{"type":"fcode","name":"C","content":[":sep"]}," key to specify a seperator, in which case the single value will be read based on the name and the list then created by spliting on this seperator."]},{"type":"para","id":"UnewdNeRdJnIMKFBMLplm","margin":"","location":{"start":{"line":71,"column":1,"offset":2671},"end":{"line":71,"column":169,"offset":2839}},"text":"text","content":["If there is a single matching environment variable and no ",{"type":"fcode","name":"C","content":[":sep"]}," key is set then the system will fall back to splitting on the ",{"type":"fcode","name":"C","content":["$*DISTRO.path-sep"]}," value as a seperator."]},{"type":"para","id":"6CYgP4dlUBsTILHk12PwJ","margin":"","location":{"start":{"line":73,"column":1,"offset":2841},"end":{"line":73,"column":161,"offset":3001}},"text":"text","content":["Hashes can be single value with a ",{"type":"fcode","name":"C","content":[":sep"]}," key to specify the seperator between pairs and a ",{"type":"fcode","name":"C","content":[":kvsep"]}," to specifiy the seperator in each pair between key and value."]},{"type":"para","id":"BADXNIM1c7XtElyj7ENfw","margin":"","location":{"start":{"line":75,"column":1,"offset":3003},"end":{"line":75,"column":211,"offset":3213}},"text":"text","content":["Hashes can also be defined by giving a ",{"type":"fcode","name":"C","content":[":post_match"]}," or ",{"type":"fcode","name":"C","content":[":pre_match"]}," arguments (or both). Any Environment variable starting with ",{"type":"fcode","name":"C","content":[":pre_match"]}," is defined or ending with ",{"type":"fcode","name":"C","content":[":post-match"]}," if defined will be included."]},{"type":"para","id":"trB8jqz0wnpPVFcJgU2WE","margin":"","location":{"start":{"line":77,"column":1,"offset":3215},"end":{"line":77,"column":66,"offset":3280}},"text":"text","content":["Scalars, Positionals and Associative attributes can all be typed."]},{"type":"para","id":"aMcgfISAovPeRsuBXvNQm","margin":"","location":{"start":{"line":79,"column":1,"offset":3282},"end":{"line":79,"column":71,"offset":3352}},"text":"text","content":["Variables can also be defined with ",{"type":"fcode","name":"C","content":["is env"]}," following the same rules."]},{"type":"para","id":"RIlxxTj4OSezFHlg-Wrhw","margin":"","location":{"start":{"line":81,"column":1,"offset":3354},"end":{"line":81,"column":127,"offset":3480}},"text":"text","content":["Attribute or Variable only ",{"type":"fcode","name":"C","content":["is env"]}," traits can be loaded individually with ",{"type":"fcode","name":"C","content":["Trait::Env::Attribute"]}," and ",{"type":"fcode","name":"C","content":["Trait::Env::Variable"]},"."]},{"type":"para","id":"NSa6fPBTY91SryOThGSYp","margin":"","location":{"start":{"line":83,"column":1,"offset":3482},"end":{"line":83,"column":270,"offset":3751}},"text":"text","content":["Scalar Attributes and Variables can use ",{"type":"fcode","name":"C","content":["is env(:json)"]}," which will parse the ENV string as a JSON string using ",{"type":"fcode","name":"C","content":["JSON::Tiny"]},". You can combine this with the ",{"type":"fcode","name":"C","content":[":default"]}," and ",{"type":"fcode","name":"C","content":[":required"]}," options but be aware that the ",{"type":"fcode","name":"C","content":[":default"]}," value should be a data store NOT a JSON value."]},{"type":"block","id":"Ny9Ah6FOBY_r-adhv-e61","margin":"","level":1,"name":"head","location":{"start":{"line":85,"column":1,"offset":3753},"end":{"line":86,"column":7,"offset":3766}},"content":["AUTHOR"]},{"type":"para","id":"zZzTOqhHTb3En67FECz_j","margin":"","location":{"start":{"line":88,"column":1,"offset":3768},"end":{"line":88,"column":40,"offset":3807}},"text":"text","content":["Simon Proctor ",{"meta":"mailto:simon.proctor@gmail.com","type":"fcode","name":"L","content":["simon.proctor@gmail.com"]}]},{"type":"para","id":"K59rwp9SjYj4nt0do14CR","margin":"","location":{"start":{"line":90,"column":1,"offset":3809},"end":{"line":90,"column":125,"offset":3933}},"text":"text","content":["Thanks to Jonathan Worthington and Elizabeth Mattijsen for giving me the framework to build this on. Any mistakes are mine."]},{"type":"block","id":"0tjXDpOf7M96I_8wit5Mu","margin":"","level":1,"name":"head","location":{"start":{"line":92,"column":1,"offset":3935},"end":{"line":93,"column":22,"offset":3978}},"content":["COPYRIGHT AND LICENSE"]},{"type":"para","id":"thAT7LGR0j5IGzeGswmMl","margin":"","location":{"start":{"line":95,"column":1,"offset":3980},"end":{"line":95,"column":29,"offset":4008}},"text":"text","content":["Copyright 2018 Simon Proctor"]},{"type":"para","id":"Iglgz3fKB0sK4EPrDe27m","margin":"","location":{"start":{"line":97,"column":1,"offset":4010},"end":{"line":97,"column":104,"offset":4113}},"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/Trait::Env/Trait-Env-1.1.2/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"","auth":"zef:Scimon","authors":["Simon Proctor"],"build-depends":[],"depends":["JSON::Tiny"],"description":"Trait to set an attribute from an environment variable.","dist":"Trait::Env:ver<1.1.2>:auth<zef:Scimon>","license":"Artistic-2.0","name":"Trait::Env","path":"T/RA/TRAIT_ENV/3b796ec9561dc8607d413f3479cd11d429b04929.tar.gz","perl":"6.c","provides":{"Trait::Env":"lib/Trait/Env.rakumod","Trait::Env::Attribute":"lib/Trait/Env/Attribute.rakumod","Trait::Env::Exceptions":"lib/Trait/Env/Exceptions.rakumod","Trait::Env::Shared":"lib/Trait/Env/Shared.rakumod","Trait::Env::Variable":"lib/Trait/Env/Variable.rakumod"},"resources":[],"source-url":"https://github.com/Scimon/p6-Trait-Env.git","tags":["Trait"],"test-depends":[],"version":"1.1.2"},"files":[{"file":"work_mods/zef/Trait::Env/Trait-Env-1.1.2/README.md","publishUrl":"/mods/zef/Trait::Env/Trait-Env-1.1.2/README.md"},{"file":"work_mods/zef/Trait::Env/Trait-Env-1.1.2/lib/Trait/Env.rakumod","publishUrl":"/mods/zef/Trait::Env/Trait-Env-1.1.2/lib/Trait/Env.rakumod"}],"src":"zef","url":"/mods/zef/Trait::Env"}}}
=end data


    =begin React :component<RenderItem>
    =begin data
    {"type":"page","file":"work_mods/zef/Trait::Env/Trait-Env-1.1.2/README.md","sources":[],"node":{"type":"block","id":"bkfoYZ7-TBpQnu4ROk7-e","margin":"","name":"root","content":[{"type":"block","id":"r-XlT3OCoWNhzvm52z1Kf","margin":"","level":1,"name":"head","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":2,"column":5,"offset":9}},"content":["NAME"]},{"type":"para","id":"9WTCZ0imRKDdzO2S2BpVO","margin":"","location":{"start":{"line":4,"column":1,"offset":11},"end":{"line":4,"column":69,"offset":79}},"text":"text","content":["Trait::Env - Trait to set an attribute from an environment variable."]},{"type":"block","id":"gEW9sOnkX-u0Saf_9c5uU","margin":"","level":1,"name":"head","location":{"start":{"line":6,"column":1,"offset":81},"end":{"line":7,"column":9,"offset":98}},"content":["SYNOPSIS"]},{"type":"block","id":"s4HPUukiq_wkyYHqxLiFt","margin":"","name":"code","config":[],"location":{"start":{"line":9,"column":1,"offset":100},"end":{"line":52,"column":22,"offset":1580}},"content":[{"type":"verbatim","value":"use Trait::Env;\nclass Test {\n    # Sets from %*ENV{HOME}. Undef if the var doesn't exist\n    has $.home is env;\n\n    # Sets from %*ENV{TMPDIR}. Defaults to '/tmp'\n    has $.tmpdir is env is default \"/tmp\";\n\n    # Sets from %*ENV{EXTRA_DIR}. Defaults to '/tmp'\n    has $.extra-dir is env( :default</tmp> );\n\n    # Set from %*ENV{WORKDIR}. Dies if not set.\n    has $.workdir is env(:required);\n\n    # Set from %*ENV{READ_DIRS.+} ordered lexically\n    has @.read-dirs is env;\n\n    # Set from %*ENV{PATH} split on ':'\n    # has @.path is env(:sep<:>);\n    # Or default to the $*DISTRO.path-sep value\n    has @.path is env;      \n    \n    # Set from %*ENV{NAME_MAP} data split on ';' pairs split on ':'\n    # EG a:b;c:d => { \"a\" => \"b\", \"c\" => \"d\" }\n    has %.name-map is env( :sep<;>, :kvsep<:> );\n\n    # Get all pairs where the key ends with '_POST'\n    has %.post-map is env( :post_match<_POST> );\n\n    # Get all pairs where the Key starts with 'PRE_'\n    has %.pre-map is env( :pre_match<PRE_> );\n\n    # Get all pairs where the Key starts with 'PRE_' and ends with '_POST'\n    has %.both-map is env( :pre_match<PRE_>, :post_match<_POST> );\n\n    # Parses JSON data\n    has $.json-data is env( :json );\n}\n\n# Sets from %*ENV{HOME}. Undef if the var doesn't exist\nhas $home is env;\n\n# Sets from %*ENV{PATH}. Uses default path seperator\nhas @path is env;"}]},{"type":"block","id":"ZIjHIrYmneksEzOznq0mW","margin":"","level":1,"name":"head","location":{"start":{"line":54,"column":1,"offset":1582},"end":{"line":55,"column":12,"offset":1605}},"content":["DESCRIPTION"]},{"type":"para","id":"SHbOXILQv0h6ghKhxJ9iQ","margin":"","location":{"start":{"line":57,"column":1,"offset":1607},"end":{"line":57,"column":46,"offset":1652}},"text":"text","content":["Trait::Env is exports the new trait ",{"type":"fcode","name":"C","content":["is env"]},"."]},{"type":"para","id":"Ce7X7fMH_99nyTEHgst23","margin":"","location":{"start":{"line":59,"column":1,"offset":1654},"end":{"line":59,"column":177,"offset":1830}},"text":"text","content":["Note the the variable name will be uppercased and any dashes changed to underscores before matching against the environment. This functionality may be modifiable in the future."]},{"type":"para","id":"ZlRDivdjFO7LXdPg4Mgsw","margin":"","location":{"start":{"line":61,"column":1,"offset":1832},"end":{"line":61,"column":180,"offset":2011}},"text":"text","content":["For Booleans the standard Empty String == ",{"type":"fcode","name":"C","content":["False"]}," other String == ",{"type":"fcode","name":"C","content":["True"]}," works but the string \"True\" and \"False\" (any capitalization) will also map to True and False respectively."]},{"type":"para","id":"DyBLWbDH7li-MHwAxKc7C","margin":"","location":{"start":{"line":63,"column":1,"offset":2013},"end":{"line":63,"column":104,"offset":2116}},"text":"text","content":["If a required attribute is not set the code will raise a ",{"type":"fcode","name":"C","content":["X::Trait::Env::Required::Not::Set"]}," Exception."]},{"type":"para","id":"g_cuXTl1efggOfg4ju3DX","margin":"","location":{"start":{"line":65,"column":1,"offset":2118},"end":{"line":65,"column":148,"offset":2265}},"text":"text","content":["Defaults can be set using the standard ",{"type":"fcode","name":"C","content":["is default"]}," trait or the ",{"type":"fcode","name":"C","content":[":default"]}," key. Note that for Positional attributes only the ",{"type":"fcode","name":"C","content":[":default"]}," key works."]},{"type":"para","id":"0fNBA6JpFdighxc3aiLXg","margin":"","location":{"start":{"line":67,"column":1,"offset":2267},"end":{"line":67,"column":218,"offset":2484}},"text":"text","content":["Positional attributes will use the attribute name (after coercing) as the prefix to scan %*ENV for. Any keys starting with that prefix will be ordered by the key name lexically and their values put into the attribute."]},{"type":"para","id":"2vB1kV1CqVgYQWro17FoO","margin":"","location":{"start":{"line":69,"column":1,"offset":2486},"end":{"line":69,"column":184,"offset":2669}},"text":"text","content":["Alternatively you can use the ",{"type":"fcode","name":"C","content":[":sep"]}," key to specify a seperator, in which case the single value will be read based on the name and the list then created by spliting on this seperator."]},{"type":"para","id":"UnewdNeRdJnIMKFBMLplm","margin":"","location":{"start":{"line":71,"column":1,"offset":2671},"end":{"line":71,"column":169,"offset":2839}},"text":"text","content":["If there is a single matching environment variable and no ",{"type":"fcode","name":"C","content":[":sep"]}," key is set then the system will fall back to splitting on the ",{"type":"fcode","name":"C","content":["$*DISTRO.path-sep"]}," value as a seperator."]},{"type":"para","id":"6CYgP4dlUBsTILHk12PwJ","margin":"","location":{"start":{"line":73,"column":1,"offset":2841},"end":{"line":73,"column":161,"offset":3001}},"text":"text","content":["Hashes can be single value with a ",{"type":"fcode","name":"C","content":[":sep"]}," key to specify the seperator between pairs and a ",{"type":"fcode","name":"C","content":[":kvsep"]}," to specifiy the seperator in each pair between key and value."]},{"type":"para","id":"BADXNIM1c7XtElyj7ENfw","margin":"","location":{"start":{"line":75,"column":1,"offset":3003},"end":{"line":75,"column":211,"offset":3213}},"text":"text","content":["Hashes can also be defined by giving a ",{"type":"fcode","name":"C","content":[":post_match"]}," or ",{"type":"fcode","name":"C","content":[":pre_match"]}," arguments (or both). Any Environment variable starting with ",{"type":"fcode","name":"C","content":[":pre_match"]}," is defined or ending with ",{"type":"fcode","name":"C","content":[":post-match"]}," if defined will be included."]},{"type":"para","id":"trB8jqz0wnpPVFcJgU2WE","margin":"","location":{"start":{"line":77,"column":1,"offset":3215},"end":{"line":77,"column":66,"offset":3280}},"text":"text","content":["Scalars, Positionals and Associative attributes can all be typed."]},{"type":"para","id":"aMcgfISAovPeRsuBXvNQm","margin":"","location":{"start":{"line":79,"column":1,"offset":3282},"end":{"line":79,"column":71,"offset":3352}},"text":"text","content":["Variables can also be defined with ",{"type":"fcode","name":"C","content":["is env"]}," following the same rules."]},{"type":"para","id":"RIlxxTj4OSezFHlg-Wrhw","margin":"","location":{"start":{"line":81,"column":1,"offset":3354},"end":{"line":81,"column":127,"offset":3480}},"text":"text","content":["Attribute or Variable only ",{"type":"fcode","name":"C","content":["is env"]}," traits can be loaded individually with ",{"type":"fcode","name":"C","content":["Trait::Env::Attribute"]}," and ",{"type":"fcode","name":"C","content":["Trait::Env::Variable"]},"."]},{"type":"para","id":"NSa6fPBTY91SryOThGSYp","margin":"","location":{"start":{"line":83,"column":1,"offset":3482},"end":{"line":83,"column":270,"offset":3751}},"text":"text","content":["Scalar Attributes and Variables can use ",{"type":"fcode","name":"C","content":["is env(:json)"]}," which will parse the ENV string as a JSON string using ",{"type":"fcode","name":"C","content":["JSON::Tiny"]},". You can combine this with the ",{"type":"fcode","name":"C","content":[":default"]}," and ",{"type":"fcode","name":"C","content":[":required"]}," options but be aware that the ",{"type":"fcode","name":"C","content":[":default"]}," value should be a data store NOT a JSON value."]},{"type":"block","id":"Ny9Ah6FOBY_r-adhv-e61","margin":"","level":1,"name":"head","location":{"start":{"line":85,"column":1,"offset":3753},"end":{"line":86,"column":7,"offset":3766}},"content":["AUTHOR"]},{"type":"para","id":"zZzTOqhHTb3En67FECz_j","margin":"","location":{"start":{"line":88,"column":1,"offset":3768},"end":{"line":88,"column":40,"offset":3807}},"text":"text","content":["Simon Proctor ",{"meta":"mailto:simon.proctor@gmail.com","type":"fcode","name":"L","content":["simon.proctor@gmail.com"]}]},{"type":"para","id":"K59rwp9SjYj4nt0do14CR","margin":"","location":{"start":{"line":90,"column":1,"offset":3809},"end":{"line":90,"column":125,"offset":3933}},"text":"text","content":["Thanks to Jonathan Worthington and Elizabeth Mattijsen for giving me the framework to build this on. Any mistakes are mine."]},{"type":"block","id":"0tjXDpOf7M96I_8wit5Mu","margin":"","level":1,"name":"head","location":{"start":{"line":92,"column":1,"offset":3935},"end":{"line":93,"column":22,"offset":3978}},"content":["COPYRIGHT AND LICENSE"]},{"type":"para","id":"thAT7LGR0j5IGzeGswmMl","margin":"","location":{"start":{"line":95,"column":1,"offset":3980},"end":{"line":95,"column":29,"offset":4008}},"text":"text","content":["Copyright 2018 Simon Proctor"]},{"type":"para","id":"Iglgz3fKB0sK4EPrDe27m","margin":"","location":{"start":{"line":97,"column":1,"offset":4010},"end":{"line":97,"column":104,"offset":4113}},"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/Trait::Env/Trait-Env-1.1.2/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"","auth":"zef:Scimon","authors":["Simon Proctor"],"build-depends":[],"depends":["JSON::Tiny"],"description":"Trait to set an attribute from an environment variable.","dist":"Trait::Env:ver<1.1.2>:auth<zef:Scimon>","license":"Artistic-2.0","name":"Trait::Env","path":"T/RA/TRAIT_ENV/3b796ec9561dc8607d413f3479cd11d429b04929.tar.gz","perl":"6.c","provides":{"Trait::Env":"lib/Trait/Env.rakumod","Trait::Env::Attribute":"lib/Trait/Env/Attribute.rakumod","Trait::Env::Exceptions":"lib/Trait/Env/Exceptions.rakumod","Trait::Env::Shared":"lib/Trait/Env/Shared.rakumod","Trait::Env::Variable":"lib/Trait/Env/Variable.rakumod"},"resources":[],"source-url":"https://github.com/Scimon/p6-Trait-Env.git","tags":["Trait"],"test-depends":[],"version":"1.1.2"},"files":[{"file":"work_mods/zef/Trait::Env/Trait-Env-1.1.2/README.md","publishUrl":"/mods/zef/Trait::Env/Trait-Env-1.1.2/README.md"},{"file":"work_mods/zef/Trait::Env/Trait-Env-1.1.2/lib/Trait/Env.rakumod","publishUrl":"/mods/zef/Trait::Env/Trait-Env-1.1.2/lib/Trait/Env.rakumod"}],"src":"zef","url":"/mods/zef/Trait::Env"}}}
    =end data
    =end React


Trait::Env


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


Trait::IO

NAME

SYNOPSIS

DESCRIPTION

EXPORTS

AUTHOR

COPYRIGHT AND LICENSE

Trait::IO v1.1

Authors

License

Dependencies

Test Dependencies

Provides

Documentation