TITLE

SUBTITLE

data

=begin data
{"type":"page","file":"work_mods/zef/python::itertools/dist/README.md","sources":[],"node":{"type":"block","id":"17tARcFq-55GBhJoGVoox","margin":"","name":"root","content":[{"type":"block","id":"iNpzwK-rQbsHrFGhboTYp","margin":"","level":2,"name":"head","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":2,"column":7,"offset":13}},"content":["Module"]},{"type":"para","id":"-5_8ONGP3WMXMspI2_7IK","margin":"","location":{"start":{"line":3,"column":1,"offset":14},"end":{"line":3,"column":66,"offset":79}},"text":"text","content":["python::itertools - A direct port of Python's itertools to perl6."]},{"type":"block","id":"SMzYR9WnET56TOtpKDLRE","margin":"","level":2,"name":"head","location":{"start":{"line":5,"column":1,"offset":81},"end":{"line":6,"column":12,"offset":104}},"content":["Description"]},{"type":"para","id":"FZrmNBT9jBjfAqVq3PgI3","margin":"","location":{"start":{"line":7,"column":1,"offset":105},"end":{"line":9,"column":48,"offset":315}},"text":"text","content":["It provides all the functionality that python's itertools does, including lazy evaluation.\nIn the future, I'd like to maximize the performance of these functions.\nFunction signatures may be a little different."]},{"type":"para","id":"jOruKyGh0VQyOgPhqLxfT","margin":"","location":{"start":{"line":11,"column":1,"offset":317},"end":{"line":12,"column":200,"offset":597}},"text":"text","content":["I needed a ",{"type":"fcode","name":"C","content":["itertools.combinations_with_replacement"]}," and couldn't find an easy\nbuiltin or library to do it. So why not write the library myself? It turns out perl6 has most of these functions built in already. Unfortunatley, I did not realize that until after writing it. Oops."]},{"type":"block","id":"VKc7ElKm-E_xX5tSmWbxM","margin":"","level":2,"name":"head","location":{"start":{"line":14,"column":1,"offset":599},"end":{"line":15,"column":8,"offset":614}},"content":["Copying"]},{"type":"para","id":"iV5leefEnRzw0gQU2sTye","margin":"","location":{"start":{"line":16,"column":1,"offset":615},"end":{"line":16,"column":57,"offset":671}},"text":"text","content":["Copyright (c) 2016 Armand Halbert.  All rights reserved."]},{"type":"para","id":"KCnpFD9DkFrGToIw-itWH","margin":"","location":{"start":{"line":18,"column":1,"offset":673},"end":{"line":19,"column":32,"offset":773}},"text":"text","content":["This program is free software; you can redistribute it and/or modify\nit under the terms in LICENSE."]},{"type":"block","id":"Vv3Cjc9xb9FALDnbkJoAM","margin":"","level":2,"name":"head","location":{"start":{"line":21,"column":1,"offset":775},"end":{"line":22,"column":14,"offset":802}},"content":["Prerequisites"]},{"type":"list","id":"KG7xsGx_8EW4gjk7k3_jv","margin":"","level":1,"list":"itemized","content":[{"type":"block","id":"2GwkMWycKPv0ofrLogQ6u","margin":"","name":"item","level":1,"location":{"start":{"line":23,"column":1,"offset":803},"end":{"line":23,"column":20,"offset":822}},"content":[{"type":"para","id":"8ufNVe9Y88BLkg966_cV0","margin":"","location":{"start":{"line":23,"column":3,"offset":805},"end":{"line":23,"column":20,"offset":822}},"text":"text","content":["perl6 (Obviously)"]}]}]},{"type":"block","id":"IV7N_baxhQwtYXvtf5md-","margin":"","level":2,"name":"head","location":{"start":{"line":25,"column":1,"offset":824},"end":{"line":26,"column":19,"offset":861}},"content":["Build/Installation"]},{"type":"para","id":"df1zi8A4Boh2E0Lw80TQa","margin":"","location":{"start":{"line":27,"column":1,"offset":862},"end":{"line":27,"column":38,"offset":899}},"text":"text","content":["For now, clone from this repository."]},{"type":"block","id":"jnef_sinV6Hf19HSp0dcH","margin":"","level":2,"name":"head","location":{"start":{"line":29,"column":1,"offset":901},"end":{"line":30,"column":7,"offset":914}},"content":["Author"]},{"type":"para","id":"-Gje7KRGElaLENHIE8lR7","margin":"","location":{"start":{"line":31,"column":1,"offset":915},"end":{"line":31,"column":42,"offset":956}},"text":"text","content":["Armand Halbert ",{"meta":"mailto:armand.halbert@gmail.com","type":"fcode","name":"L","content":["armand.halbert@gmail.com"]}]}]},"publishUrl":"/mods/zef/python::itertools/dist/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"","auth":"zef:ahalbert","depends":[],"description":"Port of python itertools","dist":"python::itertools:ver<1.0.0>:auth<zef:ahalbert>","name":"python::itertools","path":"P/YT/PYTHON_ITERTOOLS/618242d46f1a98be956ddd090e5e085db1caca2f.tar.gz","perl":"6.*","provides":{"python::itertools":"lib/python/itertools.pm"},"source-url":"git://github.com/ahalbert/raku-itertools.git","version":"1.0.0"},"files":[{"file":"work_mods/zef/python::itertools/dist/README.md","publishUrl":"/mods/zef/python::itertools/dist/README.md"},{"file":"work_mods/zef/python::itertools/dist/lib/python/itertools.rakumod","publishUrl":"/mods/zef/python::itertools/dist/lib/python/itertools.rakumod"}],"src":"zef","url":"/mods/zef/python::itertools"}}}
=end data


React

    =begin React :component<RenderItem>
    =begin data
    {"type":"page","file":"work_mods/zef/python::itertools/dist/README.md","sources":[],"node":{"type":"block","id":"17tARcFq-55GBhJoGVoox","margin":"","name":"root","content":[{"type":"block","id":"iNpzwK-rQbsHrFGhboTYp","margin":"","level":2,"name":"head","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":2,"column":7,"offset":13}},"content":["Module"]},{"type":"para","id":"-5_8ONGP3WMXMspI2_7IK","margin":"","location":{"start":{"line":3,"column":1,"offset":14},"end":{"line":3,"column":66,"offset":79}},"text":"text","content":["python::itertools - A direct port of Python's itertools to perl6."]},{"type":"block","id":"SMzYR9WnET56TOtpKDLRE","margin":"","level":2,"name":"head","location":{"start":{"line":5,"column":1,"offset":81},"end":{"line":6,"column":12,"offset":104}},"content":["Description"]},{"type":"para","id":"FZrmNBT9jBjfAqVq3PgI3","margin":"","location":{"start":{"line":7,"column":1,"offset":105},"end":{"line":9,"column":48,"offset":315}},"text":"text","content":["It provides all the functionality that python's itertools does, including lazy evaluation.\nIn the future, I'd like to maximize the performance of these functions.\nFunction signatures may be a little different."]},{"type":"para","id":"jOruKyGh0VQyOgPhqLxfT","margin":"","location":{"start":{"line":11,"column":1,"offset":317},"end":{"line":12,"column":200,"offset":597}},"text":"text","content":["I needed a ",{"type":"fcode","name":"C","content":["itertools.combinations_with_replacement"]}," and couldn't find an easy\nbuiltin or library to do it. So why not write the library myself? It turns out perl6 has most of these functions built in already. Unfortunatley, I did not realize that until after writing it. Oops."]},{"type":"block","id":"VKc7ElKm-E_xX5tSmWbxM","margin":"","level":2,"name":"head","location":{"start":{"line":14,"column":1,"offset":599},"end":{"line":15,"column":8,"offset":614}},"content":["Copying"]},{"type":"para","id":"iV5leefEnRzw0gQU2sTye","margin":"","location":{"start":{"line":16,"column":1,"offset":615},"end":{"line":16,"column":57,"offset":671}},"text":"text","content":["Copyright (c) 2016 Armand Halbert.  All rights reserved."]},{"type":"para","id":"KCnpFD9DkFrGToIw-itWH","margin":"","location":{"start":{"line":18,"column":1,"offset":673},"end":{"line":19,"column":32,"offset":773}},"text":"text","content":["This program is free software; you can redistribute it and/or modify\nit under the terms in LICENSE."]},{"type":"block","id":"Vv3Cjc9xb9FALDnbkJoAM","margin":"","level":2,"name":"head","location":{"start":{"line":21,"column":1,"offset":775},"end":{"line":22,"column":14,"offset":802}},"content":["Prerequisites"]},{"type":"list","id":"KG7xsGx_8EW4gjk7k3_jv","margin":"","level":1,"list":"itemized","content":[{"type":"block","id":"2GwkMWycKPv0ofrLogQ6u","margin":"","name":"item","level":1,"location":{"start":{"line":23,"column":1,"offset":803},"end":{"line":23,"column":20,"offset":822}},"content":[{"type":"para","id":"8ufNVe9Y88BLkg966_cV0","margin":"","location":{"start":{"line":23,"column":3,"offset":805},"end":{"line":23,"column":20,"offset":822}},"text":"text","content":["perl6 (Obviously)"]}]}]},{"type":"block","id":"IV7N_baxhQwtYXvtf5md-","margin":"","level":2,"name":"head","location":{"start":{"line":25,"column":1,"offset":824},"end":{"line":26,"column":19,"offset":861}},"content":["Build/Installation"]},{"type":"para","id":"df1zi8A4Boh2E0Lw80TQa","margin":"","location":{"start":{"line":27,"column":1,"offset":862},"end":{"line":27,"column":38,"offset":899}},"text":"text","content":["For now, clone from this repository."]},{"type":"block","id":"jnef_sinV6Hf19HSp0dcH","margin":"","level":2,"name":"head","location":{"start":{"line":29,"column":1,"offset":901},"end":{"line":30,"column":7,"offset":914}},"content":["Author"]},{"type":"para","id":"-Gje7KRGElaLENHIE8lR7","margin":"","location":{"start":{"line":31,"column":1,"offset":915},"end":{"line":31,"column":42,"offset":956}},"text":"text","content":["Armand Halbert ",{"meta":"mailto:armand.halbert@gmail.com","type":"fcode","name":"L","content":["armand.halbert@gmail.com"]}]}]},"publishUrl":"/mods/zef/python::itertools/dist/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"","auth":"zef:ahalbert","depends":[],"description":"Port of python itertools","dist":"python::itertools:ver<1.0.0>:auth<zef:ahalbert>","name":"python::itertools","path":"P/YT/PYTHON_ITERTOOLS/618242d46f1a98be956ddd090e5e085db1caca2f.tar.gz","perl":"6.*","provides":{"python::itertools":"lib/python/itertools.pm"},"source-url":"git://github.com/ahalbert/raku-itertools.git","version":"1.0.0"},"files":[{"file":"work_mods/zef/python::itertools/dist/README.md","publishUrl":"/mods/zef/python::itertools/dist/README.md"},{"file":"work_mods/zef/python::itertools/dist/lib/python/itertools.rakumod","publishUrl":"/mods/zef/python::itertools/dist/lib/python/itertools.rakumod"}],"src":"zef","url":"/mods/zef/python::itertools"}}}
    =end data
    =end React


root

Port of python itertools


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

python::itertools


=begin data
{"type":"page","file":"work_mods/zef/Pythonic::Str/Pythonic-Str-1.1/README.md","sources":[],"node":{"type":"block","id":"x0QvsiG6FV6-osBRRAi13","margin":"","name":"root","content":[{"type":"para","id":"qJcLK6O5jMJVaCpNZ2FhF","margin":"","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":165,"offset":164}},"text":"text","content":[{"meta":"https://github.com/raku-community-modules/Pythonic-Str/actions","type":"fcode","name":"L","content":[{"type":"block","id":"7dqwrP5Hpf4dgcmXzcKV-","margin":"","name":"Image","config":[],"location":{"start":{"line":1,"column":2,"offset":1},"end":{"line":1,"column":100,"offset":99}},"content":[{"type":"image","src":"https://github.com/raku-community-modules/Pythonic-Str/workflows/test/badge.svg","alt":"Actions Status"}]}]}]},{"type":"block","id":"wj4XzEeuc0kv2h7I8Mo9U","margin":"","level":1,"name":"head","location":{"start":{"line":3,"column":1,"offset":166},"end":{"line":4,"column":5,"offset":175}},"content":["NAME"]},{"type":"para","id":"0IvZoVYEnb17WwwOrkqdG","margin":"","location":{"start":{"line":6,"column":1,"offset":177},"end":{"line":6,"column":56,"offset":232}},"text":"text","content":["Pythonic::Str - Index into strings like Pythonistas do!"]},{"type":"block","id":"Hzgvf8yNuDY9kRN9Fnik9","margin":"","level":1,"name":"head","location":{"start":{"line":8,"column":1,"offset":234},"end":{"line":9,"column":9,"offset":251}},"content":["SYNOPSIS"]},{"type":"block","id":"nVkxK6WsTFVb6w2i71GQ7","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":11,"column":1,"offset":253},"end":{"line":18,"column":4,"offset":432}},"content":[{"type":"verbatim","value":"use Pythonic::Str;\n\nsay 'foobar'[3];            # b\nsay 'foobar'[3..*];         # bar\nsay 'foobar'[^3];           # foo\nsay 'foobar'[3,5,6]:exists; # (True True False)"}]},{"type":"block","id":"tWnDmcVc-rzevXil3B-lP","margin":"","level":1,"name":"head","location":{"start":{"line":20,"column":1,"offset":434},"end":{"line":21,"column":12,"offset":457}},"content":["DESCRIPTION"]},{"type":"para","id":"9fcneDpurFv6fmN8fu8DT","margin":"","location":{"start":{"line":23,"column":1,"offset":459},"end":{"line":23,"column":133,"offset":591}},"text":"text","content":["Provides ",{"type":"fcode","name":"C","content":["&postcircumfix:<[ ]>"]}," candidates to index into strings. Any indexing operation you normally can use on lists is supported."]},{"type":"para","id":"MherHj8_ibi2rKyVURcSi","margin":"","location":{"start":{"line":25,"column":1,"offset":593},"end":{"line":25,"column":436,"offset":1028}},"text":"text","content":["When multiple indices are given, the result will be calculated as if the indexing were called on a list of individual characters that compose the given string. ",{"type":"fcode","name":"B","content":["If all the elements"]}," nodally are of type ",{"type":"fcode","name":"C","content":["Str"]}," or ",{"type":"fcode","name":"C","content":["Nil"]}," (excluding ",{"type":"fcode","name":"C","content":["Failure"]},"s), then the result will be joined together to form a single string. Any other type of the output is returned as if it were called on a list of individual characters that compose the given string."]},{"type":"para","id":"R9cwvEIJmULA_mqtYLkRH","margin":"","location":{"start":{"line":27,"column":1,"offset":1030},"end":{"line":27,"column":83,"offset":1112}},"text":"text","content":["In plainer language this means that you get a single string result for stuff like:"]},{"type":"block","id":"oGqFD2R3x6KZGPbJv_wWC","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":29,"column":1,"offset":1114},"end":{"line":33,"column":4,"offset":1227}},"content":[{"type":"verbatim","value":"say 'foobar'[^3];           # foo\nsay 'foobar'[0, 1, 2];      # foo\nsay 'foobar'[0, (1, (2,))]; # foo"}]},{"type":"para","id":"mIxw2i17Uf9CvPTZGrztI","margin":"","location":{"start":{"line":35,"column":1,"offset":1229},"end":{"line":35,"column":99,"offset":1327}},"text":"text","content":["... but will get the same result as if you called indexing on a list of characters for stuff like:"]},{"type":"block","id":"21neH3NkPI7uDhZ59Gw-f","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":37,"column":1,"offset":1329},"end":{"line":41,"column":4,"offset":1486}},"content":[{"type":"verbatim","value":"say 'foobar'[^3]:p;           # (0 => f 1 => o 2 => o)\nsay 'foobar'[0, 1, 2]:exists; # (True True True)\nsay WHAT 'foobar'[1]:delete;  # (Failure)"}]},{"type":"block","id":"hbIbJcTnM3rlcKfyNuScv","margin":"","level":1,"name":"head","location":{"start":{"line":43,"column":1,"offset":1488},"end":{"line":44,"column":12,"offset":1511}},"content":["LIMITATIONS"]},{"type":"para","id":"u07uGzl9cDUWM7AsnFG4K","margin":"","location":{"start":{"line":46,"column":1,"offset":1513},"end":{"line":46,"column":471,"offset":1983}},"text":"text","content":["This module does not provide ",{"type":"fcode","name":"C","content":["Str.AT-POS"]}," or make ",{"type":"fcode","name":"C","content":["Str"]}," type do ",{"type":"fcode","name":"C","content":["Positional"]}," or ",{"type":"fcode","name":"C","content":["Iterable"]}," roles. The latter causes all sorts of fallout with core and non-core code due to inherent assumptions that ",{"type":"fcode","name":"C","content":["Str"]}," type does not do those roles. What this means in plain English is you can only index your strings with ",{"type":"fcode","name":"C","content":["[...]"]}," postcircumfix operator and can't willy-nilly treat them as lists of characters—simply. Call ",{"meta":"https://docs.raku.org/routine/comb","type":"fcode","name":"L","content":[{"type":"fcode","name":"C","content":[".comb"]}]}," if you need that."]},{"type":"block","id":"DXd1c1-rWsvpGC8RUe8AB","margin":"","level":1,"name":"head","location":{"start":{"line":48,"column":1,"offset":1985},"end":{"line":49,"column":9,"offset":2002}},"content":["SEE ALSO"]},{"type":"list","id":"-g2JH94WqepF3RhdXTCbo","margin":"","level":1,"list":"itemized","content":[{"type":"block","id":"3oUYOu_h75vS3kEEOpzDa","margin":"","name":"item","level":1,"location":{"start":{"line":51,"column":3,"offset":2006},"end":{"line":51,"column":53,"offset":2056}},"content":[{"type":"para","id":"aiH46BjXNgxjrDTfzqYL1","margin":"","location":{"start":{"line":51,"column":5,"offset":2008},"end":{"line":51,"column":53,"offset":2056}},"text":"text","content":[{"meta":"https://docs.raku.org/routine/comb","type":"fcode","name":"L","content":[{"type":"fcode","name":"C","content":["Str.comb"]}]}]}]},{"type":"block","id":"hQFcjpwWxM4A4jXe25FkB","margin":"","name":"item","level":1,"location":{"start":{"line":53,"column":3,"offset":2060},"end":{"line":53,"column":57,"offset":2114}},"content":[{"type":"para","id":"zbTVdZkEQjllc4PLCqkvU","margin":"","location":{"start":{"line":53,"column":5,"offset":2062},"end":{"line":53,"column":57,"offset":2114}},"text":"text","content":[{"meta":"https://docs.raku.org/routine/substr","type":"fcode","name":"L","content":[{"type":"fcode","name":"C","content":["Str.substr"]}]}]}]}]},{"type":"block","id":"Y6GI9llZdGgcOhEN50V7p","margin":"","level":1,"name":"head","location":{"start":{"line":55,"column":1,"offset":2116},"end":{"line":56,"column":7,"offset":2129}},"content":["AUTHOR"]},{"type":"para","id":"kWBJDvMKLy4ZSwroJB33O","margin":"","location":{"start":{"line":58,"column":1,"offset":2131},"end":{"line":58,"column":12,"offset":2142}},"text":"text","content":["Zoffix Znet"]},{"type":"block","id":"jn18pS4GWcwzYWtOz27UW","margin":"","level":1,"name":"head","location":{"start":{"line":60,"column":1,"offset":2144},"end":{"line":61,"column":22,"offset":2187}},"content":["COPYRIGHT AND LICENSE"]},{"type":"para","id":"jei6i4HS8k8bNXRrQodpc","margin":"","location":{"start":{"line":63,"column":1,"offset":2189},"end":{"line":63,"column":27,"offset":2215}},"text":"text","content":["Copyright 2017 Zoffix Znet"]},{"type":"para","id":"D_a5MxN9AqjDCib8Pf923","margin":"","location":{"start":{"line":65,"column":1,"offset":2217},"end":{"line":65,"column":37,"offset":2253}},"text":"text","content":["Copyright 2018 - 2022 Raku Community"]},{"type":"para","id":"NH4s-GZIQ7AGUQ4Z32VoK","margin":"","location":{"start":{"line":67,"column":1,"offset":2255},"end":{"line":67,"column":104,"offset":2358}},"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/Pythonic::Str/Pythonic-Str-1.1/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"","auth":"zef:raku-community-modules","authors":["Zoffix Znet"],"build-depends":[],"depends":[],"description":"Index into strings like Pythonistas do!","dist":"Pythonic::Str:ver<1.1>:auth<zef:raku-community-modules>","license":"Artistic-2.0","name":"Pythonic::Str","path":"P/YT/PYTHONIC_STR/6f45393f6bdcff78bab73986cb9c870af44fdb01.tar.gz","perl":"6.c","provides":{"Pythonic::Str":"lib/Pythonic/Str.rakumod"},"resources":[],"source-url":"https://github.com/raku-community-modules/Pythonic-Str.git","support":{"source":"git://github.com/raku-community-modules/Pythonic-Str.git"},"tags":["PYTHON","COMB","LIST"],"test-depends":["Test","Test::META"],"version":"1.1"},"files":[{"file":"work_mods/zef/Pythonic::Str/Pythonic-Str-1.1/README.md","publishUrl":"/mods/zef/Pythonic::Str/Pythonic-Str-1.1/README.md"},{"file":"work_mods/zef/Pythonic::Str/Pythonic-Str-1.1/lib/Pythonic/Str.rakumod","publishUrl":"/mods/zef/Pythonic::Str/Pythonic-Str-1.1/lib/Pythonic/Str.rakumod"}],"src":"zef","url":"/mods/zef/Pythonic::Str"}}}
=end data


    =begin React :component<RenderItem>
    =begin data
    {"type":"page","file":"work_mods/zef/Pythonic::Str/Pythonic-Str-1.1/README.md","sources":[],"node":{"type":"block","id":"x0QvsiG6FV6-osBRRAi13","margin":"","name":"root","content":[{"type":"para","id":"qJcLK6O5jMJVaCpNZ2FhF","margin":"","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":165,"offset":164}},"text":"text","content":[{"meta":"https://github.com/raku-community-modules/Pythonic-Str/actions","type":"fcode","name":"L","content":[{"type":"block","id":"7dqwrP5Hpf4dgcmXzcKV-","margin":"","name":"Image","config":[],"location":{"start":{"line":1,"column":2,"offset":1},"end":{"line":1,"column":100,"offset":99}},"content":[{"type":"image","src":"https://github.com/raku-community-modules/Pythonic-Str/workflows/test/badge.svg","alt":"Actions Status"}]}]}]},{"type":"block","id":"wj4XzEeuc0kv2h7I8Mo9U","margin":"","level":1,"name":"head","location":{"start":{"line":3,"column":1,"offset":166},"end":{"line":4,"column":5,"offset":175}},"content":["NAME"]},{"type":"para","id":"0IvZoVYEnb17WwwOrkqdG","margin":"","location":{"start":{"line":6,"column":1,"offset":177},"end":{"line":6,"column":56,"offset":232}},"text":"text","content":["Pythonic::Str - Index into strings like Pythonistas do!"]},{"type":"block","id":"Hzgvf8yNuDY9kRN9Fnik9","margin":"","level":1,"name":"head","location":{"start":{"line":8,"column":1,"offset":234},"end":{"line":9,"column":9,"offset":251}},"content":["SYNOPSIS"]},{"type":"block","id":"nVkxK6WsTFVb6w2i71GQ7","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":11,"column":1,"offset":253},"end":{"line":18,"column":4,"offset":432}},"content":[{"type":"verbatim","value":"use Pythonic::Str;\n\nsay 'foobar'[3];            # b\nsay 'foobar'[3..*];         # bar\nsay 'foobar'[^3];           # foo\nsay 'foobar'[3,5,6]:exists; # (True True False)"}]},{"type":"block","id":"tWnDmcVc-rzevXil3B-lP","margin":"","level":1,"name":"head","location":{"start":{"line":20,"column":1,"offset":434},"end":{"line":21,"column":12,"offset":457}},"content":["DESCRIPTION"]},{"type":"para","id":"9fcneDpurFv6fmN8fu8DT","margin":"","location":{"start":{"line":23,"column":1,"offset":459},"end":{"line":23,"column":133,"offset":591}},"text":"text","content":["Provides ",{"type":"fcode","name":"C","content":["&postcircumfix:<[ ]>"]}," candidates to index into strings. Any indexing operation you normally can use on lists is supported."]},{"type":"para","id":"MherHj8_ibi2rKyVURcSi","margin":"","location":{"start":{"line":25,"column":1,"offset":593},"end":{"line":25,"column":436,"offset":1028}},"text":"text","content":["When multiple indices are given, the result will be calculated as if the indexing were called on a list of individual characters that compose the given string. ",{"type":"fcode","name":"B","content":["If all the elements"]}," nodally are of type ",{"type":"fcode","name":"C","content":["Str"]}," or ",{"type":"fcode","name":"C","content":["Nil"]}," (excluding ",{"type":"fcode","name":"C","content":["Failure"]},"s), then the result will be joined together to form a single string. Any other type of the output is returned as if it were called on a list of individual characters that compose the given string."]},{"type":"para","id":"R9cwvEIJmULA_mqtYLkRH","margin":"","location":{"start":{"line":27,"column":1,"offset":1030},"end":{"line":27,"column":83,"offset":1112}},"text":"text","content":["In plainer language this means that you get a single string result for stuff like:"]},{"type":"block","id":"oGqFD2R3x6KZGPbJv_wWC","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":29,"column":1,"offset":1114},"end":{"line":33,"column":4,"offset":1227}},"content":[{"type":"verbatim","value":"say 'foobar'[^3];           # foo\nsay 'foobar'[0, 1, 2];      # foo\nsay 'foobar'[0, (1, (2,))]; # foo"}]},{"type":"para","id":"mIxw2i17Uf9CvPTZGrztI","margin":"","location":{"start":{"line":35,"column":1,"offset":1229},"end":{"line":35,"column":99,"offset":1327}},"text":"text","content":["... but will get the same result as if you called indexing on a list of characters for stuff like:"]},{"type":"block","id":"21neH3NkPI7uDhZ59Gw-f","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":37,"column":1,"offset":1329},"end":{"line":41,"column":4,"offset":1486}},"content":[{"type":"verbatim","value":"say 'foobar'[^3]:p;           # (0 => f 1 => o 2 => o)\nsay 'foobar'[0, 1, 2]:exists; # (True True True)\nsay WHAT 'foobar'[1]:delete;  # (Failure)"}]},{"type":"block","id":"hbIbJcTnM3rlcKfyNuScv","margin":"","level":1,"name":"head","location":{"start":{"line":43,"column":1,"offset":1488},"end":{"line":44,"column":12,"offset":1511}},"content":["LIMITATIONS"]},{"type":"para","id":"u07uGzl9cDUWM7AsnFG4K","margin":"","location":{"start":{"line":46,"column":1,"offset":1513},"end":{"line":46,"column":471,"offset":1983}},"text":"text","content":["This module does not provide ",{"type":"fcode","name":"C","content":["Str.AT-POS"]}," or make ",{"type":"fcode","name":"C","content":["Str"]}," type do ",{"type":"fcode","name":"C","content":["Positional"]}," or ",{"type":"fcode","name":"C","content":["Iterable"]}," roles. The latter causes all sorts of fallout with core and non-core code due to inherent assumptions that ",{"type":"fcode","name":"C","content":["Str"]}," type does not do those roles. What this means in plain English is you can only index your strings with ",{"type":"fcode","name":"C","content":["[...]"]}," postcircumfix operator and can't willy-nilly treat them as lists of characters—simply. Call ",{"meta":"https://docs.raku.org/routine/comb","type":"fcode","name":"L","content":[{"type":"fcode","name":"C","content":[".comb"]}]}," if you need that."]},{"type":"block","id":"DXd1c1-rWsvpGC8RUe8AB","margin":"","level":1,"name":"head","location":{"start":{"line":48,"column":1,"offset":1985},"end":{"line":49,"column":9,"offset":2002}},"content":["SEE ALSO"]},{"type":"list","id":"-g2JH94WqepF3RhdXTCbo","margin":"","level":1,"list":"itemized","content":[{"type":"block","id":"3oUYOu_h75vS3kEEOpzDa","margin":"","name":"item","level":1,"location":{"start":{"line":51,"column":3,"offset":2006},"end":{"line":51,"column":53,"offset":2056}},"content":[{"type":"para","id":"aiH46BjXNgxjrDTfzqYL1","margin":"","location":{"start":{"line":51,"column":5,"offset":2008},"end":{"line":51,"column":53,"offset":2056}},"text":"text","content":[{"meta":"https://docs.raku.org/routine/comb","type":"fcode","name":"L","content":[{"type":"fcode","name":"C","content":["Str.comb"]}]}]}]},{"type":"block","id":"hQFcjpwWxM4A4jXe25FkB","margin":"","name":"item","level":1,"location":{"start":{"line":53,"column":3,"offset":2060},"end":{"line":53,"column":57,"offset":2114}},"content":[{"type":"para","id":"zbTVdZkEQjllc4PLCqkvU","margin":"","location":{"start":{"line":53,"column":5,"offset":2062},"end":{"line":53,"column":57,"offset":2114}},"text":"text","content":[{"meta":"https://docs.raku.org/routine/substr","type":"fcode","name":"L","content":[{"type":"fcode","name":"C","content":["Str.substr"]}]}]}]}]},{"type":"block","id":"Y6GI9llZdGgcOhEN50V7p","margin":"","level":1,"name":"head","location":{"start":{"line":55,"column":1,"offset":2116},"end":{"line":56,"column":7,"offset":2129}},"content":["AUTHOR"]},{"type":"para","id":"kWBJDvMKLy4ZSwroJB33O","margin":"","location":{"start":{"line":58,"column":1,"offset":2131},"end":{"line":58,"column":12,"offset":2142}},"text":"text","content":["Zoffix Znet"]},{"type":"block","id":"jn18pS4GWcwzYWtOz27UW","margin":"","level":1,"name":"head","location":{"start":{"line":60,"column":1,"offset":2144},"end":{"line":61,"column":22,"offset":2187}},"content":["COPYRIGHT AND LICENSE"]},{"type":"para","id":"jei6i4HS8k8bNXRrQodpc","margin":"","location":{"start":{"line":63,"column":1,"offset":2189},"end":{"line":63,"column":27,"offset":2215}},"text":"text","content":["Copyright 2017 Zoffix Znet"]},{"type":"para","id":"D_a5MxN9AqjDCib8Pf923","margin":"","location":{"start":{"line":65,"column":1,"offset":2217},"end":{"line":65,"column":37,"offset":2253}},"text":"text","content":["Copyright 2018 - 2022 Raku Community"]},{"type":"para","id":"NH4s-GZIQ7AGUQ4Z32VoK","margin":"","location":{"start":{"line":67,"column":1,"offset":2255},"end":{"line":67,"column":104,"offset":2358}},"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/Pythonic::Str/Pythonic-Str-1.1/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"","auth":"zef:raku-community-modules","authors":["Zoffix Znet"],"build-depends":[],"depends":[],"description":"Index into strings like Pythonistas do!","dist":"Pythonic::Str:ver<1.1>:auth<zef:raku-community-modules>","license":"Artistic-2.0","name":"Pythonic::Str","path":"P/YT/PYTHONIC_STR/6f45393f6bdcff78bab73986cb9c870af44fdb01.tar.gz","perl":"6.c","provides":{"Pythonic::Str":"lib/Pythonic/Str.rakumod"},"resources":[],"source-url":"https://github.com/raku-community-modules/Pythonic-Str.git","support":{"source":"git://github.com/raku-community-modules/Pythonic-Str.git"},"tags":["PYTHON","COMB","LIST"],"test-depends":["Test","Test::META"],"version":"1.1"},"files":[{"file":"work_mods/zef/Pythonic::Str/Pythonic-Str-1.1/README.md","publishUrl":"/mods/zef/Pythonic::Str/Pythonic-Str-1.1/README.md"},{"file":"work_mods/zef/Pythonic::Str/Pythonic-Str-1.1/lib/Pythonic/Str.rakumod","publishUrl":"/mods/zef/Pythonic::Str/Pythonic-Str-1.1/lib/Pythonic/Str.rakumod"}],"src":"zef","url":"/mods/zef/Pythonic::Str"}}}
    =end data
    =end React


Index into strings like Pythonistas do!


Pythonic::Str


=begin data
{"type":"page","file":"work_mods/zef/PublicSuffix/PublicSuffix-0.0.20220703/README.md","sources":[],"node":{"type":"block","id":"LdkvbxMp9ASLec9Ih2cdm","margin":"","name":"root","content":[{"type":"block","id":"60ZZl68nyFy7U3v9V-NrJ","margin":"","level":2,"name":"head","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":8,"offset":7}},"content":["NAME"]},{"type":"para","id":"YxVzZUjjCRgqQsOpXGjPO","margin":"","location":{"start":{"line":3,"column":1,"offset":9},"end":{"line":3,"column":50,"offset":58}},"text":"text","content":["PublicSuffix - Query Mozilla's Public Suffix List"]},{"type":"block","id":"GYPi9sdQsZLW2czCiqnB2","margin":"","level":2,"name":"head","location":{"start":{"line":5,"column":1,"offset":60},"end":{"line":5,"column":12,"offset":71}},"content":["SYNOPSIS"]},{"type":"block","id":"w97qtIRl9RfZWMHeV57M4","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":7,"column":1,"offset":73},"end":{"line":33,"column":4,"offset":700}},"content":[{"type":"verbatim","value":"use PublicSuffix;\n\n# The effective TLD of a host name\nsay public-suffix 'www.example.com';\n# OUTPUT: com\n\n# New TLDs are valid public suffix by default\nsay public-suffix 'www.example.unknownnewtld';\n# OUTPUT: unknownnewtld\n\n# Accept host names in Unicode\nsay public-suffix 'www.example.香港';\n# OUTPUT: 香港\n\n# Accept host names in punycode\nsay public-suffix 'www.example.xn--j6w193g';\n# OUTPUT: xn--j6w193g\n\n# Shortest domain that can be registered\nsay registrable-domain 'www.example.com';\n# OUTPUT: example.com\n\n# Returns a type object if registrable domain is not found\nsay registrable-domain 'com';\n# OUTPUT: (Str)"}]},{"type":"block","id":"9LUT6Fybq1Wpmsz_QDx3m","margin":"","level":2,"name":"head","location":{"start":{"line":35,"column":1,"offset":702},"end":{"line":35,"column":15,"offset":716}},"content":["DESCRIPTION"]},{"type":"para","id":"cBlGtuzqfLi1O4i4jIIhd","margin":"","location":{"start":{"line":37,"column":1,"offset":718},"end":{"line":42,"column":72,"offset":1167}},"text":"text","content":["This module provides functions to query Mozilla's ",{"meta":"http://publicsuffix.org","type":"fcode","name":"L","content":["Public Suffix List"]},": a\ncommunity-maintained list of domain name suffixes. The data in this list can\nbe used to determine the effective top-level domain of a host name, or to test\nwhether two hosts share an origin, as well as other similar validation\nfunctions. This most commonly used when validating the scope of HTTP cookies\nto prevent ",{"meta":"https://en.wikipedia.org/wiki/Supercookie","type":"fcode","name":"L","content":["supercookies"]},", but it has ",{"meta":"https://publicsuffix.org/learn","type":"fcode","name":"L","content":["a variety of other uses"]},"."]},{"type":"block","id":"OxIFGg-_mRMfrw3ByVHRv","margin":"","level":2,"name":"head","location":{"start":{"line":44,"column":1,"offset":1169},"end":{"line":44,"column":13,"offset":1181}},"content":["FUNCTIONS"]},{"type":"block","id":"v0A1E9RJWg3GxM3w2j0S0","margin":"","level":3,"name":"head","location":{"start":{"line":46,"column":1,"offset":1183},"end":{"line":46,"column":25,"offset":1207}},"content":["Host name validation"]},{"type":"para","id":"_uKhslqYx8nEyk8jQ78cA","margin":"","location":{"start":{"line":48,"column":1,"offset":1209},"end":{"line":52,"column":12,"offset":1508}},"text":"text","content":["The functions described below take host names as their parameter, and run some\nvalidation on their input before processing. When given a malformed or\notherwise invalid host name, the functions below will throw a\nX::PublicSuffix::BadDomain exception with the reason for the failure as its\nC",{"type":"block","id":"MEMqWNzshs8TDVcsEmQRT","margin":"","name":"Html","location":{"start":{"line":52,"column":2,"offset":1498},"end":{"line":52,"column":11,"offset":1507}},"content":[{"type":"verbatim","value":"<message>"}]},"."]},{"type":"para","id":"O23NOoEouiouXQqbaIMlJ","margin":"","location":{"start":{"line":54,"column":1,"offset":1510},"end":{"line":55,"column":53,"offset":1641}},"text":"text","content":["For a domain to be valid, it must be a non-empty string, with a maximum length\nof 253 octets, and no more than 63 octets per label."]},{"type":"para","id":"JJ5xOD86kCigvU10UEX92","margin":"","location":{"start":{"line":57,"column":1,"offset":1643},"end":{"line":60,"column":76,"offset":1946}},"text":"text","content":["Domains can be provided as either UTF-8 strings or their ASCII punycoded\nvariants. The returned strings will use the format of the strings provided.\nIn other words, if you provide a UTF-8 string, you will receive a UTF-8 string\nback, while giving an ASCII string will generate an ASCII string in return."]},{"type":"para","id":"XxQWgf8irUzLLEkr1UvzD","margin":"","location":{"start":{"line":62,"column":1,"offset":1948},"end":{"line":63,"column":46,"offset":2070}},"text":"text","content":["Providing partially punycoded strings is not supported, and the behaviour of\nthese functions with that input is undefined."]},{"type":"block","id":"XBKuD3zlyKkFcuEiLefOb","margin":"","level":3,"name":"head","location":{"start":{"line":65,"column":1,"offset":2072},"end":{"line":65,"column":18,"offset":2089}},"content":["public-suffix"]},{"type":"block","id":"aL_3C5fl8qh73fKuqroL5","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":67,"column":1,"offset":2091},"end":{"line":69,"column":4,"offset":2146}},"content":[{"type":"verbatim","value":"sub public-suffix ( Str $host ) returns Str"}]},{"type":"para","id":"2m69ldmwvvusC-Mj6U-_Z","margin":"","location":{"start":{"line":71,"column":1,"offset":2148},"end":{"line":74,"column":68,"offset":2436}},"text":"text","content":["Takes a host name as a Str and returns the ",{"meta":"https://url.spec.whatwg.org/#host-public-suffix","type":"fcode","name":"L","content":["public suffix"]},"  for that host, or\nthe type object if no public-suffix is found or if the host is the string\nrepresentation of a IPv4 or IPv6 address. This function will throw a\nX::PublicSuffix::BadDomain exception if the host name is not valid."]},{"type":"para","id":"GT5iaSPTGMZjbK7D85_2d","margin":"","location":{"start":{"line":76,"column":1,"offset":2438},"end":{"line":77,"column":64,"offset":2576}},"text":"text","content":["According to ",{"meta":"https://url.spec.whatwg.org/#host-miscellaneous","type":"fcode","name":"L","content":["§ 3.2 of the URL living standard"]},", the public suffix is \"the\nportion of a host which is included on the Public Suffix List\"."]},{"type":"block","id":"oGKLO14tnG3aaOHOYdcYZ","margin":"","level":3,"name":"head","location":{"start":{"line":79,"column":1,"offset":2578},"end":{"line":79,"column":23,"offset":2600}},"content":["registrable-domain"]},{"type":"block","id":"E7mIPvp3biZ9A_N4OB6FE","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":81,"column":1,"offset":2602},"end":{"line":83,"column":4,"offset":2662}},"content":[{"type":"verbatim","value":"sub registrable-domain ( Str $host ) returns Str"}]},{"type":"para","id":"MMhPaPT3p2SMF2zQqvZZA","margin":"","location":{"start":{"line":85,"column":1,"offset":2664},"end":{"line":88,"column":70,"offset":2961}},"text":"text","content":["Takes a host name as a Str and returns the ",{"meta":"https://url.spec.whatwg.org/#host-registrable-domain","type":"fcode","name":"L","content":["registrable domain"]}," for that host,\nor the type object if no registrable domain is found or if the host is the\nstring representation of a IPv4 or IPv6 address. This function will throw\na X::PublicSuffix::BadDomain exception if the host name is not valid."]},{"type":"para","id":"XUjYajMA24iNKzkeX-S49","margin":"","location":{"start":{"line":90,"column":1,"offset":2963},"end":{"line":92,"column":35,"offset":3144}},"text":"text","content":["According to ",{"meta":"https://url.spec.whatwg.org/#host-miscellaneous","type":"fcode","name":"L","content":["§ 3.2 of the URL living standard"]},", the registrable domain of a\nhost is \"the most specific public suffix, along with the domain label\nimmediately preceding it, if any\"."]},{"type":"block","id":"raJb9dtgY2o7fHK2_xk-m","margin":"","level":2,"name":"head","location":{"start":{"line":94,"column":1,"offset":3146},"end":{"line":94,"column":10,"offset":3155}},"content":["AUTHOR"]},{"type":"para","id":"QMbAqFNWn0FvWMRh2umAw","margin":"","location":{"start":{"line":96,"column":1,"offset":3157},"end":{"line":96,"column":38,"offset":3194}},"text":"text","content":["José Joaquín Atria ",{"meta":"mailto:jjatria@cpan.org","type":"fcode","name":"L","content":["jjatria@cpan.org"]}]},{"type":"block","id":"pUYewdoFLkTHowTFIekMD","margin":"","level":2,"name":"head","location":{"start":{"line":98,"column":1,"offset":3196},"end":{"line":98,"column":20,"offset":3215}},"content":["ACKNOWLEDGEMENTS"]},{"type":"para","id":"VQNJ4jnKP5kcV5IQek9OT","margin":"","location":{"start":{"line":100,"column":1,"offset":3217},"end":{"line":101,"column":26,"offset":3320}},"text":"text","content":["The code in this distribution takes inspiration from a number of similar Perl\nlibraries. In particular:"]},{"type":"list","id":"rw8lsYQ1l9r3ouGJDUaPD","margin":"","level":1,"list":"itemized","content":[{"type":"block","id":"Wx_Vka5bA8ikHXVLrIDVd","margin":"","name":"item","level":1,"location":{"start":{"line":103,"column":3,"offset":3324},"end":{"line":103,"column":28,"offset":3349}},"content":[{"type":"para","id":"nE4YG8l4sX4gkyIGkicYJ","margin":"","location":{"start":{"line":103,"column":5,"offset":3326},"end":{"line":103,"column":28,"offset":3349}},"text":"text","content":[{"meta":"https://metacpan.org/pod/Mozilla::PublicSuffix","type":"fcode","name":"L","content":["Mozilla::PublicSuffix"]}]}]},{"type":"block","id":"ATwEW1lLZDtO6t9_mK0lA","margin":"","name":"item","level":1,"location":{"start":{"line":105,"column":3,"offset":3353},"end":{"line":105,"column":36,"offset":3386}},"content":[{"type":"para","id":"xX-DDUSVQXFmx-VqFg3Qk","margin":"","location":{"start":{"line":105,"column":5,"offset":3355},"end":{"line":105,"column":36,"offset":3386}},"text":"text","content":[{"meta":"https://metacpan.org/pod/IO::Socket::SSL::PublicSuffix","type":"fcode","name":"L","content":["IO::Socket::SSL::PublicSuffix"]}]}]}]},{"type":"para","id":"xjJmiv1Jpbri4Kf2Lf0nv","margin":"","location":{"start":{"line":107,"column":1,"offset":3388},"end":{"line":108,"column":50,"offset":3515}},"text":"text","content":["In addition to the distributions mentioned above, the API was mostly inspired\nby the ",{"meta":"https://pypi.org/project/publicsuffixlist","type":"fcode","name":"L","content":["publicsuffixlist"]}," Python module by ko-zu."]},{"type":"para","id":"gCQTHs4b6vj5LdG1z-X-a","margin":"","location":{"start":{"line":110,"column":1,"offset":3517},"end":{"line":112,"column":11,"offset":3678}},"text":"text","content":["This module owes a debt of gratitude to their authors and those who have\ncontributed to them, and to their choice to make their code and work publicly\navailable."]},{"type":"block","id":"n3c7R7jwH1w3Qi440VAMX","margin":"","level":2,"name":"head","location":{"start":{"line":114,"column":1,"offset":3680},"end":{"line":114,"column":25,"offset":3704}},"content":["COPYRIGHT AND LICENSE"]},{"type":"para","id":"sK4V7CYnEWblI5qc_Vpq7","margin":"","location":{"start":{"line":116,"column":1,"offset":3706},"end":{"line":116,"column":34,"offset":3739}},"text":"text","content":["Copyright 2022 José Joaquín Atria"]},{"type":"para","id":"ewQHvQ4ah7PsJk1jMoFra","margin":"","location":{"start":{"line":118,"column":1,"offset":3741},"end":{"line":119,"column":26,"offset":3844}},"text":"text","content":["This library is free software; you can redistribute it and/or modify it under\nthe Artistic License 2.0."]}]},"publishUrl":"/mods/zef/PublicSuffix/PublicSuffix-0.0.20220703/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"","auth":"zef:jjatria","authors":["José Joaquín Atria"],"depends":["IDNA::Punycode:ver<1.0.0>"],"description":"Query Mozilla's Public Suffix List","dist":"PublicSuffix:ver<0.0.20220703>:auth<zef:jjatria>","license":"Artistic-2.0","name":"PublicSuffix","path":"P/UB/PUBLICSUFFIX/2f11e71dd1cc4b0e894c0559caacaca1e09d6cad.tar.gz","perl":"6.d","provides":{"PublicSuffix":"lib/PublicSuffix.rakumod"},"resources":["public_suffix_list.dat","tests.txt"],"source-url":"https://gitlab.com/jjatria/publicsuffix","tags":["HTTP"],"version":"0.0.20220703"},"files":[{"file":"work_mods/zef/PublicSuffix/PublicSuffix-0.0.20220703/README.md","publishUrl":"/mods/zef/PublicSuffix/PublicSuffix-0.0.20220703/README.md"},{"file":"work_mods/zef/PublicSuffix/PublicSuffix-0.0.20220703/lib/PublicSuffix.rakumod","publishUrl":"/mods/zef/PublicSuffix/PublicSuffix-0.0.20220703/lib/PublicSuffix.rakumod"}],"src":"zef","url":"/mods/zef/PublicSuffix"}}}
=end data


    =begin React :component<RenderItem>
    =begin data
    {"type":"page","file":"work_mods/zef/PublicSuffix/PublicSuffix-0.0.20220703/README.md","sources":[],"node":{"type":"block","id":"LdkvbxMp9ASLec9Ih2cdm","margin":"","name":"root","content":[{"type":"block","id":"60ZZl68nyFy7U3v9V-NrJ","margin":"","level":2,"name":"head","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":8,"offset":7}},"content":["NAME"]},{"type":"para","id":"YxVzZUjjCRgqQsOpXGjPO","margin":"","location":{"start":{"line":3,"column":1,"offset":9},"end":{"line":3,"column":50,"offset":58}},"text":"text","content":["PublicSuffix - Query Mozilla's Public Suffix List"]},{"type":"block","id":"GYPi9sdQsZLW2czCiqnB2","margin":"","level":2,"name":"head","location":{"start":{"line":5,"column":1,"offset":60},"end":{"line":5,"column":12,"offset":71}},"content":["SYNOPSIS"]},{"type":"block","id":"w97qtIRl9RfZWMHeV57M4","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":7,"column":1,"offset":73},"end":{"line":33,"column":4,"offset":700}},"content":[{"type":"verbatim","value":"use PublicSuffix;\n\n# The effective TLD of a host name\nsay public-suffix 'www.example.com';\n# OUTPUT: com\n\n# New TLDs are valid public suffix by default\nsay public-suffix 'www.example.unknownnewtld';\n# OUTPUT: unknownnewtld\n\n# Accept host names in Unicode\nsay public-suffix 'www.example.香港';\n# OUTPUT: 香港\n\n# Accept host names in punycode\nsay public-suffix 'www.example.xn--j6w193g';\n# OUTPUT: xn--j6w193g\n\n# Shortest domain that can be registered\nsay registrable-domain 'www.example.com';\n# OUTPUT: example.com\n\n# Returns a type object if registrable domain is not found\nsay registrable-domain 'com';\n# OUTPUT: (Str)"}]},{"type":"block","id":"9LUT6Fybq1Wpmsz_QDx3m","margin":"","level":2,"name":"head","location":{"start":{"line":35,"column":1,"offset":702},"end":{"line":35,"column":15,"offset":716}},"content":["DESCRIPTION"]},{"type":"para","id":"cBlGtuzqfLi1O4i4jIIhd","margin":"","location":{"start":{"line":37,"column":1,"offset":718},"end":{"line":42,"column":72,"offset":1167}},"text":"text","content":["This module provides functions to query Mozilla's ",{"meta":"http://publicsuffix.org","type":"fcode","name":"L","content":["Public Suffix List"]},": a\ncommunity-maintained list of domain name suffixes. The data in this list can\nbe used to determine the effective top-level domain of a host name, or to test\nwhether two hosts share an origin, as well as other similar validation\nfunctions. This most commonly used when validating the scope of HTTP cookies\nto prevent ",{"meta":"https://en.wikipedia.org/wiki/Supercookie","type":"fcode","name":"L","content":["supercookies"]},", but it has ",{"meta":"https://publicsuffix.org/learn","type":"fcode","name":"L","content":["a variety of other uses"]},"."]},{"type":"block","id":"OxIFGg-_mRMfrw3ByVHRv","margin":"","level":2,"name":"head","location":{"start":{"line":44,"column":1,"offset":1169},"end":{"line":44,"column":13,"offset":1181}},"content":["FUNCTIONS"]},{"type":"block","id":"v0A1E9RJWg3GxM3w2j0S0","margin":"","level":3,"name":"head","location":{"start":{"line":46,"column":1,"offset":1183},"end":{"line":46,"column":25,"offset":1207}},"content":["Host name validation"]},{"type":"para","id":"_uKhslqYx8nEyk8jQ78cA","margin":"","location":{"start":{"line":48,"column":1,"offset":1209},"end":{"line":52,"column":12,"offset":1508}},"text":"text","content":["The functions described below take host names as their parameter, and run some\nvalidation on their input before processing. When given a malformed or\notherwise invalid host name, the functions below will throw a\nX::PublicSuffix::BadDomain exception with the reason for the failure as its\nC",{"type":"block","id":"MEMqWNzshs8TDVcsEmQRT","margin":"","name":"Html","location":{"start":{"line":52,"column":2,"offset":1498},"end":{"line":52,"column":11,"offset":1507}},"content":[{"type":"verbatim","value":"<message>"}]},"."]},{"type":"para","id":"O23NOoEouiouXQqbaIMlJ","margin":"","location":{"start":{"line":54,"column":1,"offset":1510},"end":{"line":55,"column":53,"offset":1641}},"text":"text","content":["For a domain to be valid, it must be a non-empty string, with a maximum length\nof 253 octets, and no more than 63 octets per label."]},{"type":"para","id":"JJ5xOD86kCigvU10UEX92","margin":"","location":{"start":{"line":57,"column":1,"offset":1643},"end":{"line":60,"column":76,"offset":1946}},"text":"text","content":["Domains can be provided as either UTF-8 strings or their ASCII punycoded\nvariants. The returned strings will use the format of the strings provided.\nIn other words, if you provide a UTF-8 string, you will receive a UTF-8 string\nback, while giving an ASCII string will generate an ASCII string in return."]},{"type":"para","id":"XxQWgf8irUzLLEkr1UvzD","margin":"","location":{"start":{"line":62,"column":1,"offset":1948},"end":{"line":63,"column":46,"offset":2070}},"text":"text","content":["Providing partially punycoded strings is not supported, and the behaviour of\nthese functions with that input is undefined."]},{"type":"block","id":"XBKuD3zlyKkFcuEiLefOb","margin":"","level":3,"name":"head","location":{"start":{"line":65,"column":1,"offset":2072},"end":{"line":65,"column":18,"offset":2089}},"content":["public-suffix"]},{"type":"block","id":"aL_3C5fl8qh73fKuqroL5","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":67,"column":1,"offset":2091},"end":{"line":69,"column":4,"offset":2146}},"content":[{"type":"verbatim","value":"sub public-suffix ( Str $host ) returns Str"}]},{"type":"para","id":"2m69ldmwvvusC-Mj6U-_Z","margin":"","location":{"start":{"line":71,"column":1,"offset":2148},"end":{"line":74,"column":68,"offset":2436}},"text":"text","content":["Takes a host name as a Str and returns the ",{"meta":"https://url.spec.whatwg.org/#host-public-suffix","type":"fcode","name":"L","content":["public suffix"]},"  for that host, or\nthe type object if no public-suffix is found or if the host is the string\nrepresentation of a IPv4 or IPv6 address. This function will throw a\nX::PublicSuffix::BadDomain exception if the host name is not valid."]},{"type":"para","id":"GT5iaSPTGMZjbK7D85_2d","margin":"","location":{"start":{"line":76,"column":1,"offset":2438},"end":{"line":77,"column":64,"offset":2576}},"text":"text","content":["According to ",{"meta":"https://url.spec.whatwg.org/#host-miscellaneous","type":"fcode","name":"L","content":["§ 3.2 of the URL living standard"]},", the public suffix is \"the\nportion of a host which is included on the Public Suffix List\"."]},{"type":"block","id":"oGKLO14tnG3aaOHOYdcYZ","margin":"","level":3,"name":"head","location":{"start":{"line":79,"column":1,"offset":2578},"end":{"line":79,"column":23,"offset":2600}},"content":["registrable-domain"]},{"type":"block","id":"E7mIPvp3biZ9A_N4OB6FE","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":81,"column":1,"offset":2602},"end":{"line":83,"column":4,"offset":2662}},"content":[{"type":"verbatim","value":"sub registrable-domain ( Str $host ) returns Str"}]},{"type":"para","id":"MMhPaPT3p2SMF2zQqvZZA","margin":"","location":{"start":{"line":85,"column":1,"offset":2664},"end":{"line":88,"column":70,"offset":2961}},"text":"text","content":["Takes a host name as a Str and returns the ",{"meta":"https://url.spec.whatwg.org/#host-registrable-domain","type":"fcode","name":"L","content":["registrable domain"]}," for that host,\nor the type object if no registrable domain is found or if the host is the\nstring representation of a IPv4 or IPv6 address. This function will throw\na X::PublicSuffix::BadDomain exception if the host name is not valid."]},{"type":"para","id":"XUjYajMA24iNKzkeX-S49","margin":"","location":{"start":{"line":90,"column":1,"offset":2963},"end":{"line":92,"column":35,"offset":3144}},"text":"text","content":["According to ",{"meta":"https://url.spec.whatwg.org/#host-miscellaneous","type":"fcode","name":"L","content":["§ 3.2 of the URL living standard"]},", the registrable domain of a\nhost is \"the most specific public suffix, along with the domain label\nimmediately preceding it, if any\"."]},{"type":"block","id":"raJb9dtgY2o7fHK2_xk-m","margin":"","level":2,"name":"head","location":{"start":{"line":94,"column":1,"offset":3146},"end":{"line":94,"column":10,"offset":3155}},"content":["AUTHOR"]},{"type":"para","id":"QMbAqFNWn0FvWMRh2umAw","margin":"","location":{"start":{"line":96,"column":1,"offset":3157},"end":{"line":96,"column":38,"offset":3194}},"text":"text","content":["José Joaquín Atria ",{"meta":"mailto:jjatria@cpan.org","type":"fcode","name":"L","content":["jjatria@cpan.org"]}]},{"type":"block","id":"pUYewdoFLkTHowTFIekMD","margin":"","level":2,"name":"head","location":{"start":{"line":98,"column":1,"offset":3196},"end":{"line":98,"column":20,"offset":3215}},"content":["ACKNOWLEDGEMENTS"]},{"type":"para","id":"VQNJ4jnKP5kcV5IQek9OT","margin":"","location":{"start":{"line":100,"column":1,"offset":3217},"end":{"line":101,"column":26,"offset":3320}},"text":"text","content":["The code in this distribution takes inspiration from a number of similar Perl\nlibraries. In particular:"]},{"type":"list","id":"rw8lsYQ1l9r3ouGJDUaPD","margin":"","level":1,"list":"itemized","content":[{"type":"block","id":"Wx_Vka5bA8ikHXVLrIDVd","margin":"","name":"item","level":1,"location":{"start":{"line":103,"column":3,"offset":3324},"end":{"line":103,"column":28,"offset":3349}},"content":[{"type":"para","id":"nE4YG8l4sX4gkyIGkicYJ","margin":"","location":{"start":{"line":103,"column":5,"offset":3326},"end":{"line":103,"column":28,"offset":3349}},"text":"text","content":[{"meta":"https://metacpan.org/pod/Mozilla::PublicSuffix","type":"fcode","name":"L","content":["Mozilla::PublicSuffix"]}]}]},{"type":"block","id":"ATwEW1lLZDtO6t9_mK0lA","margin":"","name":"item","level":1,"location":{"start":{"line":105,"column":3,"offset":3353},"end":{"line":105,"column":36,"offset":3386}},"content":[{"type":"para","id":"xX-DDUSVQXFmx-VqFg3Qk","margin":"","location":{"start":{"line":105,"column":5,"offset":3355},"end":{"line":105,"column":36,"offset":3386}},"text":"text","content":[{"meta":"https://metacpan.org/pod/IO::Socket::SSL::PublicSuffix","type":"fcode","name":"L","content":["IO::Socket::SSL::PublicSuffix"]}]}]}]},{"type":"para","id":"xjJmiv1Jpbri4Kf2Lf0nv","margin":"","location":{"start":{"line":107,"column":1,"offset":3388},"end":{"line":108,"column":50,"offset":3515}},"text":"text","content":["In addition to the distributions mentioned above, the API was mostly inspired\nby the ",{"meta":"https://pypi.org/project/publicsuffixlist","type":"fcode","name":"L","content":["publicsuffixlist"]}," Python module by ko-zu."]},{"type":"para","id":"gCQTHs4b6vj5LdG1z-X-a","margin":"","location":{"start":{"line":110,"column":1,"offset":3517},"end":{"line":112,"column":11,"offset":3678}},"text":"text","content":["This module owes a debt of gratitude to their authors and those who have\ncontributed to them, and to their choice to make their code and work publicly\navailable."]},{"type":"block","id":"n3c7R7jwH1w3Qi440VAMX","margin":"","level":2,"name":"head","location":{"start":{"line":114,"column":1,"offset":3680},"end":{"line":114,"column":25,"offset":3704}},"content":["COPYRIGHT AND LICENSE"]},{"type":"para","id":"sK4V7CYnEWblI5qc_Vpq7","margin":"","location":{"start":{"line":116,"column":1,"offset":3706},"end":{"line":116,"column":34,"offset":3739}},"text":"text","content":["Copyright 2022 José Joaquín Atria"]},{"type":"para","id":"ewQHvQ4ah7PsJk1jMoFra","margin":"","location":{"start":{"line":118,"column":1,"offset":3741},"end":{"line":119,"column":26,"offset":3844}},"text":"text","content":["This library is free software; you can redistribute it and/or modify it under\nthe Artistic License 2.0."]}]},"publishUrl":"/mods/zef/PublicSuffix/PublicSuffix-0.0.20220703/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"","auth":"zef:jjatria","authors":["José Joaquín Atria"],"depends":["IDNA::Punycode:ver<1.0.0>"],"description":"Query Mozilla's Public Suffix List","dist":"PublicSuffix:ver<0.0.20220703>:auth<zef:jjatria>","license":"Artistic-2.0","name":"PublicSuffix","path":"P/UB/PUBLICSUFFIX/2f11e71dd1cc4b0e894c0559caacaca1e09d6cad.tar.gz","perl":"6.d","provides":{"PublicSuffix":"lib/PublicSuffix.rakumod"},"resources":["public_suffix_list.dat","tests.txt"],"source-url":"https://gitlab.com/jjatria/publicsuffix","tags":["HTTP"],"version":"0.0.20220703"},"files":[{"file":"work_mods/zef/PublicSuffix/PublicSuffix-0.0.20220703/README.md","publishUrl":"/mods/zef/PublicSuffix/PublicSuffix-0.0.20220703/README.md"},{"file":"work_mods/zef/PublicSuffix/PublicSuffix-0.0.20220703/lib/PublicSuffix.rakumod","publishUrl":"/mods/zef/PublicSuffix/PublicSuffix-0.0.20220703/lib/PublicSuffix.rakumod"}],"src":"zef","url":"/mods/zef/PublicSuffix"}}}
    =end data
    =end React


Query Mozilla's Public Suffix List


PublicSuffix


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


python::itertools

Module

Description

Copying

Prerequisites

Build/Installation

Author

python::itertools v1.0.0

Authors

License

Dependencies

Test Dependencies

Provides

Documentation