TITLE

retrieve a file from the internet by the best available method


SUBTITLE

data

=begin data
{"type":"page","file":"work_mods/zef/URI::FetchFile/URI-FetchFile-0.0.5/README.md","sources":[],"node":{"type":"block","id":"wcBZV_AdqjF9mB2rlppsL","margin":"","name":"root","content":[{"type":"block","id":"LYxsMYNeYY5W60yHpcj_y","margin":"","level":1,"name":"head","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":16,"offset":15}},"content":["URI-FetchFile"]},{"type":"para","id":"Pzna-BDm6oUNuzs6rwMYa","margin":"","location":{"start":{"line":3,"column":1,"offset":17},"end":{"line":3,"column":78,"offset":94}},"text":"text","content":["Raku module to retrieve a file from the internet by the best available method"]},{"type":"para","id":"BdmdoX5z4uuvchg6GKL7X","margin":"","location":{"start":{"line":5,"column":1,"offset":96},"end":{"line":5,"column":87,"offset":182}},"text":"text","content":[{"type":"block","id":"J40bbIQPLYNNKA2K0XQSI","margin":"","name":"Image","config":[],"location":{"start":{"line":5,"column":1,"offset":96},"end":{"line":5,"column":87,"offset":182}},"content":[{"type":"image","src":"https://github.com/jonathanstowe/URI-FetchFile/workflows/CI/badge.svg","alt":"Build Status"}]}]},{"type":"block","id":"3B4WVZmyarpAmPp_oCoH6","margin":"","level":2,"name":"head","location":{"start":{"line":7,"column":1,"offset":184},"end":{"line":7,"column":12,"offset":195}},"content":["Synopsis"]},{"type":"block","id":"zr7uFSUm6ebFfPuSpXZXS","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":9,"column":1,"offset":197},"end":{"line":20,"column":4,"offset":412}},"content":[{"type":"verbatim","value":"\nuse URI::FetchFile;\n\nif fetch-uri('http://rakudo.org/downloads/star/rakudo-star-2016.10.tar.gz', 'rakudo-star-2016.10.tar.gz') {\n    # do something with the file\n}\nelse {\n    die \"couldn't get file\";\n}\n"}]},{"type":"block","id":"B7mTzlPWPLnmgLfakZMmp","margin":"","level":2,"name":"head","location":{"start":{"line":22,"column":1,"offset":414},"end":{"line":22,"column":15,"offset":428}},"content":["Description"]},{"type":"para","id":"8pKBwmlK70h9xgKVchPDp","margin":"","location":{"start":{"line":24,"column":1,"offset":430},"end":{"line":25,"column":63,"offset":569}},"text":"text","content":["This provides a simple method of retrieving a single file via HTTP using the\nbest available method whilst trying to limit the dependencies."]},{"type":"para","id":"ykq-UWF8iJNdy9h1MGqCX","margin":"","location":{"start":{"line":27,"column":1,"offset":571},"end":{"line":28,"column":54,"offset":702}},"text":"text","content":["It is intended to be used by installers or builders that may need to retrieve\na file but otherwise have no need for an HTTP client."]},{"type":"para","id":"aTToYHDo7oBIwXVunOGxJ","margin":"","location":{"start":{"line":30,"column":1,"offset":704},"end":{"line":30,"column":52,"offset":755}},"text":"text","content":["It will try to use the first available method from:"]},{"type":"block","id":"qQupu7yxvJUlRm8mrEnGy","margin":"","name":"code","config":[],"location":{"start":{"line":32,"column":1,"offset":757},"end":{"line":38,"column":8,"offset":809}},"content":[{"type":"verbatim","value":"* HTTP::UserAgent\n\n* LWP::Simple\n\n* curl\n\n* wget"}]},{"type":"para","id":"KAXG7HyaGAvc-_9lsLGeZ","margin":"","location":{"start":{"line":41,"column":1,"offset":812},"end":{"line":41,"column":63,"offset":874}},"text":"text","content":["Please feel free to suggest and/or implement other mechanisms."]},{"type":"block","id":"q9Ui9by6HWm8V3kKzqZa1","margin":"","level":2,"name":"head","location":{"start":{"line":43,"column":1,"offset":876},"end":{"line":43,"column":16,"offset":891}},"content":["Installation"]},{"type":"para","id":"8IHVAQ-mfPnTHK6wJkXt-","margin":"","location":{"start":{"line":45,"column":1,"offset":893},"end":{"line":45,"column":91,"offset":983}},"text":"text","content":["Assuming you have a working installation of Rakudo you can install this using ",{"type":"fcode","name":"C","content":["zef"]}," :"]},{"type":"block","id":"wUvSLKepaS4b_8o30_ipu","margin":"","name":"code","config":[],"location":{"start":{"line":47,"column":1,"offset":985},"end":{"line":47,"column":28,"offset":1012}},"content":[{"type":"verbatim","value":"zef install URI::FetchFile"}]},{"type":"para","id":"gnjqZsV7d6JQXuwQJf7eX","margin":"","location":{"start":{"line":49,"column":1,"offset":1014},"end":{"line":49,"column":53,"offset":1066}},"text":"text","content":["Other mechanisms may become available in the future."]},{"type":"block","id":"ZKxYnmFHSGaXrNeQWzO4J","margin":"","level":2,"name":"head","location":{"start":{"line":51,"column":1,"offset":1068},"end":{"line":51,"column":11,"offset":1078}},"content":["Support"]},{"type":"para","id":"CB8w1ael5Vp3w5jpK9CEw","margin":"","location":{"start":{"line":53,"column":1,"offset":1080},"end":{"line":53,"column":108,"offset":1187}},"text":"text","content":["Please make any reports, suggestions etc to ",{"meta":"https://github.com/jonathanstowe/URI-FetchFile/issues","type":"fcode","name":"L","content":["Github"]}]},{"type":"block","id":"OP250opaoGyeoFx9-5Gt8","margin":"","level":2,"name":"head","location":{"start":{"line":55,"column":1,"offset":1189},"end":{"line":55,"column":25,"offset":1213}},"content":["Licence and Copyright"]},{"type":"para","id":"i0EbFwzz0VflYUGf7B_GY","margin":"","location":{"start":{"line":57,"column":1,"offset":1215},"end":{"line":57,"column":78,"offset":1292}},"text":"text","content":["This is free software please see the the ",{"meta":"LICENCE","type":"fcode","name":"L","content":["LICENCE"]}," file for details."]},{"type":"para","id":"bJIxksfjNlhkE7OA_gzg6","margin":"","location":{"start":{"line":59,"column":1,"offset":1294},"end":{"line":59,"column":29,"offset":1322}},"text":"text","content":["© Jonathan Stowe 2016 - 2021"]}]},"publishUrl":"/mods/zef/URI::FetchFile/URI-FetchFile-0.0.5/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"1.0","auth":"zef:jonathanstowe","authors":["Jonathan Stowe <jns+gh@gellyfish.co.uk>"],"build-depends":[],"depends":["File::Which"],"description":"retrieve a file from the internet by the best available method","dist":"URI::FetchFile:ver<0.0.5>:auth<zef:jonathanstowe>","license":"Artistic-2.0","meta-version":"1","name":"URI::FetchFile","path":"U/RI/URI_FETCHFILE/c2121a9245eb0fc1d44a0235f1d3ef5226678644.tar.gz","provides":{"URI::FetchFile":"lib/URI/FetchFile.pm"},"raku":"6.*","resources":[],"source-url":"https://github.com/jonathanstowe/URI-FetchFile.git","support":{"source":"https://github.com/jonathanstowe/URI-FetchFile.git"},"tags":["download","utility","http"],"test-depends":["Test"],"version":"0.0.5"},"files":[{"file":"work_mods/zef/URI::FetchFile/URI-FetchFile-0.0.5/README.md","publishUrl":"/mods/zef/URI::FetchFile/URI-FetchFile-0.0.5/README.md"},{"file":"work_mods/zef/URI::FetchFile/URI-FetchFile-0.0.5/lib/URI/FetchFile.pm","publishUrl":"/mods/zef/URI::FetchFile/URI-FetchFile-0.0.5/lib/URI/FetchFile.pm"}],"src":"zef","url":"/mods/zef/URI::FetchFile"}}}
=end data


React

    =begin React :component<RenderItem>
    =begin data
    {"type":"page","file":"work_mods/zef/URI::FetchFile/URI-FetchFile-0.0.5/README.md","sources":[],"node":{"type":"block","id":"wcBZV_AdqjF9mB2rlppsL","margin":"","name":"root","content":[{"type":"block","id":"LYxsMYNeYY5W60yHpcj_y","margin":"","level":1,"name":"head","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":16,"offset":15}},"content":["URI-FetchFile"]},{"type":"para","id":"Pzna-BDm6oUNuzs6rwMYa","margin":"","location":{"start":{"line":3,"column":1,"offset":17},"end":{"line":3,"column":78,"offset":94}},"text":"text","content":["Raku module to retrieve a file from the internet by the best available method"]},{"type":"para","id":"BdmdoX5z4uuvchg6GKL7X","margin":"","location":{"start":{"line":5,"column":1,"offset":96},"end":{"line":5,"column":87,"offset":182}},"text":"text","content":[{"type":"block","id":"J40bbIQPLYNNKA2K0XQSI","margin":"","name":"Image","config":[],"location":{"start":{"line":5,"column":1,"offset":96},"end":{"line":5,"column":87,"offset":182}},"content":[{"type":"image","src":"https://github.com/jonathanstowe/URI-FetchFile/workflows/CI/badge.svg","alt":"Build Status"}]}]},{"type":"block","id":"3B4WVZmyarpAmPp_oCoH6","margin":"","level":2,"name":"head","location":{"start":{"line":7,"column":1,"offset":184},"end":{"line":7,"column":12,"offset":195}},"content":["Synopsis"]},{"type":"block","id":"zr7uFSUm6ebFfPuSpXZXS","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":9,"column":1,"offset":197},"end":{"line":20,"column":4,"offset":412}},"content":[{"type":"verbatim","value":"\nuse URI::FetchFile;\n\nif fetch-uri('http://rakudo.org/downloads/star/rakudo-star-2016.10.tar.gz', 'rakudo-star-2016.10.tar.gz') {\n    # do something with the file\n}\nelse {\n    die \"couldn't get file\";\n}\n"}]},{"type":"block","id":"B7mTzlPWPLnmgLfakZMmp","margin":"","level":2,"name":"head","location":{"start":{"line":22,"column":1,"offset":414},"end":{"line":22,"column":15,"offset":428}},"content":["Description"]},{"type":"para","id":"8pKBwmlK70h9xgKVchPDp","margin":"","location":{"start":{"line":24,"column":1,"offset":430},"end":{"line":25,"column":63,"offset":569}},"text":"text","content":["This provides a simple method of retrieving a single file via HTTP using the\nbest available method whilst trying to limit the dependencies."]},{"type":"para","id":"ykq-UWF8iJNdy9h1MGqCX","margin":"","location":{"start":{"line":27,"column":1,"offset":571},"end":{"line":28,"column":54,"offset":702}},"text":"text","content":["It is intended to be used by installers or builders that may need to retrieve\na file but otherwise have no need for an HTTP client."]},{"type":"para","id":"aTToYHDo7oBIwXVunOGxJ","margin":"","location":{"start":{"line":30,"column":1,"offset":704},"end":{"line":30,"column":52,"offset":755}},"text":"text","content":["It will try to use the first available method from:"]},{"type":"block","id":"qQupu7yxvJUlRm8mrEnGy","margin":"","name":"code","config":[],"location":{"start":{"line":32,"column":1,"offset":757},"end":{"line":38,"column":8,"offset":809}},"content":[{"type":"verbatim","value":"* HTTP::UserAgent\n\n* LWP::Simple\n\n* curl\n\n* wget"}]},{"type":"para","id":"KAXG7HyaGAvc-_9lsLGeZ","margin":"","location":{"start":{"line":41,"column":1,"offset":812},"end":{"line":41,"column":63,"offset":874}},"text":"text","content":["Please feel free to suggest and/or implement other mechanisms."]},{"type":"block","id":"q9Ui9by6HWm8V3kKzqZa1","margin":"","level":2,"name":"head","location":{"start":{"line":43,"column":1,"offset":876},"end":{"line":43,"column":16,"offset":891}},"content":["Installation"]},{"type":"para","id":"8IHVAQ-mfPnTHK6wJkXt-","margin":"","location":{"start":{"line":45,"column":1,"offset":893},"end":{"line":45,"column":91,"offset":983}},"text":"text","content":["Assuming you have a working installation of Rakudo you can install this using ",{"type":"fcode","name":"C","content":["zef"]}," :"]},{"type":"block","id":"wUvSLKepaS4b_8o30_ipu","margin":"","name":"code","config":[],"location":{"start":{"line":47,"column":1,"offset":985},"end":{"line":47,"column":28,"offset":1012}},"content":[{"type":"verbatim","value":"zef install URI::FetchFile"}]},{"type":"para","id":"gnjqZsV7d6JQXuwQJf7eX","margin":"","location":{"start":{"line":49,"column":1,"offset":1014},"end":{"line":49,"column":53,"offset":1066}},"text":"text","content":["Other mechanisms may become available in the future."]},{"type":"block","id":"ZKxYnmFHSGaXrNeQWzO4J","margin":"","level":2,"name":"head","location":{"start":{"line":51,"column":1,"offset":1068},"end":{"line":51,"column":11,"offset":1078}},"content":["Support"]},{"type":"para","id":"CB8w1ael5Vp3w5jpK9CEw","margin":"","location":{"start":{"line":53,"column":1,"offset":1080},"end":{"line":53,"column":108,"offset":1187}},"text":"text","content":["Please make any reports, suggestions etc to ",{"meta":"https://github.com/jonathanstowe/URI-FetchFile/issues","type":"fcode","name":"L","content":["Github"]}]},{"type":"block","id":"OP250opaoGyeoFx9-5Gt8","margin":"","level":2,"name":"head","location":{"start":{"line":55,"column":1,"offset":1189},"end":{"line":55,"column":25,"offset":1213}},"content":["Licence and Copyright"]},{"type":"para","id":"i0EbFwzz0VflYUGf7B_GY","margin":"","location":{"start":{"line":57,"column":1,"offset":1215},"end":{"line":57,"column":78,"offset":1292}},"text":"text","content":["This is free software please see the the ",{"meta":"LICENCE","type":"fcode","name":"L","content":["LICENCE"]}," file for details."]},{"type":"para","id":"bJIxksfjNlhkE7OA_gzg6","margin":"","location":{"start":{"line":59,"column":1,"offset":1294},"end":{"line":59,"column":29,"offset":1322}},"text":"text","content":["© Jonathan Stowe 2016 - 2021"]}]},"publishUrl":"/mods/zef/URI::FetchFile/URI-FetchFile-0.0.5/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"1.0","auth":"zef:jonathanstowe","authors":["Jonathan Stowe <jns+gh@gellyfish.co.uk>"],"build-depends":[],"depends":["File::Which"],"description":"retrieve a file from the internet by the best available method","dist":"URI::FetchFile:ver<0.0.5>:auth<zef:jonathanstowe>","license":"Artistic-2.0","meta-version":"1","name":"URI::FetchFile","path":"U/RI/URI_FETCHFILE/c2121a9245eb0fc1d44a0235f1d3ef5226678644.tar.gz","provides":{"URI::FetchFile":"lib/URI/FetchFile.pm"},"raku":"6.*","resources":[],"source-url":"https://github.com/jonathanstowe/URI-FetchFile.git","support":{"source":"https://github.com/jonathanstowe/URI-FetchFile.git"},"tags":["download","utility","http"],"test-depends":["Test"],"version":"0.0.5"},"files":[{"file":"work_mods/zef/URI::FetchFile/URI-FetchFile-0.0.5/README.md","publishUrl":"/mods/zef/URI::FetchFile/URI-FetchFile-0.0.5/README.md"},{"file":"work_mods/zef/URI::FetchFile/URI-FetchFile-0.0.5/lib/URI/FetchFile.pm","publishUrl":"/mods/zef/URI::FetchFile/URI-FetchFile-0.0.5/lib/URI/FetchFile.pm"}],"src":"zef","url":"/mods/zef/URI::FetchFile"}}}
    =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

URI::FetchFile


=begin data
{"type":"page","file":"work_mods/zef/URI::Query::FromHash/URI-Query-FromHash-0.0.1/README.md","sources":[],"node":{"type":"block","id":"zvflDpG0gqEhoX2RGycsC","margin":"","name":"root","content":[{"type":"block","id":"AomQ1pRXJdB6yH6y_jkfJ","margin":"","level":1,"name":"head","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":7,"offset":6}},"content":["NAME"]},{"type":"para","id":"KIOMhtayQsWhdbv7fwAeU","margin":"","location":{"start":{"line":3,"column":1,"offset":8},"end":{"line":3,"column":60,"offset":67}},"text":"text","content":["URI::Query::FromHash - Construct a query string from a hash"]},{"type":"block","id":"7fD3SIUGX5VO_2-eHCJc0","margin":"","level":1,"name":"head","location":{"start":{"line":5,"column":1,"offset":69},"end":{"line":5,"column":11,"offset":79}},"content":["SYNOPSIS"]},{"type":"block","id":"b8djHtoOFQ2uXafkZsG8Q","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":7,"column":1,"offset":81},"end":{"line":17,"column":4,"offset":253}},"content":[{"type":"verbatim","value":"use URI::Query::FromHash;\n\nsay hash2query {\n   foo  => 'bar',\n   baz  => < qux quux >,\n   utf8 => '🦋',\n}\n# OUTPUT:\n# baz=qux&baz=quux&foo=bar&utf8=%F0%9F%A6%8B"}]},{"type":"block","id":"OXbBKpEmW4DgbkcfIl1gt","margin":"","level":1,"name":"head","location":{"start":{"line":19,"column":1,"offset":255},"end":{"line":19,"column":14,"offset":268}},"content":["DESCRIPTION"]},{"type":"para","id":"OHZPjAHxvVphte8q8CgRy","margin":"","location":{"start":{"line":21,"column":1,"offset":270},"end":{"line":21,"column":72,"offset":341}},"text":"text","content":["URI::Query::FromHash aims to be a fast, light query string constructor."]},{"type":"para","id":"Rz8XHJvwatrFzGu7BCcjx","margin":"","location":{"start":{"line":23,"column":1,"offset":343},"end":{"line":24,"column":30,"offset":444}},"text":"text","content":["Inspired by ",{"meta":"https://metacpan.org/pod/URI::Query::FromHash","type":"fcode","name":"L","content":["the Perl module of the same name"]}," and Ruby on Rails'\n",{"meta":"http://api.rubyonrails.org/classes/Hash.html#method-i-to_query","type":"fcode","name":"L","content":["to_query"]}," hash method."]},{"type":"block","id":"pICfFftAjUrpfhsGCbYVy","margin":"","level":1,"name":"head","location":{"start":{"line":26,"column":1,"offset":446},"end":{"line":26,"column":14,"offset":459}},"content":["SUBROUTINES"]},{"type":"block","id":"rPoU1PKXDPTeFBsG5wk54","margin":"","level":2,"name":"head","location":{"start":{"line":28,"column":1,"offset":461},"end":{"line":28,"column":14,"offset":474}},"content":["hash2query"]},{"type":"block","id":"i8D9zyfzV_7LOKRjybdFA","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":30,"column":1,"offset":476},"end":{"line":32,"column":4,"offset":527}},"content":[{"type":"verbatim","value":"sub hash2query ( Hash() $hash --> Str )"}]},{"type":"para","id":"nEquOtjV0zmyUWZrFJ-bF","margin":"","location":{"start":{"line":34,"column":1,"offset":529},"end":{"line":39,"column":41,"offset":945}},"text":"text","content":["Accepts anything that can be coerced to a Hash of query parameters and returns\na Str suitable to be used as the query parameters of a URI. Values will be\ncoerced to List and iterated over, with every element being coerced to Str\nbefore processing. Every one of these elements will then be URL-encoded and\nwill appear in the generated string once preceded by the corresponding\nURL-encoded key and an equal sign (",{"type":"fcode","name":"C","content":["="]},")."]},{"type":"para","id":"Tj5xRZskOrQ0kU8mA3v7u","margin":"","location":{"start":{"line":41,"column":1,"offset":947},"end":{"line":41,"column":65,"offset":1011}},"text":"text","content":["Pairs in the input Hash will be processed alphabetically by key."]},{"type":"para","id":"1rWz75xKQob8fsWKiSgYH","margin":"","location":{"start":{"line":43,"column":1,"offset":1013},"end":{"line":44,"column":49,"offset":1136}},"text":"text","content":["When this function encounters input it cannot handle, it returns the empty\nstring, meaning it should always be safe to use."]},{"type":"para","id":"vLXljNSTWDsbXKgE0ATNc","margin":"","location":{"start":{"line":46,"column":1,"offset":1138},"end":{"line":46,"column":38,"offset":1175}},"text":"text","content":["This function is exported by default."]},{"type":"block","id":"TRTnpQmqjJtRqA_p9iOli","margin":"","level":1,"name":"head","location":{"start":{"line":48,"column":1,"offset":1177},"end":{"line":48,"column":24,"offset":1200}},"content":["COPYRIGHT AND LICENSE"]},{"type":"para","id":"5BWqy4MHV2oSEuHEZoINM","margin":"","location":{"start":{"line":50,"column":1,"offset":1202},"end":{"line":50,"column":38,"offset":1239}},"text":"text","content":["Copyright © 2022 by Raku Land authors"]},{"type":"para","id":"ZGrYkOXu21NerLI05CE0U","margin":"","location":{"start":{"line":52,"column":1,"offset":1241},"end":{"line":53,"column":26,"offset":1344}},"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/URI::Query::FromHash/URI-Query-FromHash-0.0.1/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"","auth":"zef:raku-land","authors":["José Joaquín Atria","James Raspass"],"depends":[],"description":"Construct a query string from a hash","dist":"URI::Query::FromHash:ver<0.0.1>:auth<zef:raku-land>","license":"Artistic-2.0","name":"URI::Query::FromHash","path":"U/RI/URI_QUERY_FROMHASH/929650fc90f980a97bbb321e614eeff52e3c07ed.tar.gz","perl":"6.d","provides":{"URI::Query::FromHash":"lib/URI/Query/FromHash.rakumod"},"source-url":"https://gitlab.com/raku-land/uri-query-fromhash.git","tags":["Encoding","HTTP","URL"],"version":"0.0.1"},"files":[{"file":"work_mods/zef/URI::Query::FromHash/URI-Query-FromHash-0.0.1/README.md","publishUrl":"/mods/zef/URI::Query::FromHash/URI-Query-FromHash-0.0.1/README.md"},{"file":"work_mods/zef/URI::Query::FromHash/URI-Query-FromHash-0.0.1/URI-Qeuery-FromHash-0.0.1/README.md","publishUrl":"/mods/zef/URI::Query::FromHash/URI-Query-FromHash-0.0.1/URI-Qeuery-FromHash-0.0.1/README.md"},{"file":"work_mods/zef/URI::Query::FromHash/URI-Query-FromHash-0.0.1/lib/URI/Query/FromHash.rakumod","publishUrl":"/mods/zef/URI::Query::FromHash/URI-Query-FromHash-0.0.1/lib/URI/Query/FromHash.rakumod"},{"file":"work_mods/zef/URI::Query::FromHash/URI-Query-FromHash-0.0.1/URI-Qeuery-FromHash-0.0.1/lib/URI/Query/FromHash.rakumod","publishUrl":"/mods/zef/URI::Query::FromHash/URI-Query-FromHash-0.0.1/URI-Qeuery-FromHash-0.0.1/lib/URI/Query/FromHash.rakumod"}],"src":"zef","url":"/mods/zef/URI::Query::FromHash"}}}
=end data


    =begin React :component<RenderItem>
    =begin data
    {"type":"page","file":"work_mods/zef/URI::Query::FromHash/URI-Query-FromHash-0.0.1/README.md","sources":[],"node":{"type":"block","id":"zvflDpG0gqEhoX2RGycsC","margin":"","name":"root","content":[{"type":"block","id":"AomQ1pRXJdB6yH6y_jkfJ","margin":"","level":1,"name":"head","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":7,"offset":6}},"content":["NAME"]},{"type":"para","id":"KIOMhtayQsWhdbv7fwAeU","margin":"","location":{"start":{"line":3,"column":1,"offset":8},"end":{"line":3,"column":60,"offset":67}},"text":"text","content":["URI::Query::FromHash - Construct a query string from a hash"]},{"type":"block","id":"7fD3SIUGX5VO_2-eHCJc0","margin":"","level":1,"name":"head","location":{"start":{"line":5,"column":1,"offset":69},"end":{"line":5,"column":11,"offset":79}},"content":["SYNOPSIS"]},{"type":"block","id":"b8djHtoOFQ2uXafkZsG8Q","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":7,"column":1,"offset":81},"end":{"line":17,"column":4,"offset":253}},"content":[{"type":"verbatim","value":"use URI::Query::FromHash;\n\nsay hash2query {\n   foo  => 'bar',\n   baz  => < qux quux >,\n   utf8 => '🦋',\n}\n# OUTPUT:\n# baz=qux&baz=quux&foo=bar&utf8=%F0%9F%A6%8B"}]},{"type":"block","id":"OXbBKpEmW4DgbkcfIl1gt","margin":"","level":1,"name":"head","location":{"start":{"line":19,"column":1,"offset":255},"end":{"line":19,"column":14,"offset":268}},"content":["DESCRIPTION"]},{"type":"para","id":"OHZPjAHxvVphte8q8CgRy","margin":"","location":{"start":{"line":21,"column":1,"offset":270},"end":{"line":21,"column":72,"offset":341}},"text":"text","content":["URI::Query::FromHash aims to be a fast, light query string constructor."]},{"type":"para","id":"Rz8XHJvwatrFzGu7BCcjx","margin":"","location":{"start":{"line":23,"column":1,"offset":343},"end":{"line":24,"column":30,"offset":444}},"text":"text","content":["Inspired by ",{"meta":"https://metacpan.org/pod/URI::Query::FromHash","type":"fcode","name":"L","content":["the Perl module of the same name"]}," and Ruby on Rails'\n",{"meta":"http://api.rubyonrails.org/classes/Hash.html#method-i-to_query","type":"fcode","name":"L","content":["to_query"]}," hash method."]},{"type":"block","id":"pICfFftAjUrpfhsGCbYVy","margin":"","level":1,"name":"head","location":{"start":{"line":26,"column":1,"offset":446},"end":{"line":26,"column":14,"offset":459}},"content":["SUBROUTINES"]},{"type":"block","id":"rPoU1PKXDPTeFBsG5wk54","margin":"","level":2,"name":"head","location":{"start":{"line":28,"column":1,"offset":461},"end":{"line":28,"column":14,"offset":474}},"content":["hash2query"]},{"type":"block","id":"i8D9zyfzV_7LOKRjybdFA","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":30,"column":1,"offset":476},"end":{"line":32,"column":4,"offset":527}},"content":[{"type":"verbatim","value":"sub hash2query ( Hash() $hash --> Str )"}]},{"type":"para","id":"nEquOtjV0zmyUWZrFJ-bF","margin":"","location":{"start":{"line":34,"column":1,"offset":529},"end":{"line":39,"column":41,"offset":945}},"text":"text","content":["Accepts anything that can be coerced to a Hash of query parameters and returns\na Str suitable to be used as the query parameters of a URI. Values will be\ncoerced to List and iterated over, with every element being coerced to Str\nbefore processing. Every one of these elements will then be URL-encoded and\nwill appear in the generated string once preceded by the corresponding\nURL-encoded key and an equal sign (",{"type":"fcode","name":"C","content":["="]},")."]},{"type":"para","id":"Tj5xRZskOrQ0kU8mA3v7u","margin":"","location":{"start":{"line":41,"column":1,"offset":947},"end":{"line":41,"column":65,"offset":1011}},"text":"text","content":["Pairs in the input Hash will be processed alphabetically by key."]},{"type":"para","id":"1rWz75xKQob8fsWKiSgYH","margin":"","location":{"start":{"line":43,"column":1,"offset":1013},"end":{"line":44,"column":49,"offset":1136}},"text":"text","content":["When this function encounters input it cannot handle, it returns the empty\nstring, meaning it should always be safe to use."]},{"type":"para","id":"vLXljNSTWDsbXKgE0ATNc","margin":"","location":{"start":{"line":46,"column":1,"offset":1138},"end":{"line":46,"column":38,"offset":1175}},"text":"text","content":["This function is exported by default."]},{"type":"block","id":"TRTnpQmqjJtRqA_p9iOli","margin":"","level":1,"name":"head","location":{"start":{"line":48,"column":1,"offset":1177},"end":{"line":48,"column":24,"offset":1200}},"content":["COPYRIGHT AND LICENSE"]},{"type":"para","id":"5BWqy4MHV2oSEuHEZoINM","margin":"","location":{"start":{"line":50,"column":1,"offset":1202},"end":{"line":50,"column":38,"offset":1239}},"text":"text","content":["Copyright © 2022 by Raku Land authors"]},{"type":"para","id":"ZGrYkOXu21NerLI05CE0U","margin":"","location":{"start":{"line":52,"column":1,"offset":1241},"end":{"line":53,"column":26,"offset":1344}},"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/URI::Query::FromHash/URI-Query-FromHash-0.0.1/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"","auth":"zef:raku-land","authors":["José Joaquín Atria","James Raspass"],"depends":[],"description":"Construct a query string from a hash","dist":"URI::Query::FromHash:ver<0.0.1>:auth<zef:raku-land>","license":"Artistic-2.0","name":"URI::Query::FromHash","path":"U/RI/URI_QUERY_FROMHASH/929650fc90f980a97bbb321e614eeff52e3c07ed.tar.gz","perl":"6.d","provides":{"URI::Query::FromHash":"lib/URI/Query/FromHash.rakumod"},"source-url":"https://gitlab.com/raku-land/uri-query-fromhash.git","tags":["Encoding","HTTP","URL"],"version":"0.0.1"},"files":[{"file":"work_mods/zef/URI::Query::FromHash/URI-Query-FromHash-0.0.1/README.md","publishUrl":"/mods/zef/URI::Query::FromHash/URI-Query-FromHash-0.0.1/README.md"},{"file":"work_mods/zef/URI::Query::FromHash/URI-Query-FromHash-0.0.1/URI-Qeuery-FromHash-0.0.1/README.md","publishUrl":"/mods/zef/URI::Query::FromHash/URI-Query-FromHash-0.0.1/URI-Qeuery-FromHash-0.0.1/README.md"},{"file":"work_mods/zef/URI::Query::FromHash/URI-Query-FromHash-0.0.1/lib/URI/Query/FromHash.rakumod","publishUrl":"/mods/zef/URI::Query::FromHash/URI-Query-FromHash-0.0.1/lib/URI/Query/FromHash.rakumod"},{"file":"work_mods/zef/URI::Query::FromHash/URI-Query-FromHash-0.0.1/URI-Qeuery-FromHash-0.0.1/lib/URI/Query/FromHash.rakumod","publishUrl":"/mods/zef/URI::Query::FromHash/URI-Query-FromHash-0.0.1/URI-Qeuery-FromHash-0.0.1/lib/URI/Query/FromHash.rakumod"}],"src":"zef","url":"/mods/zef/URI::Query::FromHash"}}}
    =end data
    =end React


Construct a query string from a hash


URI::Query::FromHash


Encode and decode URIs according to RFC 3986


=begin data
{"type":"page","file":"work_mods/zef/URI::Encode/dist/README.md","sources":[],"node":{"type":"block","id":"3yizHm5f9zQFFKEzJllX3","margin":"","name":"root","content":[{"type":"block","id":"FmuCuvyFnfj0xOYTgtfBY","margin":"","level":1,"name":"head","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":209,"offset":208}},"content":["URI::Encode ",{"meta":"https://github.com/raku-community-modules/URI-Encode/actions/workflows/test.yaml","type":"fcode","name":"L","content":[{"type":"block","id":"eti8JT9lfzAa8fqTvE3BW","margin":"","name":"Image","config":[],"location":{"start":{"line":1,"column":16,"offset":15},"end":{"line":1,"column":126,"offset":125}},"content":[{"type":"image","src":"https://github.com/raku-community-modules/URI-Encode/actions/workflows/test.yaml/badge.svg","alt":"Tests on source"}]}]}]},{"type":"para","id":"Im0_h48sBD7C266bv1U_a","margin":"","location":{"start":{"line":3,"column":1,"offset":210},"end":{"line":3,"column":43,"offset":252}},"text":"text","content":["A Raku module for encoding / decoding URIs"]},{"type":"block","id":"Hw0DZslAqCUoOlr_BO0cD","margin":"","level":1,"name":"head","location":{"start":{"line":5,"column":1,"offset":254},"end":{"line":5,"column":11,"offset":264}},"content":["Synopsis"]},{"type":"block","id":"Q_htMOxL6I-H0pm6XWhqT","margin":"","name":"code","config":[],"location":{"start":{"line":7,"column":1,"offset":266},"end":{"line":19,"column":85,"offset":820}},"content":[{"type":"verbatim","value":"use URI::Encode;\n\n# for encoding whole URIs, ignores reserved chars: :/?#[]@!$&'()*+,;=\nmy $encoded_uri = uri_encode('http://www.example.com/?name=john doe&age=54');\n\n# encode every reserved char\nmy $encoded_uri_component = uri_encode_component('some text/to encode+ safely');\n\n# remove percent encoding\nmy $decoded_uri = uri_decode('http://www.example.com/?name=john%20doe&age=54');\n\n# provided for symmetry, is the same as uri_decode()\nmy $decoded_component = uri_decode_component('some%20text%2Fto%20%2B%20safely');"}]},{"type":"block","id":"EbB0-88C47pywon1t-eCI","margin":"","level":2,"name":"head","location":{"start":{"line":21,"column":1,"offset":822},"end":{"line":21,"column":12,"offset":833}},"content":["See also"]},{"type":"para","id":"7-jtd8-a7eXdmKxDwkHcO","margin":"","location":{"start":{"line":23,"column":1,"offset":835},"end":{"line":24,"column":80,"offset":984}},"text":"text","content":[{"meta":"https://raku.land/github:raku-community-modules/URI","type":"fcode","name":"L","content":["URI"]}," is another\nimplementation that covers this area, including encoding and decoding of URIs."]},{"type":"block","id":"sisJ_rkuUs-sHyz8tZd8e","margin":"","level":2,"name":"head","location":{"start":{"line":26,"column":1,"offset":986},"end":{"line":26,"column":10,"offset":995}},"content":["Author"]},{"type":"para","id":"tbRpfe6n6uPcnYp_o8ePg","margin":"","location":{"start":{"line":28,"column":1,"offset":997},"end":{"line":28,"column":78,"offset":1074}},"text":"text","content":["David Farrell, 2015; lately maintained by the Raku community adoption center."]},{"type":"block","id":"1ucWz9Xp2AHgSGxLEYVDe","margin":"","level":2,"name":"head","location":{"start":{"line":30,"column":1,"offset":1076},"end":{"line":30,"column":11,"offset":1086}},"content":["License"]},{"type":"para","id":"JV-Xbw8n0-URZzzKsJtgz","margin":"","location":{"start":{"line":32,"column":1,"offset":1088},"end":{"line":32,"column":33,"offset":1120}},"text":"text","content":["FreeBSD - see ",{"meta":"LICENSE","type":"fcode","name":"L","content":["LICENSE"]}]}]},"publishUrl":"/mods/zef/URI::Encode/dist/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"","auth":"zef:raku-community-modules","authors":["David Farrell","Raku community"],"depends":[],"description":"Encode and decode URIs according to RFC 3986","dist":"URI::Encode:ver<0.09>:auth<zef:raku-community-modules>","name":"URI::Encode","path":"U/RI/URI_ENCODE/44046038356c5e83ec603dff2486d91870355c28.tar.gz","perl":"6.*","provides":{"URI::Encode":"lib/URI/Encode.pm6"},"source-url":"https://github.com/raku-community-modules/URI-Encode","support":{"bugtracker":"https://github.com/raku-community-modules/URI-Encode/issues","source":"git@github.com:raku-community-modules/URI-Encode.git"},"test-depends":["Test"],"version":"0.09"},"files":[{"file":"work_mods/zef/URI::Encode/dist/README.md","publishUrl":"/mods/zef/URI::Encode/dist/README.md"}],"src":"zef","url":"/mods/zef/URI::Encode"}}}
=end data


    =begin React :component<RenderItem>
    =begin data
    {"type":"page","file":"work_mods/zef/URI::Encode/dist/README.md","sources":[],"node":{"type":"block","id":"3yizHm5f9zQFFKEzJllX3","margin":"","name":"root","content":[{"type":"block","id":"FmuCuvyFnfj0xOYTgtfBY","margin":"","level":1,"name":"head","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":209,"offset":208}},"content":["URI::Encode ",{"meta":"https://github.com/raku-community-modules/URI-Encode/actions/workflows/test.yaml","type":"fcode","name":"L","content":[{"type":"block","id":"eti8JT9lfzAa8fqTvE3BW","margin":"","name":"Image","config":[],"location":{"start":{"line":1,"column":16,"offset":15},"end":{"line":1,"column":126,"offset":125}},"content":[{"type":"image","src":"https://github.com/raku-community-modules/URI-Encode/actions/workflows/test.yaml/badge.svg","alt":"Tests on source"}]}]}]},{"type":"para","id":"Im0_h48sBD7C266bv1U_a","margin":"","location":{"start":{"line":3,"column":1,"offset":210},"end":{"line":3,"column":43,"offset":252}},"text":"text","content":["A Raku module for encoding / decoding URIs"]},{"type":"block","id":"Hw0DZslAqCUoOlr_BO0cD","margin":"","level":1,"name":"head","location":{"start":{"line":5,"column":1,"offset":254},"end":{"line":5,"column":11,"offset":264}},"content":["Synopsis"]},{"type":"block","id":"Q_htMOxL6I-H0pm6XWhqT","margin":"","name":"code","config":[],"location":{"start":{"line":7,"column":1,"offset":266},"end":{"line":19,"column":85,"offset":820}},"content":[{"type":"verbatim","value":"use URI::Encode;\n\n# for encoding whole URIs, ignores reserved chars: :/?#[]@!$&'()*+,;=\nmy $encoded_uri = uri_encode('http://www.example.com/?name=john doe&age=54');\n\n# encode every reserved char\nmy $encoded_uri_component = uri_encode_component('some text/to encode+ safely');\n\n# remove percent encoding\nmy $decoded_uri = uri_decode('http://www.example.com/?name=john%20doe&age=54');\n\n# provided for symmetry, is the same as uri_decode()\nmy $decoded_component = uri_decode_component('some%20text%2Fto%20%2B%20safely');"}]},{"type":"block","id":"EbB0-88C47pywon1t-eCI","margin":"","level":2,"name":"head","location":{"start":{"line":21,"column":1,"offset":822},"end":{"line":21,"column":12,"offset":833}},"content":["See also"]},{"type":"para","id":"7-jtd8-a7eXdmKxDwkHcO","margin":"","location":{"start":{"line":23,"column":1,"offset":835},"end":{"line":24,"column":80,"offset":984}},"text":"text","content":[{"meta":"https://raku.land/github:raku-community-modules/URI","type":"fcode","name":"L","content":["URI"]}," is another\nimplementation that covers this area, including encoding and decoding of URIs."]},{"type":"block","id":"sisJ_rkuUs-sHyz8tZd8e","margin":"","level":2,"name":"head","location":{"start":{"line":26,"column":1,"offset":986},"end":{"line":26,"column":10,"offset":995}},"content":["Author"]},{"type":"para","id":"tbRpfe6n6uPcnYp_o8ePg","margin":"","location":{"start":{"line":28,"column":1,"offset":997},"end":{"line":28,"column":78,"offset":1074}},"text":"text","content":["David Farrell, 2015; lately maintained by the Raku community adoption center."]},{"type":"block","id":"1ucWz9Xp2AHgSGxLEYVDe","margin":"","level":2,"name":"head","location":{"start":{"line":30,"column":1,"offset":1076},"end":{"line":30,"column":11,"offset":1086}},"content":["License"]},{"type":"para","id":"JV-Xbw8n0-URZzzKsJtgz","margin":"","location":{"start":{"line":32,"column":1,"offset":1088},"end":{"line":32,"column":33,"offset":1120}},"text":"text","content":["FreeBSD - see ",{"meta":"LICENSE","type":"fcode","name":"L","content":["LICENSE"]}]}]},"publishUrl":"/mods/zef/URI::Encode/dist/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"","auth":"zef:raku-community-modules","authors":["David Farrell","Raku community"],"depends":[],"description":"Encode and decode URIs according to RFC 3986","dist":"URI::Encode:ver<0.09>:auth<zef:raku-community-modules>","name":"URI::Encode","path":"U/RI/URI_ENCODE/44046038356c5e83ec603dff2486d91870355c28.tar.gz","perl":"6.*","provides":{"URI::Encode":"lib/URI/Encode.pm6"},"source-url":"https://github.com/raku-community-modules/URI-Encode","support":{"bugtracker":"https://github.com/raku-community-modules/URI-Encode/issues","source":"git@github.com:raku-community-modules/URI-Encode.git"},"test-depends":["Test"],"version":"0.09"},"files":[{"file":"work_mods/zef/URI::Encode/dist/README.md","publishUrl":"/mods/zef/URI::Encode/dist/README.md"}],"src":"zef","url":"/mods/zef/URI::Encode"}}}
    =end data
    =end React


URI::Encode


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


URI::FetchFile

URI-FetchFile

image https://github.com/jonathanstowe/URI-FetchFile/workflows/CI/badge.svg not found

Synopsis

Description

Installation

Support

Licence and Copyright

URI::FetchFile v0.0.5

Authors

License

Dependencies

Test Dependencies

Provides

Documentation