TITLE

set up SIGPIPE correctly for CLI applications


SUBTITLE

data

=begin data
{"type":"page","file":"work_mods/zef/sigpipe/sigpipe-0.0.1/README.md","sources":[],"node":{"type":"block","id":"LYFAXQZXGVEt061YqCc5h","margin":"","name":"root","content":[{"type":"para","id":"m-sEcpRXyp9pt1ISLC9nk","margin":"","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":121,"offset":120}},"text":"text","content":[{"meta":"https://github.com/Leont/sigpipe/actions","type":"fcode","name":"L","content":[{"type":"block","id":"QTd4FAfzCqMZDSp4AUX9t","margin":"","name":"Image","config":[],"location":{"start":{"line":1,"column":2,"offset":1},"end":{"line":1,"column":78,"offset":77}},"content":[{"type":"image","src":"https://github.com/Leont/sigpipe/workflows/test/badge.svg","alt":"Actions Status"}]}]}]},{"type":"block","id":"kTpmYPAbtcSXce_Tl70d0","margin":"","level":1,"name":"head","location":{"start":{"line":3,"column":1,"offset":122},"end":{"line":4,"column":5,"offset":131}},"content":["NAME"]},{"type":"para","id":"QIToaBTmXV6vkwJ0f98RX","margin":"","location":{"start":{"line":6,"column":1,"offset":133},"end":{"line":6,"column":56,"offset":188}},"text":"text","content":["sigpipe - set up SIGPIPE correctly for CLI applications"]},{"type":"block","id":"J5ISak4_1cInz8TcIQ1Ps","margin":"","level":1,"name":"head","location":{"start":{"line":8,"column":1,"offset":190},"end":{"line":9,"column":9,"offset":207}},"content":["SYNOPSIS"]},{"type":"block","id":"93NGOq9-leSMMVnuCN66x","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":11,"column":1,"offset":209},"end":{"line":13,"column":4,"offset":233}},"content":[{"type":"verbatim","value":"use sigpipe;"}]},{"type":"block","id":"ZEy2SPoHttOIXX-pvSVZ6","margin":"","level":1,"name":"head","location":{"start":{"line":15,"column":1,"offset":235},"end":{"line":16,"column":12,"offset":258}},"content":["DESCRIPTION"]},{"type":"para","id":"A95Alqb9VS5xB0CO5N06T","margin":"","location":{"start":{"line":18,"column":1,"offset":260},"end":{"line":18,"column":373,"offset":632}},"text":"text","content":["Raku's default sigpipe handling does the sensible things for networking applications, but entirely the wrong thing for CLI applications. For example a program like ",{"type":"fcode","name":"C","content":["raku -e 'loop { say \"y\" }' | head"]}," will output a long error message that is entirely useless for the end-user. This module will instead use the unix default: end the program immediately without any ceremony."]},{"type":"block","id":"O_aL-cqhQgU_l0pva8eBe","margin":"","level":1,"name":"head","location":{"start":{"line":20,"column":1,"offset":634},"end":{"line":21,"column":7,"offset":647}},"content":["AUTHOR"]},{"type":"para","id":"yvUQeKgwB4y-aSWN8qCIB","margin":"","location":{"start":{"line":23,"column":1,"offset":649},"end":{"line":23,"column":35,"offset":683}},"text":"text","content":["Leon Timmermans ",{"meta":"mailto:fawaka@gmail.com","type":"fcode","name":"L","content":["fawaka@gmail.com"]}]},{"type":"block","id":"RK0g4-M1oelRPqxhblSJ2","margin":"","level":1,"name":"head","location":{"start":{"line":25,"column":1,"offset":685},"end":{"line":26,"column":22,"offset":728}},"content":["COPYRIGHT AND LICENSE"]},{"type":"para","id":"ZoP4L80G1R6IsWyzcZ_YZ","margin":"","location":{"start":{"line":28,"column":1,"offset":730},"end":{"line":28,"column":31,"offset":760}},"text":"text","content":["Copyright 2022 Leon Timmermans"]},{"type":"para","id":"ORVWlLYhwMF8AK9QfQSvY","margin":"","location":{"start":{"line":30,"column":1,"offset":762},"end":{"line":30,"column":104,"offset":865}},"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/sigpipe/sigpipe-0.0.1/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"","auth":"zef:leont","authors":["Leon Timmermans"],"build-depends":[],"depends":[],"description":"set up SIGPIPE correctly for CLI applications","dist":"sigpipe:ver<0.0.1>:auth<zef:leont>","license":"Artistic-2.0","name":"sigpipe","path":"S/IG/SIGPIPE/b555341f9c102e7d45baa574244c7de139c3f515.tar.gz","perl":"6.d","provides":{"sigpipe":"lib/sigpipe.rakumod"},"resources":[],"source-url":"https://github.com/Leont/sigpipe.git","tags":[],"test-depends":[],"version":"0.0.1"},"files":[{"file":"work_mods/zef/sigpipe/sigpipe-0.0.1/README.md","publishUrl":"/mods/zef/sigpipe/sigpipe-0.0.1/README.md"},{"file":"work_mods/zef/sigpipe/sigpipe-0.0.1/lib/sigpipe.rakumod","publishUrl":"/mods/zef/sigpipe/sigpipe-0.0.1/lib/sigpipe.rakumod"}],"src":"zef","url":"/mods/zef/sigpipe"}}}
=end data


React

    =begin React :component<RenderItem>
    =begin data
    {"type":"page","file":"work_mods/zef/sigpipe/sigpipe-0.0.1/README.md","sources":[],"node":{"type":"block","id":"LYFAXQZXGVEt061YqCc5h","margin":"","name":"root","content":[{"type":"para","id":"m-sEcpRXyp9pt1ISLC9nk","margin":"","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":121,"offset":120}},"text":"text","content":[{"meta":"https://github.com/Leont/sigpipe/actions","type":"fcode","name":"L","content":[{"type":"block","id":"QTd4FAfzCqMZDSp4AUX9t","margin":"","name":"Image","config":[],"location":{"start":{"line":1,"column":2,"offset":1},"end":{"line":1,"column":78,"offset":77}},"content":[{"type":"image","src":"https://github.com/Leont/sigpipe/workflows/test/badge.svg","alt":"Actions Status"}]}]}]},{"type":"block","id":"kTpmYPAbtcSXce_Tl70d0","margin":"","level":1,"name":"head","location":{"start":{"line":3,"column":1,"offset":122},"end":{"line":4,"column":5,"offset":131}},"content":["NAME"]},{"type":"para","id":"QIToaBTmXV6vkwJ0f98RX","margin":"","location":{"start":{"line":6,"column":1,"offset":133},"end":{"line":6,"column":56,"offset":188}},"text":"text","content":["sigpipe - set up SIGPIPE correctly for CLI applications"]},{"type":"block","id":"J5ISak4_1cInz8TcIQ1Ps","margin":"","level":1,"name":"head","location":{"start":{"line":8,"column":1,"offset":190},"end":{"line":9,"column":9,"offset":207}},"content":["SYNOPSIS"]},{"type":"block","id":"93NGOq9-leSMMVnuCN66x","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":11,"column":1,"offset":209},"end":{"line":13,"column":4,"offset":233}},"content":[{"type":"verbatim","value":"use sigpipe;"}]},{"type":"block","id":"ZEy2SPoHttOIXX-pvSVZ6","margin":"","level":1,"name":"head","location":{"start":{"line":15,"column":1,"offset":235},"end":{"line":16,"column":12,"offset":258}},"content":["DESCRIPTION"]},{"type":"para","id":"A95Alqb9VS5xB0CO5N06T","margin":"","location":{"start":{"line":18,"column":1,"offset":260},"end":{"line":18,"column":373,"offset":632}},"text":"text","content":["Raku's default sigpipe handling does the sensible things for networking applications, but entirely the wrong thing for CLI applications. For example a program like ",{"type":"fcode","name":"C","content":["raku -e 'loop { say \"y\" }' | head"]}," will output a long error message that is entirely useless for the end-user. This module will instead use the unix default: end the program immediately without any ceremony."]},{"type":"block","id":"O_aL-cqhQgU_l0pva8eBe","margin":"","level":1,"name":"head","location":{"start":{"line":20,"column":1,"offset":634},"end":{"line":21,"column":7,"offset":647}},"content":["AUTHOR"]},{"type":"para","id":"yvUQeKgwB4y-aSWN8qCIB","margin":"","location":{"start":{"line":23,"column":1,"offset":649},"end":{"line":23,"column":35,"offset":683}},"text":"text","content":["Leon Timmermans ",{"meta":"mailto:fawaka@gmail.com","type":"fcode","name":"L","content":["fawaka@gmail.com"]}]},{"type":"block","id":"RK0g4-M1oelRPqxhblSJ2","margin":"","level":1,"name":"head","location":{"start":{"line":25,"column":1,"offset":685},"end":{"line":26,"column":22,"offset":728}},"content":["COPYRIGHT AND LICENSE"]},{"type":"para","id":"ZoP4L80G1R6IsWyzcZ_YZ","margin":"","location":{"start":{"line":28,"column":1,"offset":730},"end":{"line":28,"column":31,"offset":760}},"text":"text","content":["Copyright 2022 Leon Timmermans"]},{"type":"para","id":"ORVWlLYhwMF8AK9QfQSvY","margin":"","location":{"start":{"line":30,"column":1,"offset":762},"end":{"line":30,"column":104,"offset":865}},"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/sigpipe/sigpipe-0.0.1/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"","auth":"zef:leont","authors":["Leon Timmermans"],"build-depends":[],"depends":[],"description":"set up SIGPIPE correctly for CLI applications","dist":"sigpipe:ver<0.0.1>:auth<zef:leont>","license":"Artistic-2.0","name":"sigpipe","path":"S/IG/SIGPIPE/b555341f9c102e7d45baa574244c7de139c3f515.tar.gz","perl":"6.d","provides":{"sigpipe":"lib/sigpipe.rakumod"},"resources":[],"source-url":"https://github.com/Leont/sigpipe.git","tags":[],"test-depends":[],"version":"0.0.1"},"files":[{"file":"work_mods/zef/sigpipe/sigpipe-0.0.1/README.md","publishUrl":"/mods/zef/sigpipe/sigpipe-0.0.1/README.md"},{"file":"work_mods/zef/sigpipe/sigpipe-0.0.1/lib/sigpipe.rakumod","publishUrl":"/mods/zef/sigpipe/sigpipe-0.0.1/lib/sigpipe.rakumod"}],"src":"zef","url":"/mods/zef/sigpipe"}}}
    =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

sigpipe


=begin data
{"type":"page","file":"work_mods/zef/silently/silently-0.0.4/README.md","sources":[],"node":{"type":"block","id":"ciesT8Pz2L-88x-x0faz-","margin":"","name":"root","content":[{"type":"para","id":"orSy-Hc4DkrYBO6LdKY_X","margin":"","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":125,"offset":124}},"text":"text","content":[{"meta":"https://github.com/lizmat/silently/actions","type":"fcode","name":"L","content":[{"type":"block","id":"Lo1OpkJR_FQZ1kV0VcJEy","margin":"","name":"Image","config":[],"location":{"start":{"line":1,"column":2,"offset":1},"end":{"line":1,"column":80,"offset":79}},"content":[{"type":"image","src":"https://github.com/lizmat/silently/workflows/test/badge.svg","alt":"Actions Status"}]}]}]},{"type":"block","id":"xN0sh1GH8hthED-H6SX6E","margin":"","level":1,"name":"head","location":{"start":{"line":3,"column":1,"offset":126},"end":{"line":4,"column":5,"offset":135}},"content":["NAME"]},{"type":"para","id":"g25iHLfaFQb2hUG8RkB0a","margin":"","location":{"start":{"line":6,"column":1,"offset":137},"end":{"line":6,"column":43,"offset":179}},"text":"text","content":["silently - prevent any output from a block"]},{"type":"block","id":"wUt__8e831QPxZnLHVq7g","margin":"","level":1,"name":"head","location":{"start":{"line":8,"column":1,"offset":181},"end":{"line":9,"column":9,"offset":198}},"content":["SYNOPSIS"]},{"type":"block","id":"-zO7fVLbQsiAomJVGvJ3M","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":11,"column":1,"offset":200},"end":{"line":13,"column":4,"offset":225}},"content":[{"type":"verbatim","value":"use silently;"}]},{"type":"block","id":"nv4K3La5X-O6AmqbIAAoA","margin":"","level":1,"name":"head","location":{"start":{"line":15,"column":1,"offset":227},"end":{"line":16,"column":12,"offset":250}},"content":["DESCRIPTION"]},{"type":"para","id":"PugOKgwMmMk-d3IYy6-lD","margin":"","location":{"start":{"line":18,"column":1,"offset":252},"end":{"line":18,"column":211,"offset":462}},"text":"text","content":["silently is module that exports a single sub called ",{"type":"fcode","name":"C","content":["silently"]}," that takes a block to execute. Inside that block, all textual output to ",{"type":"fcode","name":"F","content":[{"type":"text","value":"*OUT and "}]},"*ERR is prevented from actually being sent to STDOUT and STDERR."]},{"type":"para","id":"p2Mh2Rn9BO_Wh_YmllK-s","margin":"","location":{"start":{"line":20,"column":1,"offset":464},"end":{"line":20,"column":120,"offset":583}},"text":"text","content":["Note that if you're only interested in surpressing output from warnings, you should use the ",{"type":"fcode","name":"C","content":["quietly"]}," statement prefix."]},{"type":"block","id":"CnXWA7mx0v5U0nWavPpGa","margin":"","level":1,"name":"head","location":{"start":{"line":22,"column":1,"offset":585},"end":{"line":23,"column":12,"offset":608}},"content":["SUBROUTINES"]},{"type":"block","id":"jaHlixQwmRretr6O0H_cu","margin":"","level":2,"name":"head","location":{"start":{"line":25,"column":1,"offset":610},"end":{"line":26,"column":9,"offset":627}},"content":["silently"]},{"type":"block","id":"-r3ED1dmXG8XF8DM_erRV","margin":"","name":"code","config":[],"location":{"start":{"line":28,"column":1,"offset":629},"end":{"line":33,"column":6,"offset":809}},"content":[{"type":"verbatim","value":"silently { say \"hello world\" }  # no output\n\nmy $captured = silently { note \"tis wrong\" }\nif $captured.err -> $error {\n    say \"something went wrong: $error\";\n}"}]},{"type":"para","id":"CcHVeJWDD_DbGv_u4_tIY","margin":"","location":{"start":{"line":35,"column":1,"offset":811},"end":{"line":35,"column":120,"offset":930}},"text":"text","content":["The \"silently\" subroutine takes a block as a parameter, and runs that block catching all output to ",{"type":"fcode","name":"C","content":["$*OUT"]}," and ",{"type":"fcode","name":"C","content":["$*ERR"]},"."]},{"type":"para","id":"Hzfexwh_0_hwVjUmaqNqN","margin":"","location":{"start":{"line":37,"column":1,"offset":932},"end":{"line":37,"column":190,"offset":1121}},"text":"text","content":["If the output is actually needed for inspection: the subroutine returns an object that provides two methods: ",{"type":"fcode","name":"C","content":["out"]}," and ",{"type":"fcode","name":"C","content":["err"]},", giving the captured output to ",{"type":"fcode","name":"C","content":["$*OUT"]}," and ",{"type":"fcode","name":"C","content":["$*ERR"]}," respectively."]},{"type":"block","id":"51xZcp1cr8jDiS50ZK8N0","margin":"","level":1,"name":"head","location":{"start":{"line":39,"column":1,"offset":1123},"end":{"line":40,"column":7,"offset":1136}},"content":["AUTHOR"]},{"type":"para","id":"t_j177g6sF9WRbS1vQ4Fc","margin":"","location":{"start":{"line":42,"column":1,"offset":1138},"end":{"line":42,"column":37,"offset":1174}},"text":"text","content":["Elizabeth Mattijsen ",{"meta":"mailto:liz@raku.rocks","type":"fcode","name":"L","content":["liz@raku.rocks"]}]},{"type":"para","id":"Q2yUXXE9ZqAqY5Jgwbs_Z","margin":"","location":{"start":{"line":44,"column":1,"offset":1176},"end":{"line":44,"column":103,"offset":1278}},"text":"text","content":["Source can be located at: ",{"meta":"https://github.com/lizmat/silently","type":"fcode","name":"L","content":["https://github.com/lizmat/silently"]}," . Comments and Pull Requests are welcome."]},{"type":"block","id":"aSHlcCaZgTLqWEMIrSHN8","margin":"","level":1,"name":"head","location":{"start":{"line":46,"column":1,"offset":1280},"end":{"line":47,"column":22,"offset":1323}},"content":["COPYRIGHT AND LICENSE"]},{"type":"para","id":"FgNayQcXQU28PoC5QSJR4","margin":"","location":{"start":{"line":49,"column":1,"offset":1325},"end":{"line":49,"column":41,"offset":1365}},"text":"text","content":["Copyright 2020, 2021 Elizabeth Mattijsen"]},{"type":"para","id":"2k_RlKnPPN1WniwzY_CwG","margin":"","location":{"start":{"line":51,"column":1,"offset":1367},"end":{"line":51,"column":104,"offset":1470}},"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/silently/silently-0.0.4/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"","auth":"zef:lizmat","authors":["Elizabeth Mattijsen"],"build-depends":[],"depends":[],"description":"prevent any output from a block","dist":"silently:ver<0.0.4>:auth<zef:lizmat>","license":"Artistic-2.0","name":"silently","path":"S/IL/SILENTLY/74da0bb7940947ac6f7d56bff6ee122aae351e63.tar.gz","perl":"6.c","provides":{"silently":"lib/silently.rakumod"},"resources":[],"source-url":"https://github.com/lizmat/silently.git","tags":["OUTPUT"],"test-depends":[],"version":"0.0.4"},"files":[{"file":"work_mods/zef/silently/silently-0.0.4/README.md","publishUrl":"/mods/zef/silently/silently-0.0.4/README.md"},{"file":"work_mods/zef/silently/silently-0.0.4/lib/silently.rakumod","publishUrl":"/mods/zef/silently/silently-0.0.4/lib/silently.rakumod"}],"src":"zef","url":"/mods/zef/silently"}}}
=end data


    =begin React :component<RenderItem>
    =begin data
    {"type":"page","file":"work_mods/zef/silently/silently-0.0.4/README.md","sources":[],"node":{"type":"block","id":"ciesT8Pz2L-88x-x0faz-","margin":"","name":"root","content":[{"type":"para","id":"orSy-Hc4DkrYBO6LdKY_X","margin":"","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":125,"offset":124}},"text":"text","content":[{"meta":"https://github.com/lizmat/silently/actions","type":"fcode","name":"L","content":[{"type":"block","id":"Lo1OpkJR_FQZ1kV0VcJEy","margin":"","name":"Image","config":[],"location":{"start":{"line":1,"column":2,"offset":1},"end":{"line":1,"column":80,"offset":79}},"content":[{"type":"image","src":"https://github.com/lizmat/silently/workflows/test/badge.svg","alt":"Actions Status"}]}]}]},{"type":"block","id":"xN0sh1GH8hthED-H6SX6E","margin":"","level":1,"name":"head","location":{"start":{"line":3,"column":1,"offset":126},"end":{"line":4,"column":5,"offset":135}},"content":["NAME"]},{"type":"para","id":"g25iHLfaFQb2hUG8RkB0a","margin":"","location":{"start":{"line":6,"column":1,"offset":137},"end":{"line":6,"column":43,"offset":179}},"text":"text","content":["silently - prevent any output from a block"]},{"type":"block","id":"wUt__8e831QPxZnLHVq7g","margin":"","level":1,"name":"head","location":{"start":{"line":8,"column":1,"offset":181},"end":{"line":9,"column":9,"offset":198}},"content":["SYNOPSIS"]},{"type":"block","id":"-zO7fVLbQsiAomJVGvJ3M","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":11,"column":1,"offset":200},"end":{"line":13,"column":4,"offset":225}},"content":[{"type":"verbatim","value":"use silently;"}]},{"type":"block","id":"nv4K3La5X-O6AmqbIAAoA","margin":"","level":1,"name":"head","location":{"start":{"line":15,"column":1,"offset":227},"end":{"line":16,"column":12,"offset":250}},"content":["DESCRIPTION"]},{"type":"para","id":"PugOKgwMmMk-d3IYy6-lD","margin":"","location":{"start":{"line":18,"column":1,"offset":252},"end":{"line":18,"column":211,"offset":462}},"text":"text","content":["silently is module that exports a single sub called ",{"type":"fcode","name":"C","content":["silently"]}," that takes a block to execute. Inside that block, all textual output to ",{"type":"fcode","name":"F","content":[{"type":"text","value":"*OUT and "}]},"*ERR is prevented from actually being sent to STDOUT and STDERR."]},{"type":"para","id":"p2Mh2Rn9BO_Wh_YmllK-s","margin":"","location":{"start":{"line":20,"column":1,"offset":464},"end":{"line":20,"column":120,"offset":583}},"text":"text","content":["Note that if you're only interested in surpressing output from warnings, you should use the ",{"type":"fcode","name":"C","content":["quietly"]}," statement prefix."]},{"type":"block","id":"CnXWA7mx0v5U0nWavPpGa","margin":"","level":1,"name":"head","location":{"start":{"line":22,"column":1,"offset":585},"end":{"line":23,"column":12,"offset":608}},"content":["SUBROUTINES"]},{"type":"block","id":"jaHlixQwmRretr6O0H_cu","margin":"","level":2,"name":"head","location":{"start":{"line":25,"column":1,"offset":610},"end":{"line":26,"column":9,"offset":627}},"content":["silently"]},{"type":"block","id":"-r3ED1dmXG8XF8DM_erRV","margin":"","name":"code","config":[],"location":{"start":{"line":28,"column":1,"offset":629},"end":{"line":33,"column":6,"offset":809}},"content":[{"type":"verbatim","value":"silently { say \"hello world\" }  # no output\n\nmy $captured = silently { note \"tis wrong\" }\nif $captured.err -> $error {\n    say \"something went wrong: $error\";\n}"}]},{"type":"para","id":"CcHVeJWDD_DbGv_u4_tIY","margin":"","location":{"start":{"line":35,"column":1,"offset":811},"end":{"line":35,"column":120,"offset":930}},"text":"text","content":["The \"silently\" subroutine takes a block as a parameter, and runs that block catching all output to ",{"type":"fcode","name":"C","content":["$*OUT"]}," and ",{"type":"fcode","name":"C","content":["$*ERR"]},"."]},{"type":"para","id":"Hzfexwh_0_hwVjUmaqNqN","margin":"","location":{"start":{"line":37,"column":1,"offset":932},"end":{"line":37,"column":190,"offset":1121}},"text":"text","content":["If the output is actually needed for inspection: the subroutine returns an object that provides two methods: ",{"type":"fcode","name":"C","content":["out"]}," and ",{"type":"fcode","name":"C","content":["err"]},", giving the captured output to ",{"type":"fcode","name":"C","content":["$*OUT"]}," and ",{"type":"fcode","name":"C","content":["$*ERR"]}," respectively."]},{"type":"block","id":"51xZcp1cr8jDiS50ZK8N0","margin":"","level":1,"name":"head","location":{"start":{"line":39,"column":1,"offset":1123},"end":{"line":40,"column":7,"offset":1136}},"content":["AUTHOR"]},{"type":"para","id":"t_j177g6sF9WRbS1vQ4Fc","margin":"","location":{"start":{"line":42,"column":1,"offset":1138},"end":{"line":42,"column":37,"offset":1174}},"text":"text","content":["Elizabeth Mattijsen ",{"meta":"mailto:liz@raku.rocks","type":"fcode","name":"L","content":["liz@raku.rocks"]}]},{"type":"para","id":"Q2yUXXE9ZqAqY5Jgwbs_Z","margin":"","location":{"start":{"line":44,"column":1,"offset":1176},"end":{"line":44,"column":103,"offset":1278}},"text":"text","content":["Source can be located at: ",{"meta":"https://github.com/lizmat/silently","type":"fcode","name":"L","content":["https://github.com/lizmat/silently"]}," . Comments and Pull Requests are welcome."]},{"type":"block","id":"aSHlcCaZgTLqWEMIrSHN8","margin":"","level":1,"name":"head","location":{"start":{"line":46,"column":1,"offset":1280},"end":{"line":47,"column":22,"offset":1323}},"content":["COPYRIGHT AND LICENSE"]},{"type":"para","id":"FgNayQcXQU28PoC5QSJR4","margin":"","location":{"start":{"line":49,"column":1,"offset":1325},"end":{"line":49,"column":41,"offset":1365}},"text":"text","content":["Copyright 2020, 2021 Elizabeth Mattijsen"]},{"type":"para","id":"2k_RlKnPPN1WniwzY_CwG","margin":"","location":{"start":{"line":51,"column":1,"offset":1367},"end":{"line":51,"column":104,"offset":1470}},"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/silently/silently-0.0.4/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"","auth":"zef:lizmat","authors":["Elizabeth Mattijsen"],"build-depends":[],"depends":[],"description":"prevent any output from a block","dist":"silently:ver<0.0.4>:auth<zef:lizmat>","license":"Artistic-2.0","name":"silently","path":"S/IL/SILENTLY/74da0bb7940947ac6f7d56bff6ee122aae351e63.tar.gz","perl":"6.c","provides":{"silently":"lib/silently.rakumod"},"resources":[],"source-url":"https://github.com/lizmat/silently.git","tags":["OUTPUT"],"test-depends":[],"version":"0.0.4"},"files":[{"file":"work_mods/zef/silently/silently-0.0.4/README.md","publishUrl":"/mods/zef/silently/silently-0.0.4/README.md"},{"file":"work_mods/zef/silently/silently-0.0.4/lib/silently.rakumod","publishUrl":"/mods/zef/silently/silently-0.0.4/lib/silently.rakumod"}],"src":"zef","url":"/mods/zef/silently"}}}
    =end data
    =end React


prevent any output from a block


silently


allow partial specification of sub-commands


=begin data
{"type":"page","file":"work_mods/zef/shorten-sub-commands/shorten-sub-commands-0.0.1/README.md","sources":[],"node":{"type":"block","id":"pXOWeXqcEx9ibJMtIhl45","margin":"","name":"root","content":[{"type":"para","id":"VucTq6MR84BXoKX8KfGi9","margin":"","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":149,"offset":148}},"text":"text","content":[{"meta":"https://github.com/lizmat/shorten-sub-commands/actions","type":"fcode","name":"L","content":[{"type":"block","id":"pPbWFtJIuwX12jiUuBRNu","margin":"","name":"Image","config":[],"location":{"start":{"line":1,"column":2,"offset":1},"end":{"line":1,"column":92,"offset":91}},"content":[{"type":"image","src":"https://github.com/lizmat/shorten-sub-commands/workflows/test/badge.svg","alt":"Actions Status"}]}]}]},{"type":"block","id":"numhYVaunaMHQpobGzeuM","margin":"","level":1,"name":"head","location":{"start":{"line":3,"column":1,"offset":150},"end":{"line":4,"column":5,"offset":159}},"content":["NAME"]},{"type":"para","id":"8FUPco4u8vDcTGiXmhTWn","margin":"","location":{"start":{"line":6,"column":1,"offset":161},"end":{"line":6,"column":67,"offset":227}},"text":"text","content":["shorten-sub-commands - allow partial specification of sub-commands"]},{"type":"block","id":"fUHkozSrkP90smAsYSufb","margin":"","level":1,"name":"head","location":{"start":{"line":8,"column":1,"offset":229},"end":{"line":9,"column":9,"offset":246}},"content":["SYNOPSIS"]},{"type":"block","id":"qAclI8Oq0M0diede8FgdB","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":11,"column":1,"offset":248},"end":{"line":24,"column":4,"offset":598}},"content":[{"type":"verbatim","value":"# in script \"frobnicate\"\nmulti sub MAIN(\"foozle\")  { say \"foozle\"  }\nmulti sub MAIN(\"barabas\") { say \"barabas\" }\nmulti sub MAIN(\"bazzie\")  { say \"bazzie\"  }\nuse shorten::sub::commands &MAIN;\n\n    $ raku frobnicate foo\n    foozle\n    $ raku frobnicate ba\n    'ba' is ambiguous, matches: barabas bazzie\n    $ raku frobnicate bar\n    barabas"}]},{"type":"block","id":"ogC2IRu36XLXI5MVDxnBt","margin":"","level":1,"name":"head","location":{"start":{"line":26,"column":1,"offset":600},"end":{"line":27,"column":12,"offset":623}},"content":["DESCRIPTION"]},{"type":"para","id":"4JuGk4JWniL1wZbbQjXRr","margin":"","location":{"start":{"line":29,"column":1,"offset":625},"end":{"line":29,"column":271,"offset":895}},"text":"text","content":["shorten::sub::commands is a helper module intended to be used for command-line application that have a sub-command structure (in which the first positional parameter indicates what needs to be done, and there is a separate candidate to handle execution of that command)."]},{"type":"para","id":"keIxLX0DwfoFpWAWuOBM9","margin":"","location":{"start":{"line":31,"column":1,"offset":897},"end":{"line":31,"column":272,"offset":1168}},"text":"text","content":["When used ",{"type":"fcode","name":"B","content":["after"]}," all ",{"type":"fcode","name":"C","content":["MAIN"]}," candidates have been defined, it will add another candidate that will allow to shorten the command names to be as short as possible (e.g. just \"foo\" in the example above, or even just \"f\" as there is only one candidate that starts with \"f\"."]},{"type":"block","id":"7CJKdER2DZzYphiHkQA89","margin":"","level":1,"name":"head","location":{"start":{"line":33,"column":1,"offset":1170},"end":{"line":34,"column":7,"offset":1183}},"content":["AUTHOR"]},{"type":"para","id":"ON5KpLjaEIq0XB6zt7dq0","margin":"","location":{"start":{"line":36,"column":1,"offset":1185},"end":{"line":36,"column":37,"offset":1221}},"text":"text","content":["Elizabeth Mattijsen ",{"meta":"mailto:liz@raku.rocks","type":"fcode","name":"L","content":["liz@raku.rocks"]}]},{"type":"para","id":"ds7x8YFAgD_NVIvst8rO2","margin":"","location":{"start":{"line":38,"column":1,"offset":1223},"end":{"line":38,"column":115,"offset":1337}},"text":"text","content":["Source can be located at: ",{"meta":"https://github.com/lizmat/shorten-sub-commands","type":"fcode","name":"L","content":["https://github.com/lizmat/shorten-sub-commands"]}," . Comments and Pull Requests are welcome."]},{"type":"block","id":"wdXWhjT7LHJwsXF-KFapf","margin":"","level":1,"name":"head","location":{"start":{"line":40,"column":1,"offset":1339},"end":{"line":41,"column":22,"offset":1382}},"content":["COPYRIGHT AND LICENSE"]},{"type":"para","id":"Y56uioJwUiiSeiW-WDu7Y","margin":"","location":{"start":{"line":43,"column":1,"offset":1384},"end":{"line":43,"column":35,"offset":1418}},"text":"text","content":["Copyright 2022 Elizabeth Mattijsen"]},{"type":"para","id":"K1Ew2ASYYNwFUoKrBO_2p","margin":"","location":{"start":{"line":45,"column":1,"offset":1420},"end":{"line":45,"column":104,"offset":1523}},"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/shorten-sub-commands/shorten-sub-commands-0.0.1/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"","auth":"zef:lizmat","authors":["Elizabeth Mattijsen"],"build-depends":[],"depends":[],"description":"allow partial specification of sub-commands","dist":"shorten-sub-commands:ver<0.0.1>:auth<zef:lizmat>","license":"Artistic-2.0","name":"shorten-sub-commands","path":"S/HO/SHORTENSUBCOMMANDS/09951a384947d3d662e19979bbd66819bfdcdc2e.tar.gz","perl":"6.d","provides":{"shorten-sub-commands":"lib/shorten-sub-commands.rakumod"},"resources":[],"source-url":"https://github.com/lizmat/shorten-sub-commands.git","tags":[],"test-depends":[],"version":"0.0.1"},"files":[{"file":"work_mods/zef/shorten-sub-commands/shorten-sub-commands-0.0.1/README.md","publishUrl":"/mods/zef/shorten-sub-commands/shorten-sub-commands-0.0.1/README.md"},{"file":"work_mods/zef/shorten-sub-commands/shorten-sub-commands-0.0.1/lib/shorten-sub-commands.rakumod","publishUrl":"/mods/zef/shorten-sub-commands/shorten-sub-commands-0.0.1/lib/shorten-sub-commands.rakumod"}],"src":"zef","url":"/mods/zef/shorten-sub-commands"}}}
=end data


    =begin React :component<RenderItem>
    =begin data
    {"type":"page","file":"work_mods/zef/shorten-sub-commands/shorten-sub-commands-0.0.1/README.md","sources":[],"node":{"type":"block","id":"pXOWeXqcEx9ibJMtIhl45","margin":"","name":"root","content":[{"type":"para","id":"VucTq6MR84BXoKX8KfGi9","margin":"","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":149,"offset":148}},"text":"text","content":[{"meta":"https://github.com/lizmat/shorten-sub-commands/actions","type":"fcode","name":"L","content":[{"type":"block","id":"pPbWFtJIuwX12jiUuBRNu","margin":"","name":"Image","config":[],"location":{"start":{"line":1,"column":2,"offset":1},"end":{"line":1,"column":92,"offset":91}},"content":[{"type":"image","src":"https://github.com/lizmat/shorten-sub-commands/workflows/test/badge.svg","alt":"Actions Status"}]}]}]},{"type":"block","id":"numhYVaunaMHQpobGzeuM","margin":"","level":1,"name":"head","location":{"start":{"line":3,"column":1,"offset":150},"end":{"line":4,"column":5,"offset":159}},"content":["NAME"]},{"type":"para","id":"8FUPco4u8vDcTGiXmhTWn","margin":"","location":{"start":{"line":6,"column":1,"offset":161},"end":{"line":6,"column":67,"offset":227}},"text":"text","content":["shorten-sub-commands - allow partial specification of sub-commands"]},{"type":"block","id":"fUHkozSrkP90smAsYSufb","margin":"","level":1,"name":"head","location":{"start":{"line":8,"column":1,"offset":229},"end":{"line":9,"column":9,"offset":246}},"content":["SYNOPSIS"]},{"type":"block","id":"qAclI8Oq0M0diede8FgdB","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":11,"column":1,"offset":248},"end":{"line":24,"column":4,"offset":598}},"content":[{"type":"verbatim","value":"# in script \"frobnicate\"\nmulti sub MAIN(\"foozle\")  { say \"foozle\"  }\nmulti sub MAIN(\"barabas\") { say \"barabas\" }\nmulti sub MAIN(\"bazzie\")  { say \"bazzie\"  }\nuse shorten::sub::commands &MAIN;\n\n    $ raku frobnicate foo\n    foozle\n    $ raku frobnicate ba\n    'ba' is ambiguous, matches: barabas bazzie\n    $ raku frobnicate bar\n    barabas"}]},{"type":"block","id":"ogC2IRu36XLXI5MVDxnBt","margin":"","level":1,"name":"head","location":{"start":{"line":26,"column":1,"offset":600},"end":{"line":27,"column":12,"offset":623}},"content":["DESCRIPTION"]},{"type":"para","id":"4JuGk4JWniL1wZbbQjXRr","margin":"","location":{"start":{"line":29,"column":1,"offset":625},"end":{"line":29,"column":271,"offset":895}},"text":"text","content":["shorten::sub::commands is a helper module intended to be used for command-line application that have a sub-command structure (in which the first positional parameter indicates what needs to be done, and there is a separate candidate to handle execution of that command)."]},{"type":"para","id":"keIxLX0DwfoFpWAWuOBM9","margin":"","location":{"start":{"line":31,"column":1,"offset":897},"end":{"line":31,"column":272,"offset":1168}},"text":"text","content":["When used ",{"type":"fcode","name":"B","content":["after"]}," all ",{"type":"fcode","name":"C","content":["MAIN"]}," candidates have been defined, it will add another candidate that will allow to shorten the command names to be as short as possible (e.g. just \"foo\" in the example above, or even just \"f\" as there is only one candidate that starts with \"f\"."]},{"type":"block","id":"7CJKdER2DZzYphiHkQA89","margin":"","level":1,"name":"head","location":{"start":{"line":33,"column":1,"offset":1170},"end":{"line":34,"column":7,"offset":1183}},"content":["AUTHOR"]},{"type":"para","id":"ON5KpLjaEIq0XB6zt7dq0","margin":"","location":{"start":{"line":36,"column":1,"offset":1185},"end":{"line":36,"column":37,"offset":1221}},"text":"text","content":["Elizabeth Mattijsen ",{"meta":"mailto:liz@raku.rocks","type":"fcode","name":"L","content":["liz@raku.rocks"]}]},{"type":"para","id":"ds7x8YFAgD_NVIvst8rO2","margin":"","location":{"start":{"line":38,"column":1,"offset":1223},"end":{"line":38,"column":115,"offset":1337}},"text":"text","content":["Source can be located at: ",{"meta":"https://github.com/lizmat/shorten-sub-commands","type":"fcode","name":"L","content":["https://github.com/lizmat/shorten-sub-commands"]}," . Comments and Pull Requests are welcome."]},{"type":"block","id":"wdXWhjT7LHJwsXF-KFapf","margin":"","level":1,"name":"head","location":{"start":{"line":40,"column":1,"offset":1339},"end":{"line":41,"column":22,"offset":1382}},"content":["COPYRIGHT AND LICENSE"]},{"type":"para","id":"Y56uioJwUiiSeiW-WDu7Y","margin":"","location":{"start":{"line":43,"column":1,"offset":1384},"end":{"line":43,"column":35,"offset":1418}},"text":"text","content":["Copyright 2022 Elizabeth Mattijsen"]},{"type":"para","id":"K1Ew2ASYYNwFUoKrBO_2p","margin":"","location":{"start":{"line":45,"column":1,"offset":1420},"end":{"line":45,"column":104,"offset":1523}},"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/shorten-sub-commands/shorten-sub-commands-0.0.1/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"","auth":"zef:lizmat","authors":["Elizabeth Mattijsen"],"build-depends":[],"depends":[],"description":"allow partial specification of sub-commands","dist":"shorten-sub-commands:ver<0.0.1>:auth<zef:lizmat>","license":"Artistic-2.0","name":"shorten-sub-commands","path":"S/HO/SHORTENSUBCOMMANDS/09951a384947d3d662e19979bbd66819bfdcdc2e.tar.gz","perl":"6.d","provides":{"shorten-sub-commands":"lib/shorten-sub-commands.rakumod"},"resources":[],"source-url":"https://github.com/lizmat/shorten-sub-commands.git","tags":[],"test-depends":[],"version":"0.0.1"},"files":[{"file":"work_mods/zef/shorten-sub-commands/shorten-sub-commands-0.0.1/README.md","publishUrl":"/mods/zef/shorten-sub-commands/shorten-sub-commands-0.0.1/README.md"},{"file":"work_mods/zef/shorten-sub-commands/shorten-sub-commands-0.0.1/lib/shorten-sub-commands.rakumod","publishUrl":"/mods/zef/shorten-sub-commands/shorten-sub-commands-0.0.1/lib/shorten-sub-commands.rakumod"}],"src":"zef","url":"/mods/zef/shorten-sub-commands"}}}
    =end data
    =end React


shorten-sub-commands


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


sigpipe

NAME

SYNOPSIS

DESCRIPTION

AUTHOR

COPYRIGHT AND LICENSE

sigpipe v0.0.1

Authors

License

Dependencies

Test Dependencies

Provides

Documentation