TITLE

An RSpec-like testing framework for Raku


SUBTITLE

data

=begin data
{"type":"page","file":"work_mods/zef/PSpec/PSpec-4.0.1/README.md","sources":[],"node":{"type":"block","id":"VQhO6WCkCNkVIe9SP08fB","margin":"","name":"root","content":[{"type":"para","id":"82iMkzPPE8LUM_f02YKl9","margin":"","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":151,"offset":150}},"text":"text","content":[{"meta":"https://github.com/raku-community-modules/PSpec/actions","type":"fcode","name":"L","content":[{"type":"block","id":"NRKSdP6v0HljL2hOHK9aK","margin":"","name":"Image","config":[],"location":{"start":{"line":1,"column":2,"offset":1},"end":{"line":1,"column":93,"offset":92}},"content":[{"type":"image","src":"https://github.com/raku-community-modules/PSpec/workflows/test/badge.svg","alt":"Actions Status"}]}]}]},{"type":"block","id":"i7i6O9Sz-54cF99q7Ayry","margin":"","level":1,"name":"head","location":{"start":{"line":3,"column":1,"offset":152},"end":{"line":4,"column":5,"offset":161}},"content":["NAME"]},{"type":"para","id":"3VwrEO7ThGasa0vzXyd5g","margin":"","location":{"start":{"line":6,"column":1,"offset":163},"end":{"line":6,"column":49,"offset":211}},"text":"text","content":["PSpec - An RSpec-like testing framework for Raku"]},{"type":"block","id":"XYkvwsD9IHpDv1OV_1ots","margin":"","level":1,"name":"head","location":{"start":{"line":8,"column":1,"offset":213},"end":{"line":9,"column":9,"offset":230}},"content":["SYNOPSIS"]},{"type":"block","id":"Q_MVQLaVP2_iWeinUYb9v","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":11,"column":1,"offset":232},"end":{"line":13,"column":4,"offset":254}},"content":[{"type":"verbatim","value":"use PSpec;"}]},{"type":"block","id":"cbIRD44wNSvkHgYS6kvYn","margin":"","level":1,"name":"head","location":{"start":{"line":15,"column":1,"offset":256},"end":{"line":16,"column":12,"offset":279}},"content":["DESCRIPTION"]},{"type":"para","id":"IoEHJ9Zq5jqqq36C8MdKE","margin":"","location":{"start":{"line":18,"column":1,"offset":281},"end":{"line":18,"column":128,"offset":408}},"text":"text","content":["PSpec is an implementation of Ruby's RSpec library, in Raku. It's currently very minimal, and does not implement much of RSpec."]},{"type":"block","id":"2LakjCuqWEJeROM2Sl67Y","margin":"","level":1,"name":"head","location":{"start":{"line":20,"column":1,"offset":410},"end":{"line":21,"column":7,"offset":423}},"content":["STATUS"]},{"type":"list","id":"OXkdDqBJmcpkaiqJgwBMG","margin":"","level":1,"list":"itemized","content":[{"type":"block","id":"zSdjgKchvV8aVcMTzCi58","margin":"","name":"item","level":1,"location":{"start":{"line":23,"column":3,"offset":427},"end":{"line":23,"column":40,"offset":464}},"content":[{"type":"para","id":"D80u3G_atLcvS40c-ZsfA","margin":"","location":{"start":{"line":23,"column":5,"offset":429},"end":{"line":23,"column":40,"offset":464}},"text":"text","content":["Supports basic \"describe\" commands."]}]},{"type":"block","id":"qDN2fEWC5clDL3de5fXPa","margin":"","name":"item","level":1,"location":{"start":{"line":25,"column":3,"offset":468},"end":{"line":25,"column":51,"offset":516}},"content":[{"type":"para","id":"skO-hOdxUn3Iln9yoKtE5","margin":"","location":{"start":{"line":25,"column":5,"offset":470},"end":{"line":25,"column":51,"offset":516}},"text":"text","content":["Supports a very simplistic \"should\" statement."]}]},{"type":"block","id":"iokWtq0nDDkRbklNkIJXB","margin":"","name":"item","level":1,"location":{"start":{"line":27,"column":3,"offset":520},"end":{"line":27,"column":64,"offset":581}},"content":[{"type":"para","id":"tWKx-KmuvYqtnDuUylxVJ","margin":"","location":{"start":{"line":27,"column":5,"offset":522},"end":{"line":27,"column":64,"offset":581}},"text":"text","content":["Has eq(), lt() and gt() subs that perform simplistic tests."]}]}]},{"type":"block","id":"O9UfUvjs4Fo2Z3gT4yj95","margin":"","level":1,"name":"head","location":{"start":{"line":29,"column":1,"offset":583},"end":{"line":30,"column":5,"offset":592}},"content":["TODO"]},{"type":"para","id":"wn9bIYgRXCR-427bU4tTv","margin":"","location":{"start":{"line":32,"column":1,"offset":594},"end":{"line":32,"column":120,"offset":713}},"text":"text","content":["Lots. This is barely functional, but is pretty much back to the level of the last working version prior to the rewrite."]},{"type":"block","id":"T9YXdsgYl4HX0VKfoocdF","margin":"","level":1,"name":"head","location":{"start":{"line":34,"column":1,"offset":715},"end":{"line":35,"column":8,"offset":730}},"content":["CREDITS"]},{"type":"para","id":"WDMZKbCIJHqDaH5AT88sf","margin":"","location":{"start":{"line":37,"column":1,"offset":732},"end":{"line":37,"column":106,"offset":837}},"text":"text","content":["Well, I must send kudos to the original authors of RSpec and Cucumber, without them, this wouldn't exist."]},{"type":"para","id":"FoZ19gmG5_SzGrFO-Hdwg","margin":"","location":{"start":{"line":39,"column":1,"offset":839},"end":{"line":39,"column":215,"offset":1053}},"text":"text","content":["Also, a big cheers to Carl Masak, who is always friendly and helpful! And a call-out to Larry Wall whose help on the #raku channel has been greatly appreciated! I guess I should also thank him for creating Perl :-)"]},{"type":"para","id":"tW4M00vt_1qCd6CPPnzuI","margin":"","location":{"start":{"line":41,"column":1,"offset":1055},"end":{"line":41,"column":194,"offset":1248}},"text":"text","content":["Since writing the original version of this Credits section, I've received a lot of help and feedback from many people on the #raku channel. Thanks to the whole Raku community for being awesome!"]},{"type":"block","id":"nzUj7_OJWQGVHrA9IgdqA","margin":"","level":1,"name":"head","location":{"start":{"line":43,"column":1,"offset":1250},"end":{"line":44,"column":7,"offset":1263}},"content":["AUTHOR"]},{"type":"para","id":"VnT_kn5dkx_pfbtHp5kr2","margin":"","location":{"start":{"line":46,"column":1,"offset":1265},"end":{"line":46,"column":15,"offset":1279}},"text":"text","content":["Timothy Totten"]},{"type":"para","id":"1R42RRvdY9v_SF1IuS-GC","margin":"","location":{"start":{"line":48,"column":1,"offset":1281},"end":{"line":48,"column":116,"offset":1396}},"text":"text","content":["Source can be located at: ",{"meta":"https://github.com/raku-community-modules/PSpec","type":"fcode","name":"L","content":["https://github.com/raku-community-modules/PSpec"]}," . Comments and Pull Requests are welcome."]},{"type":"block","id":"dFejCfxJIAEYXAa6A9Erb","margin":"","level":1,"name":"head","location":{"start":{"line":50,"column":1,"offset":1398},"end":{"line":51,"column":22,"offset":1441}},"content":["COPYRIGHT AND LICENSE"]},{"type":"para","id":"cVz4kFMMXiYVh8B33V_9a","margin":"","location":{"start":{"line":53,"column":1,"offset":1443},"end":{"line":53,"column":37,"offset":1479}},"text":"text","content":["Copyright 2010 - 2019 Timothy Totten"]},{"type":"para","id":"jb6S-2pyW5ZunDOJdjHll","margin":"","location":{"start":{"line":55,"column":1,"offset":1481},"end":{"line":55,"column":37,"offset":1517}},"text":"text","content":["Copyright 2020 - 2022 Raku Community"]},{"type":"para","id":"uZ5ei6fjcQmhIpJTRARMo","margin":"","location":{"start":{"line":57,"column":1,"offset":1519},"end":{"line":57,"column":104,"offset":1622}},"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/PSpec/PSpec-4.0.1/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"","auth":"zef:raku-community-modules","author":"Timothy Totten","build-depends":[],"depends":["Test"],"description":"An RSpec-like testing framework for Raku","dist":"PSpec:ver<4.0.1>:auth<zef:raku-community-modules>","license":"Artistic-2.0","name":"PSpec","path":"P/SP/PSPEC/bbacf7868b4579ec688f8bf11a132637db9e4dfc.tar.gz","perl":"6.*","provides":{"PSpec":"lib/PSpec.rakumod"},"resources":[],"source-url":"git://github.com/raku-community-modules/PSpec.git","tags":[],"test-depends":[],"version":"4.0.1"},"files":[{"file":"work_mods/zef/PSpec/PSpec-4.0.1/README.md","publishUrl":"/mods/zef/PSpec/PSpec-4.0.1/README.md"},{"file":"work_mods/zef/PSpec/PSpec-4.0.1/lib/PSpec.rakumod","publishUrl":"/mods/zef/PSpec/PSpec-4.0.1/lib/PSpec.rakumod"}],"src":"zef","url":"/mods/zef/PSpec"}}}
=end data


React

    =begin React :component<RenderItem>
    =begin data
    {"type":"page","file":"work_mods/zef/PSpec/PSpec-4.0.1/README.md","sources":[],"node":{"type":"block","id":"VQhO6WCkCNkVIe9SP08fB","margin":"","name":"root","content":[{"type":"para","id":"82iMkzPPE8LUM_f02YKl9","margin":"","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":151,"offset":150}},"text":"text","content":[{"meta":"https://github.com/raku-community-modules/PSpec/actions","type":"fcode","name":"L","content":[{"type":"block","id":"NRKSdP6v0HljL2hOHK9aK","margin":"","name":"Image","config":[],"location":{"start":{"line":1,"column":2,"offset":1},"end":{"line":1,"column":93,"offset":92}},"content":[{"type":"image","src":"https://github.com/raku-community-modules/PSpec/workflows/test/badge.svg","alt":"Actions Status"}]}]}]},{"type":"block","id":"i7i6O9Sz-54cF99q7Ayry","margin":"","level":1,"name":"head","location":{"start":{"line":3,"column":1,"offset":152},"end":{"line":4,"column":5,"offset":161}},"content":["NAME"]},{"type":"para","id":"3VwrEO7ThGasa0vzXyd5g","margin":"","location":{"start":{"line":6,"column":1,"offset":163},"end":{"line":6,"column":49,"offset":211}},"text":"text","content":["PSpec - An RSpec-like testing framework for Raku"]},{"type":"block","id":"XYkvwsD9IHpDv1OV_1ots","margin":"","level":1,"name":"head","location":{"start":{"line":8,"column":1,"offset":213},"end":{"line":9,"column":9,"offset":230}},"content":["SYNOPSIS"]},{"type":"block","id":"Q_MVQLaVP2_iWeinUYb9v","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":11,"column":1,"offset":232},"end":{"line":13,"column":4,"offset":254}},"content":[{"type":"verbatim","value":"use PSpec;"}]},{"type":"block","id":"cbIRD44wNSvkHgYS6kvYn","margin":"","level":1,"name":"head","location":{"start":{"line":15,"column":1,"offset":256},"end":{"line":16,"column":12,"offset":279}},"content":["DESCRIPTION"]},{"type":"para","id":"IoEHJ9Zq5jqqq36C8MdKE","margin":"","location":{"start":{"line":18,"column":1,"offset":281},"end":{"line":18,"column":128,"offset":408}},"text":"text","content":["PSpec is an implementation of Ruby's RSpec library, in Raku. It's currently very minimal, and does not implement much of RSpec."]},{"type":"block","id":"2LakjCuqWEJeROM2Sl67Y","margin":"","level":1,"name":"head","location":{"start":{"line":20,"column":1,"offset":410},"end":{"line":21,"column":7,"offset":423}},"content":["STATUS"]},{"type":"list","id":"OXkdDqBJmcpkaiqJgwBMG","margin":"","level":1,"list":"itemized","content":[{"type":"block","id":"zSdjgKchvV8aVcMTzCi58","margin":"","name":"item","level":1,"location":{"start":{"line":23,"column":3,"offset":427},"end":{"line":23,"column":40,"offset":464}},"content":[{"type":"para","id":"D80u3G_atLcvS40c-ZsfA","margin":"","location":{"start":{"line":23,"column":5,"offset":429},"end":{"line":23,"column":40,"offset":464}},"text":"text","content":["Supports basic \"describe\" commands."]}]},{"type":"block","id":"qDN2fEWC5clDL3de5fXPa","margin":"","name":"item","level":1,"location":{"start":{"line":25,"column":3,"offset":468},"end":{"line":25,"column":51,"offset":516}},"content":[{"type":"para","id":"skO-hOdxUn3Iln9yoKtE5","margin":"","location":{"start":{"line":25,"column":5,"offset":470},"end":{"line":25,"column":51,"offset":516}},"text":"text","content":["Supports a very simplistic \"should\" statement."]}]},{"type":"block","id":"iokWtq0nDDkRbklNkIJXB","margin":"","name":"item","level":1,"location":{"start":{"line":27,"column":3,"offset":520},"end":{"line":27,"column":64,"offset":581}},"content":[{"type":"para","id":"tWKx-KmuvYqtnDuUylxVJ","margin":"","location":{"start":{"line":27,"column":5,"offset":522},"end":{"line":27,"column":64,"offset":581}},"text":"text","content":["Has eq(), lt() and gt() subs that perform simplistic tests."]}]}]},{"type":"block","id":"O9UfUvjs4Fo2Z3gT4yj95","margin":"","level":1,"name":"head","location":{"start":{"line":29,"column":1,"offset":583},"end":{"line":30,"column":5,"offset":592}},"content":["TODO"]},{"type":"para","id":"wn9bIYgRXCR-427bU4tTv","margin":"","location":{"start":{"line":32,"column":1,"offset":594},"end":{"line":32,"column":120,"offset":713}},"text":"text","content":["Lots. This is barely functional, but is pretty much back to the level of the last working version prior to the rewrite."]},{"type":"block","id":"T9YXdsgYl4HX0VKfoocdF","margin":"","level":1,"name":"head","location":{"start":{"line":34,"column":1,"offset":715},"end":{"line":35,"column":8,"offset":730}},"content":["CREDITS"]},{"type":"para","id":"WDMZKbCIJHqDaH5AT88sf","margin":"","location":{"start":{"line":37,"column":1,"offset":732},"end":{"line":37,"column":106,"offset":837}},"text":"text","content":["Well, I must send kudos to the original authors of RSpec and Cucumber, without them, this wouldn't exist."]},{"type":"para","id":"FoZ19gmG5_SzGrFO-Hdwg","margin":"","location":{"start":{"line":39,"column":1,"offset":839},"end":{"line":39,"column":215,"offset":1053}},"text":"text","content":["Also, a big cheers to Carl Masak, who is always friendly and helpful! And a call-out to Larry Wall whose help on the #raku channel has been greatly appreciated! I guess I should also thank him for creating Perl :-)"]},{"type":"para","id":"tW4M00vt_1qCd6CPPnzuI","margin":"","location":{"start":{"line":41,"column":1,"offset":1055},"end":{"line":41,"column":194,"offset":1248}},"text":"text","content":["Since writing the original version of this Credits section, I've received a lot of help and feedback from many people on the #raku channel. Thanks to the whole Raku community for being awesome!"]},{"type":"block","id":"nzUj7_OJWQGVHrA9IgdqA","margin":"","level":1,"name":"head","location":{"start":{"line":43,"column":1,"offset":1250},"end":{"line":44,"column":7,"offset":1263}},"content":["AUTHOR"]},{"type":"para","id":"VnT_kn5dkx_pfbtHp5kr2","margin":"","location":{"start":{"line":46,"column":1,"offset":1265},"end":{"line":46,"column":15,"offset":1279}},"text":"text","content":["Timothy Totten"]},{"type":"para","id":"1R42RRvdY9v_SF1IuS-GC","margin":"","location":{"start":{"line":48,"column":1,"offset":1281},"end":{"line":48,"column":116,"offset":1396}},"text":"text","content":["Source can be located at: ",{"meta":"https://github.com/raku-community-modules/PSpec","type":"fcode","name":"L","content":["https://github.com/raku-community-modules/PSpec"]}," . Comments and Pull Requests are welcome."]},{"type":"block","id":"dFejCfxJIAEYXAa6A9Erb","margin":"","level":1,"name":"head","location":{"start":{"line":50,"column":1,"offset":1398},"end":{"line":51,"column":22,"offset":1441}},"content":["COPYRIGHT AND LICENSE"]},{"type":"para","id":"cVz4kFMMXiYVh8B33V_9a","margin":"","location":{"start":{"line":53,"column":1,"offset":1443},"end":{"line":53,"column":37,"offset":1479}},"text":"text","content":["Copyright 2010 - 2019 Timothy Totten"]},{"type":"para","id":"jb6S-2pyW5ZunDOJdjHll","margin":"","location":{"start":{"line":55,"column":1,"offset":1481},"end":{"line":55,"column":37,"offset":1517}},"text":"text","content":["Copyright 2020 - 2022 Raku Community"]},{"type":"para","id":"uZ5ei6fjcQmhIpJTRARMo","margin":"","location":{"start":{"line":57,"column":1,"offset":1519},"end":{"line":57,"column":104,"offset":1622}},"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/PSpec/PSpec-4.0.1/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"","auth":"zef:raku-community-modules","author":"Timothy Totten","build-depends":[],"depends":["Test"],"description":"An RSpec-like testing framework for Raku","dist":"PSpec:ver<4.0.1>:auth<zef:raku-community-modules>","license":"Artistic-2.0","name":"PSpec","path":"P/SP/PSPEC/bbacf7868b4579ec688f8bf11a132637db9e4dfc.tar.gz","perl":"6.*","provides":{"PSpec":"lib/PSpec.rakumod"},"resources":[],"source-url":"git://github.com/raku-community-modules/PSpec.git","tags":[],"test-depends":[],"version":"4.0.1"},"files":[{"file":"work_mods/zef/PSpec/PSpec-4.0.1/README.md","publishUrl":"/mods/zef/PSpec/PSpec-4.0.1/README.md"},{"file":"work_mods/zef/PSpec/PSpec-4.0.1/lib/PSpec.rakumod","publishUrl":"/mods/zef/PSpec/PSpec-4.0.1/lib/PSpec.rakumod"}],"src":"zef","url":"/mods/zef/PSpec"}}}
    =end data
    =end React


root

para

L<Examples| file:../examples/index.podlite>


L<Download |file:../download/index.podlite>


=begin React :component<HeaderCol> :id<menu> 
=para L<Documentation|/doc/introduction>
=para L<Modules| /mods>
=para L<Examples| file:../examples/index.podlite>
=para L<Download |file:../download/index.podlite>
=para L<About|file:../about/index.podlite>
=para 🔍 K<⌘K>/K<ctrl-K>
=end React


HEADER

FOOTER

PSpec


=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


Helper library for creating P6SGI/PSGI compliant frameworks


=begin data
{"type":"page","file":"work_mods/zef/PSGI/PSGI-1.2.1/README.md","sources":[],"node":{"type":"block","id":"LYYo9Gp1PG2i76ntsv4CT","margin":"","name":"root","content":[{"type":"para","id":"4j3YMwzQgE8Y6avNqIr_C","margin":"","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":161,"offset":160}},"text":"text","content":[{"meta":"https://github.com/raku-community-modules/PSGI/actions","type":"fcode","name":"L","content":[{"type":"block","id":"AWRf3A3y3JfHsZGufaRhn","margin":"","name":"Image","config":[],"location":{"start":{"line":1,"column":2,"offset":1},"end":{"line":1,"column":104,"offset":103}},"content":[{"type":"image","src":"https://github.com/raku-community-modules/PSGI/actions/workflows/test.yml/badge.svg","alt":"Actions Status"}]}]}]},{"type":"block","id":"lmLM-qt013Ofj_45ngNF7","margin":"","level":1,"name":"head","location":{"start":{"line":3,"column":1,"offset":162},"end":{"line":4,"column":5,"offset":171}},"content":["NAME"]},{"type":"para","id":"35-GSsORRaZdBwbonPSr7","margin":"","location":{"start":{"line":6,"column":1,"offset":173},"end":{"line":6,"column":67,"offset":239}},"text":"text","content":["PSGI - Helper library for creating P6SGI/PSGI compliant frameworks"]},{"type":"block","id":"d1qOk78YgcW7tTLZ7DXRx","margin":"","level":1,"name":"head","location":{"start":{"line":8,"column":1,"offset":241},"end":{"line":9,"column":9,"offset":258}},"content":["SYNOPSIS"]},{"type":"block","id":"MOPUWBq_lvxQgp6YeGQCz","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":11,"column":1,"offset":260},"end":{"line":54,"column":4,"offset":1248}},"content":[{"type":"verbatim","value":"use PSGI;\n\n# Using a traditional PSGI response array.\n# Headers are an Array of Pairs.\n# Body is an Array of Str or Buf.\nmy $status   = 200;\nmy $headers  = ['Content-Type'=>'text/plain'];\nmy $body     = [\"Hello world\"];\nmy @response = [ $status, $headers, $body ];\nmy $string = encode-psgi-response(@response);\n#\n#   Status: 200 OK\n#   Content-Type: text/plain\n#\n#   Hello world\n#\n\n# Passing the elements individually.\n# Also, this time, we want to use NPH output.\n$string = encode-psgi-response($status, $headers, $body, :nph);\n#\n#   HTTP/1.0 200 OK\n#   Content-Type: text/plain\n#\n#   Hello world\n#\n\n# Now an example using a Hash for headers, and a singleton\n# for the body.\nmy %headers =\n  Content-Type => 'text/plain',\n;\nmy $body-text = \"Hello world\";\n$string = encode-psgi-response($code, %headers, $body-text);\n#\n# Same output as first example\n#\n\n# Populate an %env with P6SGI/PSGI variables.\n#\nmy %env;\npopulate-psgi-env %env, :input($in), :errors($err), :p6sgi<latest>;"}]},{"type":"para","id":"fS_c0_HJVm3mvC8iIGd9W","margin":"","location":{"start":{"line":56,"column":1,"offset":1250},"end":{"line":56,"column":36,"offset":1285}},"text":"text","content":["See the tests for further examples."]},{"type":"block","id":"mmWWtiXM6NaknXWi6qfRG","margin":"","level":1,"name":"head","location":{"start":{"line":58,"column":1,"offset":1287},"end":{"line":59,"column":12,"offset":1310}},"content":["DESCRIPTION"]},{"type":"para","id":"gY4hVyUC34E_4S3TQykOa","margin":"","location":{"start":{"line":61,"column":1,"offset":1312},"end":{"line":61,"column":94,"offset":1405}},"text":"text","content":["Provides functions for encoding P6SGI/PSGI responses, and populating P6SGI/PSGI environments."]},{"type":"para","id":"ix5uxwO-w5mRCqIA87gnz","margin":"","location":{"start":{"line":63,"column":1,"offset":1407},"end":{"line":63,"column":120,"offset":1526}},"text":"text","content":["It supports (in order of preference), P6SGI 0.7Draft, P6SGI 0.4Draft, and a minimal subset of PSGI Classic (from Perl)."]},{"type":"para","id":"diTye_Lu2qVz-kmWVSiR6","margin":"","location":{"start":{"line":65,"column":1,"offset":1528},"end":{"line":65,"column":203,"offset":1730}},"text":"text","content":["If the ",{"type":"fcode","name":"C","content":["populate-psgi-env"]}," subroutine is called without specifying a specific version, both P6SGI 0.7Draft and P6SGI 0.4Draft headers will be included. PSGI Classic headers must be explicitly requested."]},{"type":"block","id":"_fzgfrxj6WlawFBtWQDmT","margin":"","level":1,"name":"head","location":{"start":{"line":67,"column":1,"offset":1732},"end":{"line":68,"column":7,"offset":1745}},"content":["AUTHOR"]},{"type":"para","id":"lu3Rc_aiVps2YfvzlwET7","margin":"","location":{"start":{"line":70,"column":1,"offset":1747},"end":{"line":70,"column":15,"offset":1761}},"text":"text","content":["Timothy Totten"]},{"type":"block","id":"dVDi0weohelGSiDp078jZ","margin":"","level":1,"name":"head","location":{"start":{"line":72,"column":1,"offset":1763},"end":{"line":73,"column":22,"offset":1806}},"content":["COPYRIGHT AND LICENSE"]},{"type":"para","id":"vXD5z_vK78psbhiiJXw0l","margin":"","location":{"start":{"line":75,"column":1,"offset":1808},"end":{"line":75,"column":37,"offset":1844}},"text":"text","content":["Copyright 2013 - 2016 Timothy Totten"]},{"type":"para","id":"6k08ljRPS1TdLPHj363Te","margin":"","location":{"start":{"line":77,"column":1,"offset":1846},"end":{"line":77,"column":37,"offset":1882}},"text":"text","content":["Copyright 2017 - 2022 Raku Community"]},{"type":"para","id":"1w_w4S6Y1sbW1zW2K2eIl","margin":"","location":{"start":{"line":79,"column":1,"offset":1884},"end":{"line":79,"column":104,"offset":1987}},"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/PSGI/PSGI-1.2.1/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"","auth":"zef:raku-community-modules","authors":["Timothy Totten, supernovus","Raku community"],"build-depends":[],"depends":["HTTP::Status"],"description":"Helper library for creating P6SGI/PSGI compliant frameworks","dist":"PSGI:ver<1.2.1>:auth<zef:raku-community-modules>","license":"Artistic-2.0","name":"PSGI","path":"P/SG/PSGI/0ccedc3e50421536bddee5a6317f18374a9384dc.tar.gz","perl":"6.*","provides":{"PSGI":"lib/PSGI.rakumod"},"resources":[],"source-url":"git://github.com/raku-community-modules/PSGI.git","tags":["PSGI"],"test-depends":[],"version":"1.2.1"},"files":[{"file":"work_mods/zef/PSGI/PSGI-1.2.1/README.md","publishUrl":"/mods/zef/PSGI/PSGI-1.2.1/README.md"},{"file":"work_mods/zef/PSGI/PSGI-1.2.1/lib/PSGI.rakumod","publishUrl":"/mods/zef/PSGI/PSGI-1.2.1/lib/PSGI.rakumod"}],"src":"zef","url":"/mods/zef/PSGI"}}}
=end data


    =begin React :component<RenderItem>
    =begin data
    {"type":"page","file":"work_mods/zef/PSGI/PSGI-1.2.1/README.md","sources":[],"node":{"type":"block","id":"LYYo9Gp1PG2i76ntsv4CT","margin":"","name":"root","content":[{"type":"para","id":"4j3YMwzQgE8Y6avNqIr_C","margin":"","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":161,"offset":160}},"text":"text","content":[{"meta":"https://github.com/raku-community-modules/PSGI/actions","type":"fcode","name":"L","content":[{"type":"block","id":"AWRf3A3y3JfHsZGufaRhn","margin":"","name":"Image","config":[],"location":{"start":{"line":1,"column":2,"offset":1},"end":{"line":1,"column":104,"offset":103}},"content":[{"type":"image","src":"https://github.com/raku-community-modules/PSGI/actions/workflows/test.yml/badge.svg","alt":"Actions Status"}]}]}]},{"type":"block","id":"lmLM-qt013Ofj_45ngNF7","margin":"","level":1,"name":"head","location":{"start":{"line":3,"column":1,"offset":162},"end":{"line":4,"column":5,"offset":171}},"content":["NAME"]},{"type":"para","id":"35-GSsORRaZdBwbonPSr7","margin":"","location":{"start":{"line":6,"column":1,"offset":173},"end":{"line":6,"column":67,"offset":239}},"text":"text","content":["PSGI - Helper library for creating P6SGI/PSGI compliant frameworks"]},{"type":"block","id":"d1qOk78YgcW7tTLZ7DXRx","margin":"","level":1,"name":"head","location":{"start":{"line":8,"column":1,"offset":241},"end":{"line":9,"column":9,"offset":258}},"content":["SYNOPSIS"]},{"type":"block","id":"MOPUWBq_lvxQgp6YeGQCz","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":11,"column":1,"offset":260},"end":{"line":54,"column":4,"offset":1248}},"content":[{"type":"verbatim","value":"use PSGI;\n\n# Using a traditional PSGI response array.\n# Headers are an Array of Pairs.\n# Body is an Array of Str or Buf.\nmy $status   = 200;\nmy $headers  = ['Content-Type'=>'text/plain'];\nmy $body     = [\"Hello world\"];\nmy @response = [ $status, $headers, $body ];\nmy $string = encode-psgi-response(@response);\n#\n#   Status: 200 OK\n#   Content-Type: text/plain\n#\n#   Hello world\n#\n\n# Passing the elements individually.\n# Also, this time, we want to use NPH output.\n$string = encode-psgi-response($status, $headers, $body, :nph);\n#\n#   HTTP/1.0 200 OK\n#   Content-Type: text/plain\n#\n#   Hello world\n#\n\n# Now an example using a Hash for headers, and a singleton\n# for the body.\nmy %headers =\n  Content-Type => 'text/plain',\n;\nmy $body-text = \"Hello world\";\n$string = encode-psgi-response($code, %headers, $body-text);\n#\n# Same output as first example\n#\n\n# Populate an %env with P6SGI/PSGI variables.\n#\nmy %env;\npopulate-psgi-env %env, :input($in), :errors($err), :p6sgi<latest>;"}]},{"type":"para","id":"fS_c0_HJVm3mvC8iIGd9W","margin":"","location":{"start":{"line":56,"column":1,"offset":1250},"end":{"line":56,"column":36,"offset":1285}},"text":"text","content":["See the tests for further examples."]},{"type":"block","id":"mmWWtiXM6NaknXWi6qfRG","margin":"","level":1,"name":"head","location":{"start":{"line":58,"column":1,"offset":1287},"end":{"line":59,"column":12,"offset":1310}},"content":["DESCRIPTION"]},{"type":"para","id":"gY4hVyUC34E_4S3TQykOa","margin":"","location":{"start":{"line":61,"column":1,"offset":1312},"end":{"line":61,"column":94,"offset":1405}},"text":"text","content":["Provides functions for encoding P6SGI/PSGI responses, and populating P6SGI/PSGI environments."]},{"type":"para","id":"ix5uxwO-w5mRCqIA87gnz","margin":"","location":{"start":{"line":63,"column":1,"offset":1407},"end":{"line":63,"column":120,"offset":1526}},"text":"text","content":["It supports (in order of preference), P6SGI 0.7Draft, P6SGI 0.4Draft, and a minimal subset of PSGI Classic (from Perl)."]},{"type":"para","id":"diTye_Lu2qVz-kmWVSiR6","margin":"","location":{"start":{"line":65,"column":1,"offset":1528},"end":{"line":65,"column":203,"offset":1730}},"text":"text","content":["If the ",{"type":"fcode","name":"C","content":["populate-psgi-env"]}," subroutine is called without specifying a specific version, both P6SGI 0.7Draft and P6SGI 0.4Draft headers will be included. PSGI Classic headers must be explicitly requested."]},{"type":"block","id":"_fzgfrxj6WlawFBtWQDmT","margin":"","level":1,"name":"head","location":{"start":{"line":67,"column":1,"offset":1732},"end":{"line":68,"column":7,"offset":1745}},"content":["AUTHOR"]},{"type":"para","id":"lu3Rc_aiVps2YfvzlwET7","margin":"","location":{"start":{"line":70,"column":1,"offset":1747},"end":{"line":70,"column":15,"offset":1761}},"text":"text","content":["Timothy Totten"]},{"type":"block","id":"dVDi0weohelGSiDp078jZ","margin":"","level":1,"name":"head","location":{"start":{"line":72,"column":1,"offset":1763},"end":{"line":73,"column":22,"offset":1806}},"content":["COPYRIGHT AND LICENSE"]},{"type":"para","id":"vXD5z_vK78psbhiiJXw0l","margin":"","location":{"start":{"line":75,"column":1,"offset":1808},"end":{"line":75,"column":37,"offset":1844}},"text":"text","content":["Copyright 2013 - 2016 Timothy Totten"]},{"type":"para","id":"6k08ljRPS1TdLPHj363Te","margin":"","location":{"start":{"line":77,"column":1,"offset":1846},"end":{"line":77,"column":37,"offset":1882}},"text":"text","content":["Copyright 2017 - 2022 Raku Community"]},{"type":"para","id":"1w_w4S6Y1sbW1zW2K2eIl","margin":"","location":{"start":{"line":79,"column":1,"offset":1884},"end":{"line":79,"column":104,"offset":1987}},"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/PSGI/PSGI-1.2.1/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"","auth":"zef:raku-community-modules","authors":["Timothy Totten, supernovus","Raku community"],"build-depends":[],"depends":["HTTP::Status"],"description":"Helper library for creating P6SGI/PSGI compliant frameworks","dist":"PSGI:ver<1.2.1>:auth<zef:raku-community-modules>","license":"Artistic-2.0","name":"PSGI","path":"P/SG/PSGI/0ccedc3e50421536bddee5a6317f18374a9384dc.tar.gz","perl":"6.*","provides":{"PSGI":"lib/PSGI.rakumod"},"resources":[],"source-url":"git://github.com/raku-community-modules/PSGI.git","tags":["PSGI"],"test-depends":[],"version":"1.2.1"},"files":[{"file":"work_mods/zef/PSGI/PSGI-1.2.1/README.md","publishUrl":"/mods/zef/PSGI/PSGI-1.2.1/README.md"},{"file":"work_mods/zef/PSGI/PSGI-1.2.1/lib/PSGI.rakumod","publishUrl":"/mods/zef/PSGI/PSGI-1.2.1/lib/PSGI.rakumod"}],"src":"zef","url":"/mods/zef/PSGI"}}}
    =end data
    =end React


PSGI


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


PSpec

NAME

SYNOPSIS

DESCRIPTION

STATUS

TODO

CREDITS

AUTHOR

COPYRIGHT AND LICENSE

PSpec v4.0.1

Authors

License

Dependencies

Test Dependencies

Provides

Documentation