TITLE

SUBTITLE

data

=begin data
{"type":"page","file":"work_mods/zef/Subsets::Common/dist/README.md","sources":[],"node":{"type":"block","id":"JTaG8F5qTpNVeIHHkIr5C","margin":"","name":"root","content":[{"type":"para","id":"Yt75rN2PfTRFCXUSFhwdk","margin":"","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":2,"column":135,"offset":250}},"text":"text","content":[{"meta":"https://opensource.org/licenses/BSD-2-Clause","type":"fcode","name":"L","content":[{"type":"block","id":"98GhthuSN4O-XufnXMfYB","margin":"","name":"Image","config":[],"location":{"start":{"line":1,"column":2,"offset":1},"end":{"line":1,"column":69,"offset":68}},"content":[{"type":"image","src":"https://img.shields.io/badge/License-BSD-yellow.svg","alt":"License:BSD"}]}]},"\n",{"meta":"https://github.com/bradclawsie/Subsets-Common/actions","type":"fcode","name":"L","content":[{"type":"block","id":"dvjv00hHcrido1R_lWtm1","margin":"","name":"Image","config":[],"location":{"start":{"line":2,"column":2,"offset":117},"end":{"line":2,"column":79,"offset":194}},"content":[{"type":"image","src":"https://github.com/bradclawsie/Subsets-Common/workflows/test/badge.svg","alt":"ci"}]}]}]},{"type":"para","id":"SPiE1PsRSLAJMhql_wg-p","margin":"","location":{"start":{"line":4,"column":1,"offset":252},"end":{"line":4,"column":66,"offset":317}},"text":"text","content":["This module is intended to provide a resource for common subsets."]},{"type":"para","id":"dShoUwUaZuUEzwTol_JDe","margin":"","location":{"start":{"line":6,"column":1,"offset":319},"end":{"line":6,"column":64,"offset":382}},"text":"text","content":["Please submit patches for any new subsets you find interesting."]},{"type":"para","id":"XLXKN5hBgWf2GxFplgmWZ","margin":"","location":{"start":{"line":8,"column":1,"offset":384},"end":{"line":8,"column":81,"offset":464}},"text":"text","content":["The goal is to prevent needless duplication and redefinition of obvious subsets."]},{"type":"para","id":"p0XWkS9obTyIEZqBo-ygb","margin":"","location":{"start":{"line":10,"column":1,"offset":466},"end":{"line":10,"column":59,"offset":524}},"text":"text","content":["Thanks to everyone who has contributed issues and patches."]},{"type":"block","id":"bGQdmb1g3JImcZ3gOcR4H","margin":"","level":2,"name":"head","location":{"start":{"line":12,"column":1,"offset":526},"end":{"line":12,"column":10,"offset":535}},"content":["Notice"]},{"type":"para","id":"Mm_e_dEp9HZotJo3un0v7","margin":"","location":{"start":{"line":14,"column":1,"offset":537},"end":{"line":16,"column":33,"offset":710}},"text":"text","content":["This repository was uploaded via ",{"type":"fcode","name":"C","content":["fez"]}," under the username ",{"type":"fcode","name":"C","content":["b7j0c"]},",\nand later ",{"type":"fcode","name":"C","content":["bradclawsie"]},". This change was made so the username would match\nGithub. Sorry for any confusion."]},{"type":"block","id":"eKdhAYerV4CK8A1ZFDffc","margin":"","level":2,"name":"head","location":{"start":{"line":18,"column":1,"offset":712},"end":{"line":18,"column":16,"offset":727}},"content":["Installation"]},{"type":"block","id":"Iwf561lbdS0beKYN1ILLa","margin":"","name":"code","config":[],"location":{"start":{"line":20,"column":1,"offset":729},"end":{"line":22,"column":4,"offset":764}},"content":[{"type":"verbatim","value":"zef install Subsets::Common"}]}]},"publishUrl":"/mods/zef/Subsets::Common/dist/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"","auth":"zef:bradclawsie","author":"Brad Clawsie","depends":[],"description":"Some common subsets to built-in types.","dist":"Subsets::Common:ver<0.0.6>:auth<zef:bradclawsie>","license":"BSD-2-Clause","name":"Subsets::Common","path":"S/UB/SUBSETS_COMMON/cb8b9aff6369ece06eece7779af8bf68eb8d368a.tar.gz","perl":"6.*","provides":{"Subsets::Common":"lib/Subsets/Common.rakumod"},"source-url":"https://github.com/bradclawsie/Subsets-Common.git","version":"0.0.6"},"files":[{"file":"work_mods/zef/Subsets::Common/dist/README.md","publishUrl":"/mods/zef/Subsets::Common/dist/README.md"}],"src":"zef","url":"/mods/zef/Subsets::Common"}}}
=end data


React

    =begin React :component<RenderItem>
    =begin data
    {"type":"page","file":"work_mods/zef/Subsets::Common/dist/README.md","sources":[],"node":{"type":"block","id":"JTaG8F5qTpNVeIHHkIr5C","margin":"","name":"root","content":[{"type":"para","id":"Yt75rN2PfTRFCXUSFhwdk","margin":"","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":2,"column":135,"offset":250}},"text":"text","content":[{"meta":"https://opensource.org/licenses/BSD-2-Clause","type":"fcode","name":"L","content":[{"type":"block","id":"98GhthuSN4O-XufnXMfYB","margin":"","name":"Image","config":[],"location":{"start":{"line":1,"column":2,"offset":1},"end":{"line":1,"column":69,"offset":68}},"content":[{"type":"image","src":"https://img.shields.io/badge/License-BSD-yellow.svg","alt":"License:BSD"}]}]},"\n",{"meta":"https://github.com/bradclawsie/Subsets-Common/actions","type":"fcode","name":"L","content":[{"type":"block","id":"dvjv00hHcrido1R_lWtm1","margin":"","name":"Image","config":[],"location":{"start":{"line":2,"column":2,"offset":117},"end":{"line":2,"column":79,"offset":194}},"content":[{"type":"image","src":"https://github.com/bradclawsie/Subsets-Common/workflows/test/badge.svg","alt":"ci"}]}]}]},{"type":"para","id":"SPiE1PsRSLAJMhql_wg-p","margin":"","location":{"start":{"line":4,"column":1,"offset":252},"end":{"line":4,"column":66,"offset":317}},"text":"text","content":["This module is intended to provide a resource for common subsets."]},{"type":"para","id":"dShoUwUaZuUEzwTol_JDe","margin":"","location":{"start":{"line":6,"column":1,"offset":319},"end":{"line":6,"column":64,"offset":382}},"text":"text","content":["Please submit patches for any new subsets you find interesting."]},{"type":"para","id":"XLXKN5hBgWf2GxFplgmWZ","margin":"","location":{"start":{"line":8,"column":1,"offset":384},"end":{"line":8,"column":81,"offset":464}},"text":"text","content":["The goal is to prevent needless duplication and redefinition of obvious subsets."]},{"type":"para","id":"p0XWkS9obTyIEZqBo-ygb","margin":"","location":{"start":{"line":10,"column":1,"offset":466},"end":{"line":10,"column":59,"offset":524}},"text":"text","content":["Thanks to everyone who has contributed issues and patches."]},{"type":"block","id":"bGQdmb1g3JImcZ3gOcR4H","margin":"","level":2,"name":"head","location":{"start":{"line":12,"column":1,"offset":526},"end":{"line":12,"column":10,"offset":535}},"content":["Notice"]},{"type":"para","id":"Mm_e_dEp9HZotJo3un0v7","margin":"","location":{"start":{"line":14,"column":1,"offset":537},"end":{"line":16,"column":33,"offset":710}},"text":"text","content":["This repository was uploaded via ",{"type":"fcode","name":"C","content":["fez"]}," under the username ",{"type":"fcode","name":"C","content":["b7j0c"]},",\nand later ",{"type":"fcode","name":"C","content":["bradclawsie"]},". This change was made so the username would match\nGithub. Sorry for any confusion."]},{"type":"block","id":"eKdhAYerV4CK8A1ZFDffc","margin":"","level":2,"name":"head","location":{"start":{"line":18,"column":1,"offset":712},"end":{"line":18,"column":16,"offset":727}},"content":["Installation"]},{"type":"block","id":"Iwf561lbdS0beKYN1ILLa","margin":"","name":"code","config":[],"location":{"start":{"line":20,"column":1,"offset":729},"end":{"line":22,"column":4,"offset":764}},"content":[{"type":"verbatim","value":"zef install Subsets::Common"}]}]},"publishUrl":"/mods/zef/Subsets::Common/dist/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"","auth":"zef:bradclawsie","author":"Brad Clawsie","depends":[],"description":"Some common subsets to built-in types.","dist":"Subsets::Common:ver<0.0.6>:auth<zef:bradclawsie>","license":"BSD-2-Clause","name":"Subsets::Common","path":"S/UB/SUBSETS_COMMON/cb8b9aff6369ece06eece7779af8bf68eb8d368a.tar.gz","perl":"6.*","provides":{"Subsets::Common":"lib/Subsets/Common.rakumod"},"source-url":"https://github.com/bradclawsie/Subsets-Common.git","version":"0.0.6"},"files":[{"file":"work_mods/zef/Subsets::Common/dist/README.md","publishUrl":"/mods/zef/Subsets::Common/dist/README.md"}],"src":"zef","url":"/mods/zef/Subsets::Common"}}}
    =end data
    =end React


root

Some common subsets to built-in types.


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

Subsets::Common


Subsets for various types of `IO::Path` instances


=begin data
{"type":"page","file":"work_mods/zef/Subsets::IO/Subsets-IO-1.1/README.md","sources":[],"node":{"type":"block","id":"pnvb2YdUImNM44A5cGMbj","margin":"","name":"root","content":[{"type":"para","id":"9FWL39bD17BO7ZXP-LJrj","margin":"","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":173,"offset":172}},"text":"text","content":[{"meta":"https://github.com/raku-community-modules/Subsets-IO/actions","type":"fcode","name":"L","content":[{"type":"block","id":"vlG1wZVtqFmAcsWxfl39W","margin":"","name":"Image","config":[],"location":{"start":{"line":1,"column":2,"offset":1},"end":{"line":1,"column":110,"offset":109}},"content":[{"type":"image","src":"https://github.com/raku-community-modules/Subsets-IO/actions/workflows/test.yml/badge.svg","alt":"Actions Status"}]}]}]},{"type":"block","id":"AMptI5Ghl0curHfEqftwp","margin":"","level":1,"name":"head","location":{"start":{"line":3,"column":1,"offset":174},"end":{"line":4,"column":5,"offset":183}},"content":["NAME"]},{"type":"para","id":"kXvpFXMM0dFr2XOuZ18Os","margin":"","location":{"start":{"line":6,"column":1,"offset":185},"end":{"line":6,"column":66,"offset":250}},"text":"text","content":[{"type":"fcode","name":"C","content":["Subsets::IO"]}," - Subsets for various types of ",{"type":"fcode","name":"C","content":["IO::Path"]}," instances"]},{"type":"block","id":"B3Uc7bRG53-V1fbtSLs8b","margin":"","level":1,"name":"head","location":{"start":{"line":8,"column":1,"offset":252},"end":{"line":9,"column":9,"offset":269}},"content":["SYNOPSIS"]},{"type":"block","id":"5p0-JbjVSKAwpNLJRvJuJ","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":11,"column":1,"offset":271},"end":{"line":16,"column":4,"offset":377}},"content":[{"type":"verbatim","value":"use Subsets::IO;\n\nsay \"Our script is writable and readable\"\n    if $?FILE.IO ~~ IO::Path::frw;"}]},{"type":"block","id":"3BAQjiez68p1eB3B4v_kq","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":18,"column":1,"offset":379},"end":{"line":32,"column":4,"offset":841}},"content":[{"type":"verbatim","value":"use Subsets::IO;\n\nsub make-conf($conf where IO::Path::dw | IO::Path::fw) {\n    say \"$conf is either a writable directory or a writable file\";\n}\n\nsub make-conf-file(IO::Path::E $conf) {\n    say \"$conf is a non-existent path\";\n}\nmake-conf-file $?FILE.IO;\n# Path must NOT exist Got /home/zoffix/CPANPRC/Subsets-IO/foo.p6\n# Constraint type check failed in binding to parameter '$conf';\n#   expected IO::Path::E but got IO::Path (IO::Path.new(\"/home/z...)"}]},{"type":"block","id":"Gl7j0gAQ0C6eEJCk1UgY8","margin":"","level":1,"name":"head","location":{"start":{"line":34,"column":1,"offset":843},"end":{"line":35,"column":12,"offset":866}},"content":["DESCRIPTION"]},{"type":"para","id":"rD4BumnOwSpzYep688NaE","margin":"","location":{"start":{"line":37,"column":1,"offset":868},"end":{"line":37,"column":336,"offset":1203}},"text":"text","content":["The module provides subsets of ",{"meta":"https://docs.raku.org/type/IO::Path","type":"fcode","name":"L","content":[{"type":"fcode","name":"C","content":["IO::Path:D"]}]}," that additionally perform file tests and either uses the new ",{"type":"fcode","name":"C","content":["will complain"]}," (since Rakudo 2022.04) feature, or uses ",{"meta":"https://raku.land/zef:raku-community-modules/Subset::Helper","type":"fcode","name":"L","content":[{"type":"fcode","name":"C","content":["Subset::Helper"]}]}," to display useful error messages on typecheck failures."]},{"type":"block","id":"bAxPm9o9al_xVttars28r","margin":"","level":1,"name":"head","location":{"start":{"line":39,"column":1,"offset":1205},"end":{"line":40,"column":18,"offset":1240}},"content":["AVAILABLE SUBSETS"]},{"type":"block","id":"a3Y9W2M9e9r_zaoIUbh47","margin":"","level":2,"name":"head","location":{"start":{"line":42,"column":1,"offset":1242},"end":{"line":43,"column":13,"offset":1267}},"content":["IO::Path::e`"]},{"type":"para","id":"JkYJrgg_tZOlMQOGd8jpZ","margin":"","location":{"start":{"line":45,"column":1,"offset":1269},"end":{"line":45,"column":17,"offset":1285}},"text":"text","content":["Path must exist."]},{"type":"block","id":"4wWKVO0xqpR98Re35N1y_","margin":"","level":2,"name":"head","location":{"start":{"line":47,"column":1,"offset":1287},"end":{"line":48,"column":13,"offset":1312}},"content":["IO::Path::E`"]},{"type":"para","id":"iohW5vW7QCY9TMm3JpIqv","margin":"","location":{"start":{"line":50,"column":1,"offset":1314},"end":{"line":50,"column":21,"offset":1334}},"text":"text","content":["Path must NOT exist."]},{"type":"block","id":"voTqjLNmJe_nRl6a4S64X","margin":"","level":2,"name":"head","location":{"start":{"line":52,"column":1,"offset":1336},"end":{"line":53,"column":13,"offset":1361}},"content":["IO::Path::f`"]},{"type":"para","id":"Q4ZiyzQWWqwXiTIC25pRk","margin":"","location":{"start":{"line":55,"column":1,"offset":1363},"end":{"line":55,"column":31,"offset":1393}},"text":"text","content":["Path must be an existing file."]},{"type":"block","id":"-kb5vGnokNIQUQd44liKh","margin":"","level":2,"name":"head","location":{"start":{"line":57,"column":1,"offset":1395},"end":{"line":58,"column":13,"offset":1420}},"content":["IO::Path::F`"]},{"type":"para","id":"lMXCG1iiRwK5K2OExP4mw","margin":"","location":{"start":{"line":60,"column":1,"offset":1422},"end":{"line":60,"column":35,"offset":1456}},"text":"text","content":["Path must NOT be an existing file."]},{"type":"block","id":"y_-QHDsI27HwLs83MesH7","margin":"","level":2,"name":"head","location":{"start":{"line":62,"column":1,"offset":1458},"end":{"line":63,"column":13,"offset":1483}},"content":["IO::Path::d`"]},{"type":"para","id":"66RqWfrgBRWQqsZFX9K3s","margin":"","location":{"start":{"line":65,"column":1,"offset":1485},"end":{"line":65,"column":36,"offset":1520}},"text":"text","content":["Path must be an existing directory."]},{"type":"block","id":"m8upey3cYfNZEpXvFJfA5","margin":"","level":2,"name":"head","location":{"start":{"line":67,"column":1,"offset":1522},"end":{"line":68,"column":13,"offset":1547}},"content":["IO::Path::D`"]},{"type":"para","id":"5uTfugcsT_OLv-_FvC-8y","margin":"","location":{"start":{"line":70,"column":1,"offset":1549},"end":{"line":70,"column":40,"offset":1588}},"text":"text","content":["Path must NOT be an existing directory."]},{"type":"block","id":"EnClFmCNSDAZ6lexa2CS8","margin":"","level":2,"name":"head","location":{"start":{"line":72,"column":1,"offset":1590},"end":{"line":73,"column":14,"offset":1617}},"content":["IO::Path::fr`"]},{"type":"para","id":"Rnk4iTesFiRLMHX0Z1F55","margin":"","location":{"start":{"line":75,"column":1,"offset":1619},"end":{"line":75,"column":41,"offset":1659}},"text":"text","content":["Path must be an existing, readable file."]},{"type":"block","id":"4cSkWToSw5N6JLRTcXyBd","margin":"","level":2,"name":"head","location":{"start":{"line":77,"column":1,"offset":1661},"end":{"line":78,"column":15,"offset":1690}},"content":["IO::Path::frw`"]},{"type":"para","id":"mGnqPjnV0YbmyiItsln_v","margin":"","location":{"start":{"line":80,"column":1,"offset":1692},"end":{"line":80,"column":54,"offset":1745}},"text":"text","content":["Path must be an existing, readable and writable file."]},{"type":"block","id":"LBHjxLyvHlSy-Dr52Y6Bt","margin":"","level":2,"name":"head","location":{"start":{"line":82,"column":1,"offset":1747},"end":{"line":83,"column":15,"offset":1776}},"content":["IO::Path::frx`"]},{"type":"para","id":"v7gAVB-y3O5kaFL2qaLB8","margin":"","location":{"start":{"line":85,"column":1,"offset":1778},"end":{"line":85,"column":56,"offset":1833}},"text":"text","content":["Path must be an existing, readable and executable file."]},{"type":"block","id":"JAm-5A6_wrmfb1lw-F3wH","margin":"","level":2,"name":"head","location":{"start":{"line":87,"column":1,"offset":1835},"end":{"line":88,"column":15,"offset":1864}},"content":["IO::Path::fwx`"]},{"type":"para","id":"5lldPsZiOblWJjutF9Z3-","margin":"","location":{"start":{"line":90,"column":1,"offset":1866},"end":{"line":90,"column":57,"offset":1922}},"text":"text","content":["Path must be an existing, writeable and executable file."]},{"type":"block","id":"AHEkKUFg1SBskNwqFhA7z","margin":"","level":2,"name":"head","location":{"start":{"line":92,"column":1,"offset":1924},"end":{"line":93,"column":16,"offset":1955}},"content":["IO::Path::frwx`"]},{"type":"para","id":"rDRqDvkv3Vf-MX-ZtqSN7","margin":"","location":{"start":{"line":95,"column":1,"offset":1957},"end":{"line":95,"column":67,"offset":2023}},"text":"text","content":["Path must be an existing, readable, writable, and executable file."]},{"type":"block","id":"AhNUtjM6AIUjmRr5CApuj","margin":"","level":2,"name":"head","location":{"start":{"line":97,"column":1,"offset":2025},"end":{"line":98,"column":14,"offset":2052}},"content":["IO::Path::dr`"]},{"type":"para","id":"fIHKmqoeY8BZCf6LaVpa6","margin":"","location":{"start":{"line":100,"column":1,"offset":2054},"end":{"line":100,"column":46,"offset":2099}},"text":"text","content":["Path must be an existing, readable directory."]},{"type":"block","id":"4bj6GX46iKlrqVy1Tw-Zu","margin":"","level":2,"name":"head","location":{"start":{"line":102,"column":1,"offset":2101},"end":{"line":103,"column":15,"offset":2130}},"content":["IO::Path::drw`"]},{"type":"para","id":"Rcpf4a_WBu0DGDcxkZup_","margin":"","location":{"start":{"line":105,"column":1,"offset":2132},"end":{"line":105,"column":59,"offset":2190}},"text":"text","content":["Path must be an existing, readable and writable directory."]},{"type":"block","id":"XhppyQPkkCFJUqN41qjJe","margin":"","level":2,"name":"head","location":{"start":{"line":107,"column":1,"offset":2192},"end":{"line":108,"column":15,"offset":2221}},"content":["IO::Path::drx`"]},{"type":"para","id":"oJDG_M52oEXCzbFR7n0dV","margin":"","location":{"start":{"line":110,"column":1,"offset":2223},"end":{"line":110,"column":61,"offset":2283}},"text":"text","content":["Path must be an existing, readable and executable directory."]},{"type":"block","id":"-GGE7qm2LIrDoF_1eb-Dn","margin":"","level":2,"name":"head","location":{"start":{"line":112,"column":1,"offset":2285},"end":{"line":113,"column":15,"offset":2314}},"content":["IO::Path::dwx`"]},{"type":"para","id":"mk8ghDvbXfSSx607EGefR","margin":"","location":{"start":{"line":115,"column":1,"offset":2316},"end":{"line":115,"column":62,"offset":2377}},"text":"text","content":["Path must be an existing, writeable and executable directory."]},{"type":"block","id":"U1ASt4D_ovkyii9jRk0U2","margin":"","level":2,"name":"head","location":{"start":{"line":117,"column":1,"offset":2379},"end":{"line":118,"column":16,"offset":2410}},"content":["IO::Path::drwx`"]},{"type":"para","id":"SFcnw5tlc-CLFTFKHuc2p","margin":"","location":{"start":{"line":120,"column":1,"offset":2412},"end":{"line":120,"column":72,"offset":2483}},"text":"text","content":["Path must be an existing, readable, writable, and executable directory."]},{"type":"block","id":"8M-rKXk-5ajx0bZvLJQPO","margin":"","level":1,"name":"head","location":{"start":{"line":122,"column":1,"offset":2485},"end":{"line":123,"column":7,"offset":2498}},"content":["AUTHOR"]},{"type":"para","id":"zpktOrVAYJtlR64Sv5Mu0","margin":"","location":{"start":{"line":125,"column":1,"offset":2500},"end":{"line":125,"column":12,"offset":2511}},"text":"text","content":["Zoffix Znet"]},{"type":"block","id":"3auhPak7OmiOYJ_eQiYKB","margin":"","level":1,"name":"head","location":{"start":{"line":127,"column":1,"offset":2513},"end":{"line":128,"column":22,"offset":2556}},"content":["COPYRIGHT AND LICENSE"]},{"type":"para","id":"kZYd0NFBqLqFMEZHtH05z","margin":"","location":{"start":{"line":130,"column":1,"offset":2558},"end":{"line":130,"column":27,"offset":2584}},"text":"text","content":["Copyright 2018 Zoffix Znet"]},{"type":"para","id":"UTex9Ry3gq7PgkxJOfQvo","margin":"","location":{"start":{"line":132,"column":1,"offset":2586},"end":{"line":132,"column":37,"offset":2622}},"text":"text","content":["Copyright 2019 - 2022 Raku Community"]},{"type":"para","id":"TmdoDnGq_W9fSpNYhF6T_","margin":"","location":{"start":{"line":134,"column":1,"offset":2624},"end":{"line":134,"column":104,"offset":2727}},"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/Subsets::IO/Subsets-IO-1.1/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"","auth":"zef:raku-community-modules","authors":["Zoffix Znet"],"build-depends":[],"depends":["Subset::Helper"],"description":"Subsets for various types of `IO::Path` instances","dist":"Subsets::IO:ver<1.1>:auth<zef:raku-community-modules>","license":"Artistic-2.0","name":"Subsets::IO","path":"S/UB/SUBSETS_IO/ae945f5654d6c94498db01d446f9d4b7ac43cbf5.tar.gz","perl":"6.c","provides":{"Subsets::IO":"lib/Subsets/IO.rakumod","Subsets::IO-helper":"lib/Subsets/IO-helper.rakumod"},"resources":[],"source-url":"https://github.com/raku-community-modules/Subsets-IO.git","support":{"source":"https://github.com/raku-community-modules/Subsets-IO.git"},"tags":["IO"],"test-depends":["Testo","Temp::Path"],"version":"1.1"},"files":[{"file":"work_mods/zef/Subsets::IO/Subsets-IO-1.1/README.md","publishUrl":"/mods/zef/Subsets::IO/Subsets-IO-1.1/README.md"},{"file":"work_mods/zef/Subsets::IO/Subsets-IO-1.1/lib/Subsets/IO.rakumod","publishUrl":"/mods/zef/Subsets::IO/Subsets-IO-1.1/lib/Subsets/IO.rakumod"}],"src":"zef","url":"/mods/zef/Subsets::IO"}}}
=end data


    =begin React :component<RenderItem>
    =begin data
    {"type":"page","file":"work_mods/zef/Subsets::IO/Subsets-IO-1.1/README.md","sources":[],"node":{"type":"block","id":"pnvb2YdUImNM44A5cGMbj","margin":"","name":"root","content":[{"type":"para","id":"9FWL39bD17BO7ZXP-LJrj","margin":"","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":173,"offset":172}},"text":"text","content":[{"meta":"https://github.com/raku-community-modules/Subsets-IO/actions","type":"fcode","name":"L","content":[{"type":"block","id":"vlG1wZVtqFmAcsWxfl39W","margin":"","name":"Image","config":[],"location":{"start":{"line":1,"column":2,"offset":1},"end":{"line":1,"column":110,"offset":109}},"content":[{"type":"image","src":"https://github.com/raku-community-modules/Subsets-IO/actions/workflows/test.yml/badge.svg","alt":"Actions Status"}]}]}]},{"type":"block","id":"AMptI5Ghl0curHfEqftwp","margin":"","level":1,"name":"head","location":{"start":{"line":3,"column":1,"offset":174},"end":{"line":4,"column":5,"offset":183}},"content":["NAME"]},{"type":"para","id":"kXvpFXMM0dFr2XOuZ18Os","margin":"","location":{"start":{"line":6,"column":1,"offset":185},"end":{"line":6,"column":66,"offset":250}},"text":"text","content":[{"type":"fcode","name":"C","content":["Subsets::IO"]}," - Subsets for various types of ",{"type":"fcode","name":"C","content":["IO::Path"]}," instances"]},{"type":"block","id":"B3Uc7bRG53-V1fbtSLs8b","margin":"","level":1,"name":"head","location":{"start":{"line":8,"column":1,"offset":252},"end":{"line":9,"column":9,"offset":269}},"content":["SYNOPSIS"]},{"type":"block","id":"5p0-JbjVSKAwpNLJRvJuJ","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":11,"column":1,"offset":271},"end":{"line":16,"column":4,"offset":377}},"content":[{"type":"verbatim","value":"use Subsets::IO;\n\nsay \"Our script is writable and readable\"\n    if $?FILE.IO ~~ IO::Path::frw;"}]},{"type":"block","id":"3BAQjiez68p1eB3B4v_kq","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":18,"column":1,"offset":379},"end":{"line":32,"column":4,"offset":841}},"content":[{"type":"verbatim","value":"use Subsets::IO;\n\nsub make-conf($conf where IO::Path::dw | IO::Path::fw) {\n    say \"$conf is either a writable directory or a writable file\";\n}\n\nsub make-conf-file(IO::Path::E $conf) {\n    say \"$conf is a non-existent path\";\n}\nmake-conf-file $?FILE.IO;\n# Path must NOT exist Got /home/zoffix/CPANPRC/Subsets-IO/foo.p6\n# Constraint type check failed in binding to parameter '$conf';\n#   expected IO::Path::E but got IO::Path (IO::Path.new(\"/home/z...)"}]},{"type":"block","id":"Gl7j0gAQ0C6eEJCk1UgY8","margin":"","level":1,"name":"head","location":{"start":{"line":34,"column":1,"offset":843},"end":{"line":35,"column":12,"offset":866}},"content":["DESCRIPTION"]},{"type":"para","id":"rD4BumnOwSpzYep688NaE","margin":"","location":{"start":{"line":37,"column":1,"offset":868},"end":{"line":37,"column":336,"offset":1203}},"text":"text","content":["The module provides subsets of ",{"meta":"https://docs.raku.org/type/IO::Path","type":"fcode","name":"L","content":[{"type":"fcode","name":"C","content":["IO::Path:D"]}]}," that additionally perform file tests and either uses the new ",{"type":"fcode","name":"C","content":["will complain"]}," (since Rakudo 2022.04) feature, or uses ",{"meta":"https://raku.land/zef:raku-community-modules/Subset::Helper","type":"fcode","name":"L","content":[{"type":"fcode","name":"C","content":["Subset::Helper"]}]}," to display useful error messages on typecheck failures."]},{"type":"block","id":"bAxPm9o9al_xVttars28r","margin":"","level":1,"name":"head","location":{"start":{"line":39,"column":1,"offset":1205},"end":{"line":40,"column":18,"offset":1240}},"content":["AVAILABLE SUBSETS"]},{"type":"block","id":"a3Y9W2M9e9r_zaoIUbh47","margin":"","level":2,"name":"head","location":{"start":{"line":42,"column":1,"offset":1242},"end":{"line":43,"column":13,"offset":1267}},"content":["IO::Path::e`"]},{"type":"para","id":"JkYJrgg_tZOlMQOGd8jpZ","margin":"","location":{"start":{"line":45,"column":1,"offset":1269},"end":{"line":45,"column":17,"offset":1285}},"text":"text","content":["Path must exist."]},{"type":"block","id":"4wWKVO0xqpR98Re35N1y_","margin":"","level":2,"name":"head","location":{"start":{"line":47,"column":1,"offset":1287},"end":{"line":48,"column":13,"offset":1312}},"content":["IO::Path::E`"]},{"type":"para","id":"iohW5vW7QCY9TMm3JpIqv","margin":"","location":{"start":{"line":50,"column":1,"offset":1314},"end":{"line":50,"column":21,"offset":1334}},"text":"text","content":["Path must NOT exist."]},{"type":"block","id":"voTqjLNmJe_nRl6a4S64X","margin":"","level":2,"name":"head","location":{"start":{"line":52,"column":1,"offset":1336},"end":{"line":53,"column":13,"offset":1361}},"content":["IO::Path::f`"]},{"type":"para","id":"Q4ZiyzQWWqwXiTIC25pRk","margin":"","location":{"start":{"line":55,"column":1,"offset":1363},"end":{"line":55,"column":31,"offset":1393}},"text":"text","content":["Path must be an existing file."]},{"type":"block","id":"-kb5vGnokNIQUQd44liKh","margin":"","level":2,"name":"head","location":{"start":{"line":57,"column":1,"offset":1395},"end":{"line":58,"column":13,"offset":1420}},"content":["IO::Path::F`"]},{"type":"para","id":"lMXCG1iiRwK5K2OExP4mw","margin":"","location":{"start":{"line":60,"column":1,"offset":1422},"end":{"line":60,"column":35,"offset":1456}},"text":"text","content":["Path must NOT be an existing file."]},{"type":"block","id":"y_-QHDsI27HwLs83MesH7","margin":"","level":2,"name":"head","location":{"start":{"line":62,"column":1,"offset":1458},"end":{"line":63,"column":13,"offset":1483}},"content":["IO::Path::d`"]},{"type":"para","id":"66RqWfrgBRWQqsZFX9K3s","margin":"","location":{"start":{"line":65,"column":1,"offset":1485},"end":{"line":65,"column":36,"offset":1520}},"text":"text","content":["Path must be an existing directory."]},{"type":"block","id":"m8upey3cYfNZEpXvFJfA5","margin":"","level":2,"name":"head","location":{"start":{"line":67,"column":1,"offset":1522},"end":{"line":68,"column":13,"offset":1547}},"content":["IO::Path::D`"]},{"type":"para","id":"5uTfugcsT_OLv-_FvC-8y","margin":"","location":{"start":{"line":70,"column":1,"offset":1549},"end":{"line":70,"column":40,"offset":1588}},"text":"text","content":["Path must NOT be an existing directory."]},{"type":"block","id":"EnClFmCNSDAZ6lexa2CS8","margin":"","level":2,"name":"head","location":{"start":{"line":72,"column":1,"offset":1590},"end":{"line":73,"column":14,"offset":1617}},"content":["IO::Path::fr`"]},{"type":"para","id":"Rnk4iTesFiRLMHX0Z1F55","margin":"","location":{"start":{"line":75,"column":1,"offset":1619},"end":{"line":75,"column":41,"offset":1659}},"text":"text","content":["Path must be an existing, readable file."]},{"type":"block","id":"4cSkWToSw5N6JLRTcXyBd","margin":"","level":2,"name":"head","location":{"start":{"line":77,"column":1,"offset":1661},"end":{"line":78,"column":15,"offset":1690}},"content":["IO::Path::frw`"]},{"type":"para","id":"mGnqPjnV0YbmyiItsln_v","margin":"","location":{"start":{"line":80,"column":1,"offset":1692},"end":{"line":80,"column":54,"offset":1745}},"text":"text","content":["Path must be an existing, readable and writable file."]},{"type":"block","id":"LBHjxLyvHlSy-Dr52Y6Bt","margin":"","level":2,"name":"head","location":{"start":{"line":82,"column":1,"offset":1747},"end":{"line":83,"column":15,"offset":1776}},"content":["IO::Path::frx`"]},{"type":"para","id":"v7gAVB-y3O5kaFL2qaLB8","margin":"","location":{"start":{"line":85,"column":1,"offset":1778},"end":{"line":85,"column":56,"offset":1833}},"text":"text","content":["Path must be an existing, readable and executable file."]},{"type":"block","id":"JAm-5A6_wrmfb1lw-F3wH","margin":"","level":2,"name":"head","location":{"start":{"line":87,"column":1,"offset":1835},"end":{"line":88,"column":15,"offset":1864}},"content":["IO::Path::fwx`"]},{"type":"para","id":"5lldPsZiOblWJjutF9Z3-","margin":"","location":{"start":{"line":90,"column":1,"offset":1866},"end":{"line":90,"column":57,"offset":1922}},"text":"text","content":["Path must be an existing, writeable and executable file."]},{"type":"block","id":"AHEkKUFg1SBskNwqFhA7z","margin":"","level":2,"name":"head","location":{"start":{"line":92,"column":1,"offset":1924},"end":{"line":93,"column":16,"offset":1955}},"content":["IO::Path::frwx`"]},{"type":"para","id":"rDRqDvkv3Vf-MX-ZtqSN7","margin":"","location":{"start":{"line":95,"column":1,"offset":1957},"end":{"line":95,"column":67,"offset":2023}},"text":"text","content":["Path must be an existing, readable, writable, and executable file."]},{"type":"block","id":"AhNUtjM6AIUjmRr5CApuj","margin":"","level":2,"name":"head","location":{"start":{"line":97,"column":1,"offset":2025},"end":{"line":98,"column":14,"offset":2052}},"content":["IO::Path::dr`"]},{"type":"para","id":"fIHKmqoeY8BZCf6LaVpa6","margin":"","location":{"start":{"line":100,"column":1,"offset":2054},"end":{"line":100,"column":46,"offset":2099}},"text":"text","content":["Path must be an existing, readable directory."]},{"type":"block","id":"4bj6GX46iKlrqVy1Tw-Zu","margin":"","level":2,"name":"head","location":{"start":{"line":102,"column":1,"offset":2101},"end":{"line":103,"column":15,"offset":2130}},"content":["IO::Path::drw`"]},{"type":"para","id":"Rcpf4a_WBu0DGDcxkZup_","margin":"","location":{"start":{"line":105,"column":1,"offset":2132},"end":{"line":105,"column":59,"offset":2190}},"text":"text","content":["Path must be an existing, readable and writable directory."]},{"type":"block","id":"XhppyQPkkCFJUqN41qjJe","margin":"","level":2,"name":"head","location":{"start":{"line":107,"column":1,"offset":2192},"end":{"line":108,"column":15,"offset":2221}},"content":["IO::Path::drx`"]},{"type":"para","id":"oJDG_M52oEXCzbFR7n0dV","margin":"","location":{"start":{"line":110,"column":1,"offset":2223},"end":{"line":110,"column":61,"offset":2283}},"text":"text","content":["Path must be an existing, readable and executable directory."]},{"type":"block","id":"-GGE7qm2LIrDoF_1eb-Dn","margin":"","level":2,"name":"head","location":{"start":{"line":112,"column":1,"offset":2285},"end":{"line":113,"column":15,"offset":2314}},"content":["IO::Path::dwx`"]},{"type":"para","id":"mk8ghDvbXfSSx607EGefR","margin":"","location":{"start":{"line":115,"column":1,"offset":2316},"end":{"line":115,"column":62,"offset":2377}},"text":"text","content":["Path must be an existing, writeable and executable directory."]},{"type":"block","id":"U1ASt4D_ovkyii9jRk0U2","margin":"","level":2,"name":"head","location":{"start":{"line":117,"column":1,"offset":2379},"end":{"line":118,"column":16,"offset":2410}},"content":["IO::Path::drwx`"]},{"type":"para","id":"SFcnw5tlc-CLFTFKHuc2p","margin":"","location":{"start":{"line":120,"column":1,"offset":2412},"end":{"line":120,"column":72,"offset":2483}},"text":"text","content":["Path must be an existing, readable, writable, and executable directory."]},{"type":"block","id":"8M-rKXk-5ajx0bZvLJQPO","margin":"","level":1,"name":"head","location":{"start":{"line":122,"column":1,"offset":2485},"end":{"line":123,"column":7,"offset":2498}},"content":["AUTHOR"]},{"type":"para","id":"zpktOrVAYJtlR64Sv5Mu0","margin":"","location":{"start":{"line":125,"column":1,"offset":2500},"end":{"line":125,"column":12,"offset":2511}},"text":"text","content":["Zoffix Znet"]},{"type":"block","id":"3auhPak7OmiOYJ_eQiYKB","margin":"","level":1,"name":"head","location":{"start":{"line":127,"column":1,"offset":2513},"end":{"line":128,"column":22,"offset":2556}},"content":["COPYRIGHT AND LICENSE"]},{"type":"para","id":"kZYd0NFBqLqFMEZHtH05z","margin":"","location":{"start":{"line":130,"column":1,"offset":2558},"end":{"line":130,"column":27,"offset":2584}},"text":"text","content":["Copyright 2018 Zoffix Znet"]},{"type":"para","id":"UTex9Ry3gq7PgkxJOfQvo","margin":"","location":{"start":{"line":132,"column":1,"offset":2586},"end":{"line":132,"column":37,"offset":2622}},"text":"text","content":["Copyright 2019 - 2022 Raku Community"]},{"type":"para","id":"TmdoDnGq_W9fSpNYhF6T_","margin":"","location":{"start":{"line":134,"column":1,"offset":2624},"end":{"line":134,"column":104,"offset":2727}},"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/Subsets::IO/Subsets-IO-1.1/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"","auth":"zef:raku-community-modules","authors":["Zoffix Znet"],"build-depends":[],"depends":["Subset::Helper"],"description":"Subsets for various types of `IO::Path` instances","dist":"Subsets::IO:ver<1.1>:auth<zef:raku-community-modules>","license":"Artistic-2.0","name":"Subsets::IO","path":"S/UB/SUBSETS_IO/ae945f5654d6c94498db01d446f9d4b7ac43cbf5.tar.gz","perl":"6.c","provides":{"Subsets::IO":"lib/Subsets/IO.rakumod","Subsets::IO-helper":"lib/Subsets/IO-helper.rakumod"},"resources":[],"source-url":"https://github.com/raku-community-modules/Subsets-IO.git","support":{"source":"https://github.com/raku-community-modules/Subsets-IO.git"},"tags":["IO"],"test-depends":["Testo","Temp::Path"],"version":"1.1"},"files":[{"file":"work_mods/zef/Subsets::IO/Subsets-IO-1.1/README.md","publishUrl":"/mods/zef/Subsets::IO/Subsets-IO-1.1/README.md"},{"file":"work_mods/zef/Subsets::IO/Subsets-IO-1.1/lib/Subsets/IO.rakumod","publishUrl":"/mods/zef/Subsets::IO/Subsets-IO-1.1/lib/Subsets/IO.rakumod"}],"src":"zef","url":"/mods/zef/Subsets::IO"}}}
    =end data
    =end React


Subsets::IO


=begin data
{"type":"page","file":"work_mods/zef/Subset::Helper/dist/README.md","sources":[],"node":{"type":"block","id":"EARH6oCuS_ok_QSw0Hngt","margin":"","name":"root","content":[{"type":"block","id":"iuS2gq28zcLTOinXZdrA-","margin":"","level":1,"name":"head","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":208,"offset":207}},"content":["NAME ",{"meta":"https://github.com/raku-community-modules/Subset-Helper/actions/workflows/test.yaml","type":"fcode","name":"L","content":[{"type":"block","id":"gKp-yZzEOZywai49psvqn","margin":"","name":"Image","config":[],"location":{"start":{"line":1,"column":9,"offset":8},"end":{"line":1,"column":122,"offset":121}},"content":[{"type":"image","src":"https://github.com/raku-community-modules/Subset-Helper/actions/workflows/test.yaml/badge.svg","alt":"Tests on source"}]}]}]},{"type":"para","id":"F-R0q-JA0jfSO_UUnX33_","margin":"","location":{"start":{"line":3,"column":1,"offset":209},"end":{"line":3,"column":40,"offset":248}},"text":"text","content":["Subset::Helper - create awesome subsets"]},{"type":"block","id":"z0MnEBtaV-WtG8DgXglHW","margin":"","level":1,"name":"head","location":{"start":{"line":5,"column":1,"offset":250},"end":{"line":5,"column":11,"offset":260}},"content":["SYNOPSIS"]},{"type":"block","id":"Rwg80RsiDdYd1awXF8sdQ","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":7,"column":1,"offset":262},"end":{"line":15,"column":4,"offset":486}},"content":[{"type":"verbatim","value":"    use Subset::Helper;\n\n    subset Positive of Int\n        where subset-is * > 0, 'Value must be above zero';\n\n    my Positive $x = 42; # success\n    my Positive $x = -2; # Fails with 'Value must be above zero';"}]},{"type":"block","id":"AObCAYHuTbpZaUmUql5ST","margin":"","level":1,"name":"head","location":{"start":{"line":17,"column":1,"offset":488},"end":{"line":17,"column":14,"offset":501}},"content":["DESCRIPTION"]},{"type":"para","id":"XqWrfRY5mvv7NrSSXIYyP","margin":"","location":{"start":{"line":19,"column":1,"offset":503},"end":{"line":19,"column":61,"offset":563}},"text":"text","content":["This module solves two inconveniences with Perl 6's subsets:"]},{"type":"block","id":"Hs2Pfz0lkk6n70y5-lpQ2","margin":"","name":"code","config":[],"location":{"start":{"line":21,"column":1,"offset":565},"end":{"line":23,"column":55,"offset":742}},"content":[{"type":"verbatim","value":"1) Display of useful error messages when type check fails\n2) Avoid evaluating subset's condition for `Any` values,\n    which is what happens with optional parameters"}]},{"type":"block","id":"_R2J52xYdfoVIBxcbzZW0","margin":"","level":1,"name":"head","location":{"start":{"line":25,"column":1,"offset":744},"end":{"line":25,"column":23,"offset":766}},"content":["EXPORTED SUBROUTINES"]},{"type":"block","id":"v57EmQGY57N605DNvha6y","margin":"","level":2,"name":"head","location":{"start":{"line":27,"column":1,"offset":768},"end":{"line":27,"column":15,"offset":782}},"content":[{"type":"fcode","name":"C","content":["subset-is"]}]},{"type":"block","id":"NAk1YoeIPrSPcYh42LGil","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":29,"column":1,"offset":784},"end":{"line":35,"column":4,"offset":995}},"content":[{"type":"verbatim","value":"    subset Positive of Int where subset-is * > 0;\n\n    subset RoverCam of Str where subset-is\n        { $_ ∈ set <MAST CHEMCAM FHAZ RHAZ> },\n        'Valid cameras are MAST, CHEMCAM, FHAZ, and RHAZ';"}]},{"type":"para","id":"eviRC3H-Y8tEFYAhGm0JZ","margin":"","location":{"start":{"line":37,"column":1,"offset":997},"end":{"line":40,"column":26,"offset":1189}},"text":"text","content":["Takes one mandatory positional argument, which is the\ncode to execute to check the validity of value, and an\noptional descriptive error message to show when the value\ndoesn't match the subset."]},{"type":"para","id":"TYA-OHkPucIGCQQQ8t--D","margin":"","location":{"start":{"line":42,"column":1,"offset":1191},"end":{"line":45,"column":64,"offset":1422}},"text":"text","content":["Note: undefined values are accepted by the subset.\nThis exists to make it possible to cleanly define subsets\nfor optional parameters, for which the type check is still\ncalled, even when they aren't provided in the sub/method calls."]},{"type":"block","id":"wY85q76qXaBc47V0GqUa1","margin":"","level":1,"name":"head","location":{"start":{"line":47,"column":1,"offset":1424},"end":{"line":47,"column":19,"offset":1442}},"content":["CONFUSING ERRORS"]},{"type":"para","id":"0P43uyCA30uIM9ku2Fg1-","margin":"","location":{"start":{"line":49,"column":1,"offset":1444},"end":{"line":52,"column":36,"offset":1665}},"text":"text","content":["You can't declare our scoped subsets within roles. If you're\nusing this module, however, that error will instead point\nto the end of the declaration, saying ",{"type":"fcode","name":"C","content":["expecting any of: postfix"]},".\nSimply prefix your subset with ",{"type":"fcode","name":"C","content":["my"]}]},{"type":"block","id":"RE47au4H6Htcmd0qhl8lh","margin":"","level":1,"name":"head","location":{"start":{"line":54,"column":1,"offset":1667},"end":{"line":54,"column":23,"offset":1689}},"content":["BUGS AND LIMITATIONS"]},{"type":"para","id":"ebTXy5w45P8glpArJGj-b","margin":"","location":{"start":{"line":56,"column":1,"offset":1691},"end":{"line":57,"column":68,"offset":1820}},"text":"text","content":["Rakudo may evaluate whether a value matches the subset TWICE:\nonce to check the match and once to get sensible error information."]},{"type":"para","id":"DCRvCD2yNkpvu-TrMfkG6","margin":"","location":{"start":{"line":59,"column":1,"offset":1822},"end":{"line":59,"column":64,"offset":1885}},"text":"text","content":["Thus, currently the error message you provide is printed twice."]},{"type":"para","id":"N6A5LHUvjcmrz99o2KpSq","margin":"","location":{"start":{"line":61,"column":1,"offset":1887},"end":{"line":61,"column":33,"offset":1919}},"text":"text","content":["Patches to fix this are welcome."]},{"type":"block","id":"hgYxXgGmLZiETUFlutUCd","margin":"","level":1,"name":"head","location":{"start":{"line":65,"column":1,"offset":1927},"end":{"line":65,"column":13,"offset":1939}},"content":["REPOSITORY"]},{"type":"para","id":"6gnhelL9puRvQVogTa4YC","margin":"","location":{"start":{"line":67,"column":1,"offset":1941},"end":{"line":68,"column":56,"offset":2024}},"text":"text","content":["Fork this module on GitHub:\n",{"meta":"https://github.com/raku-community-modules/Subset-Helper","type":"fcode","name":"L","content":["https://github.com/raku-community-modules/Subset-Helper"]}]},{"type":"block","id":"CsZYudkHQjT_y428XbdJd","margin":"","level":1,"name":"head","location":{"start":{"line":70,"column":1,"offset":2026},"end":{"line":70,"column":7,"offset":2032}},"content":["BUGS"]},{"type":"para","id":"OK9Z1A-7EuExNhpWA6Dyb","margin":"","location":{"start":{"line":72,"column":1,"offset":2034},"end":{"line":73,"column":63,"offset":2143}},"text":"text","content":["To report bugs or request features, please use\n",{"meta":"https://github.com/raku-community-modules/Subset-Helper/issues","type":"fcode","name":"L","content":["https://github.com/raku-community-modules/Subset-Helper/issues"]}]},{"type":"block","id":"moO4zI8N8WwSLnZ4ahYRW","margin":"","level":1,"name":"head","location":{"start":{"line":75,"column":1,"offset":2145},"end":{"line":75,"column":9,"offset":2153}},"content":["AUTHOR"]},{"type":"para","id":"r-9_W-PkktUji2gAHuxk2","margin":"","location":{"start":{"line":77,"column":1,"offset":2155},"end":{"line":77,"column":33,"offset":2187}},"text":"text","content":["Zoffix Znet (",{"meta":"http://zoffix.com/","type":"fcode","name":"L","content":["http://zoffix.com/"]},")"]},{"type":"block","id":"sgLDPSlbQgoqs5VPnQ9lu","margin":"","level":1,"name":"head","location":{"start":{"line":79,"column":1,"offset":2189},"end":{"line":79,"column":10,"offset":2198}},"content":["LICENSE"]},{"type":"para","id":"ALKXVtCiuwTpZU4Pg7fZJ","margin":"","location":{"start":{"line":81,"column":1,"offset":2200},"end":{"line":83,"column":35,"offset":2362}},"text":"text","content":["You can use and distribute this module under the terms of the\nThe Artistic License 2.0. See the ",{"type":"fcode","name":"C","content":["LICENSE"]}," file included in this\ndistribution for complete details."]}]},"publishUrl":"/mods/zef/Subset::Helper/dist/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"","auth":"zef:raku-community-modules","authors":["Zoffix Znet"],"depends":[],"description":"create awesome subsets","dist":"Subset::Helper:ver<1.001002>:auth<zef:raku-community-modules>","license":"Artistic-2.0","name":"Subset::Helper","path":"S/UB/SUBSET_HELPER/559a1886601820e9273d3640fa5d40e28393fd79.tar.gz","perl":"6.c","provides":{"Subset::Helper":"lib/Subset/Helper.pm6"},"resources":["examples/subset.p6"],"source-url":"git://github.com/raku-community-modules/Subset-Helper.git","test-depends":["Test","Test::Output"],"version":"1.001002"},"files":[{"file":"work_mods/zef/Subset::Helper/dist/README.md","publishUrl":"/mods/zef/Subset::Helper/dist/README.md"}],"src":"zef","url":"/mods/zef/Subset::Helper"}}}
=end data


    =begin React :component<RenderItem>
    =begin data
    {"type":"page","file":"work_mods/zef/Subset::Helper/dist/README.md","sources":[],"node":{"type":"block","id":"EARH6oCuS_ok_QSw0Hngt","margin":"","name":"root","content":[{"type":"block","id":"iuS2gq28zcLTOinXZdrA-","margin":"","level":1,"name":"head","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":208,"offset":207}},"content":["NAME ",{"meta":"https://github.com/raku-community-modules/Subset-Helper/actions/workflows/test.yaml","type":"fcode","name":"L","content":[{"type":"block","id":"gKp-yZzEOZywai49psvqn","margin":"","name":"Image","config":[],"location":{"start":{"line":1,"column":9,"offset":8},"end":{"line":1,"column":122,"offset":121}},"content":[{"type":"image","src":"https://github.com/raku-community-modules/Subset-Helper/actions/workflows/test.yaml/badge.svg","alt":"Tests on source"}]}]}]},{"type":"para","id":"F-R0q-JA0jfSO_UUnX33_","margin":"","location":{"start":{"line":3,"column":1,"offset":209},"end":{"line":3,"column":40,"offset":248}},"text":"text","content":["Subset::Helper - create awesome subsets"]},{"type":"block","id":"z0MnEBtaV-WtG8DgXglHW","margin":"","level":1,"name":"head","location":{"start":{"line":5,"column":1,"offset":250},"end":{"line":5,"column":11,"offset":260}},"content":["SYNOPSIS"]},{"type":"block","id":"Rwg80RsiDdYd1awXF8sdQ","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":7,"column":1,"offset":262},"end":{"line":15,"column":4,"offset":486}},"content":[{"type":"verbatim","value":"    use Subset::Helper;\n\n    subset Positive of Int\n        where subset-is * > 0, 'Value must be above zero';\n\n    my Positive $x = 42; # success\n    my Positive $x = -2; # Fails with 'Value must be above zero';"}]},{"type":"block","id":"AObCAYHuTbpZaUmUql5ST","margin":"","level":1,"name":"head","location":{"start":{"line":17,"column":1,"offset":488},"end":{"line":17,"column":14,"offset":501}},"content":["DESCRIPTION"]},{"type":"para","id":"XqWrfRY5mvv7NrSSXIYyP","margin":"","location":{"start":{"line":19,"column":1,"offset":503},"end":{"line":19,"column":61,"offset":563}},"text":"text","content":["This module solves two inconveniences with Perl 6's subsets:"]},{"type":"block","id":"Hs2Pfz0lkk6n70y5-lpQ2","margin":"","name":"code","config":[],"location":{"start":{"line":21,"column":1,"offset":565},"end":{"line":23,"column":55,"offset":742}},"content":[{"type":"verbatim","value":"1) Display of useful error messages when type check fails\n2) Avoid evaluating subset's condition for `Any` values,\n    which is what happens with optional parameters"}]},{"type":"block","id":"_R2J52xYdfoVIBxcbzZW0","margin":"","level":1,"name":"head","location":{"start":{"line":25,"column":1,"offset":744},"end":{"line":25,"column":23,"offset":766}},"content":["EXPORTED SUBROUTINES"]},{"type":"block","id":"v57EmQGY57N605DNvha6y","margin":"","level":2,"name":"head","location":{"start":{"line":27,"column":1,"offset":768},"end":{"line":27,"column":15,"offset":782}},"content":[{"type":"fcode","name":"C","content":["subset-is"]}]},{"type":"block","id":"NAk1YoeIPrSPcYh42LGil","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":29,"column":1,"offset":784},"end":{"line":35,"column":4,"offset":995}},"content":[{"type":"verbatim","value":"    subset Positive of Int where subset-is * > 0;\n\n    subset RoverCam of Str where subset-is\n        { $_ ∈ set <MAST CHEMCAM FHAZ RHAZ> },\n        'Valid cameras are MAST, CHEMCAM, FHAZ, and RHAZ';"}]},{"type":"para","id":"eviRC3H-Y8tEFYAhGm0JZ","margin":"","location":{"start":{"line":37,"column":1,"offset":997},"end":{"line":40,"column":26,"offset":1189}},"text":"text","content":["Takes one mandatory positional argument, which is the\ncode to execute to check the validity of value, and an\noptional descriptive error message to show when the value\ndoesn't match the subset."]},{"type":"para","id":"TYA-OHkPucIGCQQQ8t--D","margin":"","location":{"start":{"line":42,"column":1,"offset":1191},"end":{"line":45,"column":64,"offset":1422}},"text":"text","content":["Note: undefined values are accepted by the subset.\nThis exists to make it possible to cleanly define subsets\nfor optional parameters, for which the type check is still\ncalled, even when they aren't provided in the sub/method calls."]},{"type":"block","id":"wY85q76qXaBc47V0GqUa1","margin":"","level":1,"name":"head","location":{"start":{"line":47,"column":1,"offset":1424},"end":{"line":47,"column":19,"offset":1442}},"content":["CONFUSING ERRORS"]},{"type":"para","id":"0P43uyCA30uIM9ku2Fg1-","margin":"","location":{"start":{"line":49,"column":1,"offset":1444},"end":{"line":52,"column":36,"offset":1665}},"text":"text","content":["You can't declare our scoped subsets within roles. If you're\nusing this module, however, that error will instead point\nto the end of the declaration, saying ",{"type":"fcode","name":"C","content":["expecting any of: postfix"]},".\nSimply prefix your subset with ",{"type":"fcode","name":"C","content":["my"]}]},{"type":"block","id":"RE47au4H6Htcmd0qhl8lh","margin":"","level":1,"name":"head","location":{"start":{"line":54,"column":1,"offset":1667},"end":{"line":54,"column":23,"offset":1689}},"content":["BUGS AND LIMITATIONS"]},{"type":"para","id":"ebTXy5w45P8glpArJGj-b","margin":"","location":{"start":{"line":56,"column":1,"offset":1691},"end":{"line":57,"column":68,"offset":1820}},"text":"text","content":["Rakudo may evaluate whether a value matches the subset TWICE:\nonce to check the match and once to get sensible error information."]},{"type":"para","id":"DCRvCD2yNkpvu-TrMfkG6","margin":"","location":{"start":{"line":59,"column":1,"offset":1822},"end":{"line":59,"column":64,"offset":1885}},"text":"text","content":["Thus, currently the error message you provide is printed twice."]},{"type":"para","id":"N6A5LHUvjcmrz99o2KpSq","margin":"","location":{"start":{"line":61,"column":1,"offset":1887},"end":{"line":61,"column":33,"offset":1919}},"text":"text","content":["Patches to fix this are welcome."]},{"type":"block","id":"hgYxXgGmLZiETUFlutUCd","margin":"","level":1,"name":"head","location":{"start":{"line":65,"column":1,"offset":1927},"end":{"line":65,"column":13,"offset":1939}},"content":["REPOSITORY"]},{"type":"para","id":"6gnhelL9puRvQVogTa4YC","margin":"","location":{"start":{"line":67,"column":1,"offset":1941},"end":{"line":68,"column":56,"offset":2024}},"text":"text","content":["Fork this module on GitHub:\n",{"meta":"https://github.com/raku-community-modules/Subset-Helper","type":"fcode","name":"L","content":["https://github.com/raku-community-modules/Subset-Helper"]}]},{"type":"block","id":"CsZYudkHQjT_y428XbdJd","margin":"","level":1,"name":"head","location":{"start":{"line":70,"column":1,"offset":2026},"end":{"line":70,"column":7,"offset":2032}},"content":["BUGS"]},{"type":"para","id":"OK9Z1A-7EuExNhpWA6Dyb","margin":"","location":{"start":{"line":72,"column":1,"offset":2034},"end":{"line":73,"column":63,"offset":2143}},"text":"text","content":["To report bugs or request features, please use\n",{"meta":"https://github.com/raku-community-modules/Subset-Helper/issues","type":"fcode","name":"L","content":["https://github.com/raku-community-modules/Subset-Helper/issues"]}]},{"type":"block","id":"moO4zI8N8WwSLnZ4ahYRW","margin":"","level":1,"name":"head","location":{"start":{"line":75,"column":1,"offset":2145},"end":{"line":75,"column":9,"offset":2153}},"content":["AUTHOR"]},{"type":"para","id":"r-9_W-PkktUji2gAHuxk2","margin":"","location":{"start":{"line":77,"column":1,"offset":2155},"end":{"line":77,"column":33,"offset":2187}},"text":"text","content":["Zoffix Znet (",{"meta":"http://zoffix.com/","type":"fcode","name":"L","content":["http://zoffix.com/"]},")"]},{"type":"block","id":"sgLDPSlbQgoqs5VPnQ9lu","margin":"","level":1,"name":"head","location":{"start":{"line":79,"column":1,"offset":2189},"end":{"line":79,"column":10,"offset":2198}},"content":["LICENSE"]},{"type":"para","id":"ALKXVtCiuwTpZU4Pg7fZJ","margin":"","location":{"start":{"line":81,"column":1,"offset":2200},"end":{"line":83,"column":35,"offset":2362}},"text":"text","content":["You can use and distribute this module under the terms of the\nThe Artistic License 2.0. See the ",{"type":"fcode","name":"C","content":["LICENSE"]}," file included in this\ndistribution for complete details."]}]},"publishUrl":"/mods/zef/Subset::Helper/dist/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"","auth":"zef:raku-community-modules","authors":["Zoffix Znet"],"depends":[],"description":"create awesome subsets","dist":"Subset::Helper:ver<1.001002>:auth<zef:raku-community-modules>","license":"Artistic-2.0","name":"Subset::Helper","path":"S/UB/SUBSET_HELPER/559a1886601820e9273d3640fa5d40e28393fd79.tar.gz","perl":"6.c","provides":{"Subset::Helper":"lib/Subset/Helper.pm6"},"resources":["examples/subset.p6"],"source-url":"git://github.com/raku-community-modules/Subset-Helper.git","test-depends":["Test","Test::Output"],"version":"1.001002"},"files":[{"file":"work_mods/zef/Subset::Helper/dist/README.md","publishUrl":"/mods/zef/Subset::Helper/dist/README.md"}],"src":"zef","url":"/mods/zef/Subset::Helper"}}}
    =end data
    =end React


create awesome subsets


Subset::Helper


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


Subsets::Common

Notice

Installation

Subsets::Common v0.0.6

Authors

License

Dependencies

Test Dependencies

Provides

Documentation