TITLE

SUBTITLE

data

=begin data
{"type":"page","file":"work_mods/zef/sortuk/dist/README.md","sources":[],"node":{"type":"block","id":"WdW6_xUWWXjSrG_xsyfZ6","margin":"","name":"root","content":[{"type":"block","id":"AFH7JtZA3FnMCttJsnA2r","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":"Kss2d2B-GXCPH3XFbvb87","margin":"","location":{"start":{"line":3,"column":1,"offset":9},"end":{"line":3,"column":74,"offset":82}},"text":"text","content":["sortuk - is script and library for sorting strings by Ukrainian alphabet."]},{"type":"block","id":"dd_w_o2gdP2vaNGXS9Uy3","margin":"","level":2,"name":"head","location":{"start":{"line":5,"column":1,"offset":84},"end":{"line":5,"column":16,"offset":99}},"content":["INSTALLATION"]},{"type":"block","id":"f-cQfNtk9OSxD9WxvKV0j","margin":"","name":"code","config":[{"name":"lang","value":"sh","type":"string"}],"location":{"start":{"line":7,"column":1,"offset":101},"end":{"line":9,"column":4,"offset":129}},"content":[{"type":"verbatim","value":"zef install sortuk"}]},{"type":"block","id":"vNeyD7ErUqT-SEqgVSWei","margin":"","level":2,"name":"head","location":{"start":{"line":11,"column":1,"offset":131},"end":{"line":11,"column":9,"offset":139}},"content":["USAGE"]},{"type":"block","id":"rZNmHiLiTIpFiwWXs_jHG","margin":"","name":"code","config":[{"name":"lang","value":"sh","type":"string"}],"location":{"start":{"line":13,"column":1,"offset":141},"end":{"line":16,"column":4,"offset":214}},"content":[{"type":"verbatim","value":"bin/sortuk пʼять сім девʼять\nbin/sortuk resources/test_file.txt"}]},{"type":"para","id":"RtFRNKPyZVVGaDS1FPrY9","margin":"","location":{"start":{"line":18,"column":1,"offset":216},"end":{"line":18,"column":15,"offset":230}},"text":"text","content":["or as library:"]},{"type":"block","id":"afgSeEwFlJk2gZAUy_coX","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":20,"column":1,"offset":232},"end":{"line":28,"column":4,"offset":383}},"content":[{"type":"verbatim","value":"use SortUk;\n\nsay sortuk <один два пʼять>;\n# OUTPUT: (два один пʼять)\n\nmy @data = 'resources/test_file.txt'.IO.lines;\n.put for sortuk @data;"}]},{"type":"block","id":"zliA9oog5d8rImAN7HHWG","margin":"","level":2,"name":"head","location":{"start":{"line":30,"column":1,"offset":385},"end":{"line":30,"column":10,"offset":394}},"content":["AUTHOR"]},{"type":"para","id":"oI3ueaR38HdM45mDIGBMY","margin":"","location":{"start":{"line":32,"column":1,"offset":396},"end":{"line":32,"column":13,"offset":408}},"text":"text","content":["Andrij Mizyk"]},{"type":"block","id":"uXMS5jq6H9-DwZWZ4SnYP","margin":"","level":2,"name":"head","location":{"start":{"line":34,"column":1,"offset":410},"end":{"line":34,"column":11,"offset":420}},"content":["LICENSE"]},{"type":"para","id":"TZ9hsOUe_jBYGOSynIhlm","margin":"","location":{"start":{"line":36,"column":1,"offset":422},"end":{"line":36,"column":32,"offset":453}},"text":"text","content":["Copyright (C) 2022 Andrij Mizyk"]},{"type":"para","id":"85xTTLPRE1bT5B1LttrFO","margin":"","location":{"start":{"line":38,"column":1,"offset":455},"end":{"line":41,"column":36,"offset":694}},"text":"text","content":["This library is free software: you can redistribute it and/or modify\nit under the terms of the GNU General Public License as published by\nthe Free Software Foundation, either version 3 of the License, or\n(at your option) any later version."]}]},"publishUrl":"/mods/zef/sortuk/dist/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"","auth":"zef:andmizyk","authors":["Andrij Mizyk <andmizyk@gmail.com>"],"build-depends":[],"depends":null,"description":"sorts strings by Ukrainian alphabet.","dist":"sortuk:ver<0.0.1>:auth<zef:andmizyk>","license":"GPL-3.0-or-later","meta-version":"1","name":"sortuk","path":"S/OR/SORTUK/646c4d55cb99af97a920e9282ca5cfcb62adea8e.tar.gz","perl":"6.d","provides":{"SortUk":"lib/SortUk.rakumod"},"raku":"6.d","resources":[],"source-url":"https://gitlab.com/andmizyk/sortuk.git","support":{"bugtracker":"https://gitlab.com/andmizyk/sortuk/issues","source":"https://gitlab.com/andmizyk/sortuk"},"tags":["sort","ukrainian"],"test-depends":["Test"],"version":"0.0.1"},"files":[{"file":"work_mods/zef/sortuk/dist/README.md","publishUrl":"/mods/zef/sortuk/dist/README.md"}],"src":"zef","url":"/mods/zef/sortuk"}}}
=end data


React

    =begin React :component<RenderItem>
    =begin data
    {"type":"page","file":"work_mods/zef/sortuk/dist/README.md","sources":[],"node":{"type":"block","id":"WdW6_xUWWXjSrG_xsyfZ6","margin":"","name":"root","content":[{"type":"block","id":"AFH7JtZA3FnMCttJsnA2r","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":"Kss2d2B-GXCPH3XFbvb87","margin":"","location":{"start":{"line":3,"column":1,"offset":9},"end":{"line":3,"column":74,"offset":82}},"text":"text","content":["sortuk - is script and library for sorting strings by Ukrainian alphabet."]},{"type":"block","id":"dd_w_o2gdP2vaNGXS9Uy3","margin":"","level":2,"name":"head","location":{"start":{"line":5,"column":1,"offset":84},"end":{"line":5,"column":16,"offset":99}},"content":["INSTALLATION"]},{"type":"block","id":"f-cQfNtk9OSxD9WxvKV0j","margin":"","name":"code","config":[{"name":"lang","value":"sh","type":"string"}],"location":{"start":{"line":7,"column":1,"offset":101},"end":{"line":9,"column":4,"offset":129}},"content":[{"type":"verbatim","value":"zef install sortuk"}]},{"type":"block","id":"vNeyD7ErUqT-SEqgVSWei","margin":"","level":2,"name":"head","location":{"start":{"line":11,"column":1,"offset":131},"end":{"line":11,"column":9,"offset":139}},"content":["USAGE"]},{"type":"block","id":"rZNmHiLiTIpFiwWXs_jHG","margin":"","name":"code","config":[{"name":"lang","value":"sh","type":"string"}],"location":{"start":{"line":13,"column":1,"offset":141},"end":{"line":16,"column":4,"offset":214}},"content":[{"type":"verbatim","value":"bin/sortuk пʼять сім девʼять\nbin/sortuk resources/test_file.txt"}]},{"type":"para","id":"RtFRNKPyZVVGaDS1FPrY9","margin":"","location":{"start":{"line":18,"column":1,"offset":216},"end":{"line":18,"column":15,"offset":230}},"text":"text","content":["or as library:"]},{"type":"block","id":"afgSeEwFlJk2gZAUy_coX","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":20,"column":1,"offset":232},"end":{"line":28,"column":4,"offset":383}},"content":[{"type":"verbatim","value":"use SortUk;\n\nsay sortuk <один два пʼять>;\n# OUTPUT: (два один пʼять)\n\nmy @data = 'resources/test_file.txt'.IO.lines;\n.put for sortuk @data;"}]},{"type":"block","id":"zliA9oog5d8rImAN7HHWG","margin":"","level":2,"name":"head","location":{"start":{"line":30,"column":1,"offset":385},"end":{"line":30,"column":10,"offset":394}},"content":["AUTHOR"]},{"type":"para","id":"oI3ueaR38HdM45mDIGBMY","margin":"","location":{"start":{"line":32,"column":1,"offset":396},"end":{"line":32,"column":13,"offset":408}},"text":"text","content":["Andrij Mizyk"]},{"type":"block","id":"uXMS5jq6H9-DwZWZ4SnYP","margin":"","level":2,"name":"head","location":{"start":{"line":34,"column":1,"offset":410},"end":{"line":34,"column":11,"offset":420}},"content":["LICENSE"]},{"type":"para","id":"TZ9hsOUe_jBYGOSynIhlm","margin":"","location":{"start":{"line":36,"column":1,"offset":422},"end":{"line":36,"column":32,"offset":453}},"text":"text","content":["Copyright (C) 2022 Andrij Mizyk"]},{"type":"para","id":"85xTTLPRE1bT5B1LttrFO","margin":"","location":{"start":{"line":38,"column":1,"offset":455},"end":{"line":41,"column":36,"offset":694}},"text":"text","content":["This library is free software: you can redistribute it and/or modify\nit under the terms of the GNU General Public License as published by\nthe Free Software Foundation, either version 3 of the License, or\n(at your option) any later version."]}]},"publishUrl":"/mods/zef/sortuk/dist/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"","auth":"zef:andmizyk","authors":["Andrij Mizyk <andmizyk@gmail.com>"],"build-depends":[],"depends":null,"description":"sorts strings by Ukrainian alphabet.","dist":"sortuk:ver<0.0.1>:auth<zef:andmizyk>","license":"GPL-3.0-or-later","meta-version":"1","name":"sortuk","path":"S/OR/SORTUK/646c4d55cb99af97a920e9282ca5cfcb62adea8e.tar.gz","perl":"6.d","provides":{"SortUk":"lib/SortUk.rakumod"},"raku":"6.d","resources":[],"source-url":"https://gitlab.com/andmizyk/sortuk.git","support":{"bugtracker":"https://gitlab.com/andmizyk/sortuk/issues","source":"https://gitlab.com/andmizyk/sortuk"},"tags":["sort","ukrainian"],"test-depends":["Test"],"version":"0.0.1"},"files":[{"file":"work_mods/zef/sortuk/dist/README.md","publishUrl":"/mods/zef/sortuk/dist/README.md"}],"src":"zef","url":"/mods/zef/sortuk"}}}
    =end data
    =end React


root

sorts strings by Ukrainian alphabet.


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

sortuk


turn a sub / method call into file(s) / linenumbers(s)


=begin data
{"type":"page","file":"work_mods/zef/sourcery/sourcery-0.0.1/README.md","sources":[],"node":{"type":"block","id":"7hHkyZX4A5TPSK1_lvqor","margin":"","name":"root","content":[{"type":"para","id":"bBqgDMSRUkziZMgfdmUHW","margin":"","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":137,"offset":136}},"text":"text","content":[{"meta":"https://github.com/lizmat/sourcery/actions","type":"fcode","name":"L","content":[{"type":"block","id":"se5N_wu6TqANbnyTgQo15","margin":"","name":"Image","config":[],"location":{"start":{"line":1,"column":2,"offset":1},"end":{"line":1,"column":92,"offset":91}},"content":[{"type":"image","src":"https://github.com/lizmat/sourcery/actions/workflows/test.yml/badge.svg","alt":"Actions Status"}]}]}]},{"type":"block","id":"DUasykJGw15jZEp_-zJO8","margin":"","level":1,"name":"head","location":{"start":{"line":3,"column":1,"offset":138},"end":{"line":4,"column":5,"offset":147}},"content":["NAME"]},{"type":"para","id":"khjUDLX043lPSspAIx0hN","margin":"","location":{"start":{"line":6,"column":1,"offset":149},"end":{"line":6,"column":66,"offset":214}},"text":"text","content":["sourcery - turn a sub / method call into file(s) / linenumbers(s)"]},{"type":"block","id":"m6j0lhfz5xmQooiUixJMk","margin":"","level":1,"name":"head","location":{"start":{"line":8,"column":1,"offset":216},"end":{"line":9,"column":9,"offset":233}},"content":["SYNOPSIS"]},{"type":"block","id":"cTbH9ok-THMxoIbxOWjnc","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":11,"column":1,"offset":235},"end":{"line":23,"column":4,"offset":566}},"content":[{"type":"verbatim","value":"use sourcery;\n\n.say for sourcery '\"42\".Int';   # show where a Str gets converted to Int\n\n.say for sourcery 'say \"foo\"';  # show where strings are being said\n\n.say for sourcery \"Str.Int\", :defined;  # instantiate type object\n\nuse Edit::Files;\n\nedit-files sourcery '42.base(\"beer\")';  # go see where this easter egg lives"}]},{"type":"block","id":"tKYvvyrHj61fs02XJk6ZA","margin":"","level":1,"name":"head","location":{"start":{"line":25,"column":1,"offset":568},"end":{"line":26,"column":12,"offset":591}},"content":["DESCRIPTION"]},{"type":"para","id":"5sWpAdYrSoBpw46jRoE3s","margin":"","location":{"start":{"line":28,"column":1,"offset":593},"end":{"line":28,"column":258,"offset":850}},"text":"text","content":["The sourcery module exports a single subroutine called ",{"type":"fcode","name":"C","content":["sourcery"]},". It converts a piece of code consisting of a subroutine or method call to zero or more file / line-number pairs. Which can then be displayed or used as input to go inspect / edit those files."]},{"type":"para","id":"uemThJNWPJrREfP-WrsPf","margin":"","location":{"start":{"line":30,"column":1,"offset":852},"end":{"line":30,"column":274,"offset":1125}},"text":"text","content":["The ",{"type":"fcode","name":"C","content":["sourcery"]}," subroutine also takes a single named argument: ",{"type":"fcode","name":"C","content":[":defined"]},". If specified, will instantiate any type object used as an invocant, so that it will match ",{"type":"fcode","name":"C","content":["class:D:"]}," constraints in dispatching (see e.g. the difference between ",{"type":"fcode","name":"C","content":["\"Str.Int\""]}," and ",{"type":"fcode","name":"C","content":["\"Str.Int\", :defined"]},"."]},{"type":"para","id":"NWFZ_9aOyWaIjTS0Tj1wm","margin":"","location":{"start":{"line":32,"column":1,"offset":1127},"end":{"line":32,"column":153,"offset":1279}},"text":"text","content":["Inspired by Zoffix's ",{"meta":"https://raku.land/zef:raku-community-modules/CoreHackers::Sourcery","type":"fcode","name":"L","content":["CoreHackers::Sourcery"]}," module, with the following differences:"]},{"type":"list","id":"4mhupZD4z84Lv3BUwK3Qj","margin":"","level":1,"list":"itemized","content":[{"type":"block","id":"5PtxXpd1ZDEK3dqWntOPr","margin":"","name":"item","level":1,"location":{"start":{"line":34,"column":3,"offset":1283},"end":{"line":34,"column":51,"offset":1331}},"content":[{"type":"para","id":"4ycHS-hNfg8d8QOw_xhGl","margin":"","location":{"start":{"line":34,"column":5,"offset":1285},"end":{"line":34,"column":51,"offset":1331}},"text":"text","content":["generates local file locations instead of URLs"]}]},{"type":"block","id":"snFPzxcmQLvwGpdDP3fCw","margin":"","name":"item","level":1,"location":{"start":{"line":36,"column":3,"offset":1335},"end":{"line":36,"column":67,"offset":1399}},"content":[{"type":"para","id":"y3gxXsR-vF3rxirzfHhBn","margin":"","location":{"start":{"line":36,"column":5,"offset":1337},"end":{"line":36,"column":67,"offset":1399}},"text":"text","content":["not limited to core code, could be used on any loaded codebase"]}]}]},{"type":"block","id":"yZXNdKomJFqfYqdxzyTA7","margin":"","level":1,"name":"head","location":{"start":{"line":38,"column":1,"offset":1401},"end":{"line":39,"column":8,"offset":1416}},"content":["CAVEATS"]},{"type":"para","id":"L8K3eqSlOKCBxSsG4WFGp","margin":"","location":{"start":{"line":41,"column":1,"offset":1418},"end":{"line":41,"column":213,"offset":1630}},"text":"text","content":["Modules that have been loaded from an installation, will refer to the location inside the repository where the original source files are being kept. These files are considered immutable and should not be changed."]},{"type":"block","id":"vYYuIYokR4xijhBqu8dfI","margin":"","level":1,"name":"head","location":{"start":{"line":43,"column":1,"offset":1632},"end":{"line":44,"column":7,"offset":1645}},"content":["AUTHOR"]},{"type":"para","id":"cKM_Sm9qDzUEQxjRqQPYi","margin":"","location":{"start":{"line":46,"column":1,"offset":1647},"end":{"line":46,"column":37,"offset":1683}},"text":"text","content":["Elizabeth Mattijsen ",{"meta":"mailto:liz@raku.rocks","type":"fcode","name":"L","content":["liz@raku.rocks"]}]},{"type":"para","id":"as8uvmd86jdHRZwvQXtzt","margin":"","location":{"start":{"line":48,"column":1,"offset":1685},"end":{"line":48,"column":103,"offset":1787}},"text":"text","content":["Source can be located at: ",{"meta":"https://github.com/lizmat/sourcery","type":"fcode","name":"L","content":["https://github.com/lizmat/sourcery"]}," . Comments and Pull Requests are welcome."]},{"type":"para","id":"8Tk03SyoTXxlugLH1S2QN","margin":"","location":{"start":{"line":50,"column":1,"offset":1789},"end":{"line":50,"column":163,"offset":1951}},"text":"text","content":["If you like this module, or what I’m doing more generally, committing to a ",{"meta":"https://github.com/sponsors/lizmat/","type":"fcode","name":"L","content":["small sponsorship"]}," would mean a great deal to me!"]},{"type":"block","id":"cSfhIinz53l9ON5INDtiG","margin":"","level":1,"name":"head","location":{"start":{"line":52,"column":1,"offset":1953},"end":{"line":53,"column":22,"offset":1996}},"content":["COPYRIGHT AND LICENSE"]},{"type":"para","id":"mPWqy6jQ5Od0r1vFCQj19","margin":"","location":{"start":{"line":55,"column":1,"offset":1998},"end":{"line":55,"column":35,"offset":2032}},"text":"text","content":["Copyright 2022 Elizabeth Mattijsen"]},{"type":"para","id":"v7KgI8utia0D7g7fHjDlK","margin":"","location":{"start":{"line":57,"column":1,"offset":2034},"end":{"line":57,"column":104,"offset":2137}},"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/sourcery/sourcery-0.0.1/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"","auth":"zef:lizmat","authors":["Elizabeth Mattijsen"],"build-depends":[],"depends":[],"description":"turn a sub / method call into file(s) / linenumbers(s)","dist":"sourcery:ver<0.0.1>:auth<zef:lizmat>","license":"Artistic-2.0","name":"sourcery","path":"S/OU/SOURCERY/61f16bb97e428d28bf974f5ad837ca72f38df379.tar.gz","perl":"6.d","provides":{"sourcery":"lib/sourcery.rakumod"},"resources":[],"source-url":"https://github.com/lizmat/sourcery.git","tags":[],"test-depends":[],"version":"0.0.1"},"files":[{"file":"work_mods/zef/sourcery/sourcery-0.0.1/README.md","publishUrl":"/mods/zef/sourcery/sourcery-0.0.1/README.md"},{"file":"work_mods/zef/sourcery/sourcery-0.0.1/lib/sourcery.rakumod","publishUrl":"/mods/zef/sourcery/sourcery-0.0.1/lib/sourcery.rakumod"}],"src":"zef","url":"/mods/zef/sourcery"}}}
=end data


    =begin React :component<RenderItem>
    =begin data
    {"type":"page","file":"work_mods/zef/sourcery/sourcery-0.0.1/README.md","sources":[],"node":{"type":"block","id":"7hHkyZX4A5TPSK1_lvqor","margin":"","name":"root","content":[{"type":"para","id":"bBqgDMSRUkziZMgfdmUHW","margin":"","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":137,"offset":136}},"text":"text","content":[{"meta":"https://github.com/lizmat/sourcery/actions","type":"fcode","name":"L","content":[{"type":"block","id":"se5N_wu6TqANbnyTgQo15","margin":"","name":"Image","config":[],"location":{"start":{"line":1,"column":2,"offset":1},"end":{"line":1,"column":92,"offset":91}},"content":[{"type":"image","src":"https://github.com/lizmat/sourcery/actions/workflows/test.yml/badge.svg","alt":"Actions Status"}]}]}]},{"type":"block","id":"DUasykJGw15jZEp_-zJO8","margin":"","level":1,"name":"head","location":{"start":{"line":3,"column":1,"offset":138},"end":{"line":4,"column":5,"offset":147}},"content":["NAME"]},{"type":"para","id":"khjUDLX043lPSspAIx0hN","margin":"","location":{"start":{"line":6,"column":1,"offset":149},"end":{"line":6,"column":66,"offset":214}},"text":"text","content":["sourcery - turn a sub / method call into file(s) / linenumbers(s)"]},{"type":"block","id":"m6j0lhfz5xmQooiUixJMk","margin":"","level":1,"name":"head","location":{"start":{"line":8,"column":1,"offset":216},"end":{"line":9,"column":9,"offset":233}},"content":["SYNOPSIS"]},{"type":"block","id":"cTbH9ok-THMxoIbxOWjnc","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":11,"column":1,"offset":235},"end":{"line":23,"column":4,"offset":566}},"content":[{"type":"verbatim","value":"use sourcery;\n\n.say for sourcery '\"42\".Int';   # show where a Str gets converted to Int\n\n.say for sourcery 'say \"foo\"';  # show where strings are being said\n\n.say for sourcery \"Str.Int\", :defined;  # instantiate type object\n\nuse Edit::Files;\n\nedit-files sourcery '42.base(\"beer\")';  # go see where this easter egg lives"}]},{"type":"block","id":"tKYvvyrHj61fs02XJk6ZA","margin":"","level":1,"name":"head","location":{"start":{"line":25,"column":1,"offset":568},"end":{"line":26,"column":12,"offset":591}},"content":["DESCRIPTION"]},{"type":"para","id":"5sWpAdYrSoBpw46jRoE3s","margin":"","location":{"start":{"line":28,"column":1,"offset":593},"end":{"line":28,"column":258,"offset":850}},"text":"text","content":["The sourcery module exports a single subroutine called ",{"type":"fcode","name":"C","content":["sourcery"]},". It converts a piece of code consisting of a subroutine or method call to zero or more file / line-number pairs. Which can then be displayed or used as input to go inspect / edit those files."]},{"type":"para","id":"uemThJNWPJrREfP-WrsPf","margin":"","location":{"start":{"line":30,"column":1,"offset":852},"end":{"line":30,"column":274,"offset":1125}},"text":"text","content":["The ",{"type":"fcode","name":"C","content":["sourcery"]}," subroutine also takes a single named argument: ",{"type":"fcode","name":"C","content":[":defined"]},". If specified, will instantiate any type object used as an invocant, so that it will match ",{"type":"fcode","name":"C","content":["class:D:"]}," constraints in dispatching (see e.g. the difference between ",{"type":"fcode","name":"C","content":["\"Str.Int\""]}," and ",{"type":"fcode","name":"C","content":["\"Str.Int\", :defined"]},"."]},{"type":"para","id":"NWFZ_9aOyWaIjTS0Tj1wm","margin":"","location":{"start":{"line":32,"column":1,"offset":1127},"end":{"line":32,"column":153,"offset":1279}},"text":"text","content":["Inspired by Zoffix's ",{"meta":"https://raku.land/zef:raku-community-modules/CoreHackers::Sourcery","type":"fcode","name":"L","content":["CoreHackers::Sourcery"]}," module, with the following differences:"]},{"type":"list","id":"4mhupZD4z84Lv3BUwK3Qj","margin":"","level":1,"list":"itemized","content":[{"type":"block","id":"5PtxXpd1ZDEK3dqWntOPr","margin":"","name":"item","level":1,"location":{"start":{"line":34,"column":3,"offset":1283},"end":{"line":34,"column":51,"offset":1331}},"content":[{"type":"para","id":"4ycHS-hNfg8d8QOw_xhGl","margin":"","location":{"start":{"line":34,"column":5,"offset":1285},"end":{"line":34,"column":51,"offset":1331}},"text":"text","content":["generates local file locations instead of URLs"]}]},{"type":"block","id":"snFPzxcmQLvwGpdDP3fCw","margin":"","name":"item","level":1,"location":{"start":{"line":36,"column":3,"offset":1335},"end":{"line":36,"column":67,"offset":1399}},"content":[{"type":"para","id":"y3gxXsR-vF3rxirzfHhBn","margin":"","location":{"start":{"line":36,"column":5,"offset":1337},"end":{"line":36,"column":67,"offset":1399}},"text":"text","content":["not limited to core code, could be used on any loaded codebase"]}]}]},{"type":"block","id":"yZXNdKomJFqfYqdxzyTA7","margin":"","level":1,"name":"head","location":{"start":{"line":38,"column":1,"offset":1401},"end":{"line":39,"column":8,"offset":1416}},"content":["CAVEATS"]},{"type":"para","id":"L8K3eqSlOKCBxSsG4WFGp","margin":"","location":{"start":{"line":41,"column":1,"offset":1418},"end":{"line":41,"column":213,"offset":1630}},"text":"text","content":["Modules that have been loaded from an installation, will refer to the location inside the repository where the original source files are being kept. These files are considered immutable and should not be changed."]},{"type":"block","id":"vYYuIYokR4xijhBqu8dfI","margin":"","level":1,"name":"head","location":{"start":{"line":43,"column":1,"offset":1632},"end":{"line":44,"column":7,"offset":1645}},"content":["AUTHOR"]},{"type":"para","id":"cKM_Sm9qDzUEQxjRqQPYi","margin":"","location":{"start":{"line":46,"column":1,"offset":1647},"end":{"line":46,"column":37,"offset":1683}},"text":"text","content":["Elizabeth Mattijsen ",{"meta":"mailto:liz@raku.rocks","type":"fcode","name":"L","content":["liz@raku.rocks"]}]},{"type":"para","id":"as8uvmd86jdHRZwvQXtzt","margin":"","location":{"start":{"line":48,"column":1,"offset":1685},"end":{"line":48,"column":103,"offset":1787}},"text":"text","content":["Source can be located at: ",{"meta":"https://github.com/lizmat/sourcery","type":"fcode","name":"L","content":["https://github.com/lizmat/sourcery"]}," . Comments and Pull Requests are welcome."]},{"type":"para","id":"8Tk03SyoTXxlugLH1S2QN","margin":"","location":{"start":{"line":50,"column":1,"offset":1789},"end":{"line":50,"column":163,"offset":1951}},"text":"text","content":["If you like this module, or what I’m doing more generally, committing to a ",{"meta":"https://github.com/sponsors/lizmat/","type":"fcode","name":"L","content":["small sponsorship"]}," would mean a great deal to me!"]},{"type":"block","id":"cSfhIinz53l9ON5INDtiG","margin":"","level":1,"name":"head","location":{"start":{"line":52,"column":1,"offset":1953},"end":{"line":53,"column":22,"offset":1996}},"content":["COPYRIGHT AND LICENSE"]},{"type":"para","id":"mPWqy6jQ5Od0r1vFCQj19","margin":"","location":{"start":{"line":55,"column":1,"offset":1998},"end":{"line":55,"column":35,"offset":2032}},"text":"text","content":["Copyright 2022 Elizabeth Mattijsen"]},{"type":"para","id":"v7KgI8utia0D7g7fHjDlK","margin":"","location":{"start":{"line":57,"column":1,"offset":2034},"end":{"line":57,"column":104,"offset":2137}},"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/sourcery/sourcery-0.0.1/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"","auth":"zef:lizmat","authors":["Elizabeth Mattijsen"],"build-depends":[],"depends":[],"description":"turn a sub / method call into file(s) / linenumbers(s)","dist":"sourcery:ver<0.0.1>:auth<zef:lizmat>","license":"Artistic-2.0","name":"sourcery","path":"S/OU/SOURCERY/61f16bb97e428d28bf974f5ad837ca72f38df379.tar.gz","perl":"6.d","provides":{"sourcery":"lib/sourcery.rakumod"},"resources":[],"source-url":"https://github.com/lizmat/sourcery.git","tags":[],"test-depends":[],"version":"0.0.1"},"files":[{"file":"work_mods/zef/sourcery/sourcery-0.0.1/README.md","publishUrl":"/mods/zef/sourcery/sourcery-0.0.1/README.md"},{"file":"work_mods/zef/sourcery/sourcery-0.0.1/lib/sourcery.rakumod","publishUrl":"/mods/zef/sourcery/sourcery-0.0.1/lib/sourcery.rakumod"}],"src":"zef","url":"/mods/zef/sourcery"}}}
    =end data
    =end React


sourcery


Provides several routines to ease natural sorting.


=begin data
{"type":"page","file":"work_mods/zef/Sort::Naturally/Sort-Naturally-0.2.3/README.md","sources":[],"node":{"type":"block","id":"UyZDXdRhj75CVs_HNAAqB","margin":"","name":"root","content":[{"type":"para","id":"LzEA3froPGvGNFSJ8sn2P","margin":"","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":159,"offset":158}},"text":"text","content":[{"meta":"https://github.com/thundergnat/Sort-Naturally/actions","type":"fcode","name":"L","content":[{"type":"block","id":"KJkM9m6YAa7LnTLZKwVtV","margin":"","name":"Image","config":[],"location":{"start":{"line":1,"column":2,"offset":1},"end":{"line":1,"column":103,"offset":102}},"content":[{"type":"image","src":"https://github.com/thundergnat/Sort-Naturally/actions/workflows/test.yml/badge.svg","alt":"Actions Status"}]}]}]},{"type":"block","id":"p0G7UUT6-b1XcQxWE0PmV","margin":"","level":1,"name":"head","location":{"start":{"line":3,"column":1,"offset":160},"end":{"line":4,"column":21,"offset":201}},"content":["NAME Sort::Naturally"]},{"type":"para","id":"heikfeD0DMY9tpI_7QhN0","margin":"","location":{"start":{"line":6,"column":1,"offset":203},"end":{"line":6,"column":71,"offset":273}},"text":"text","content":["Provides a transform routine to modify sorting into a \"natural\" order."]},{"type":"block","id":"mkhG0y2GCimAwlEkZmMpR","margin":"","level":1,"name":"head","location":{"start":{"line":8,"column":1,"offset":275},"end":{"line":9,"column":9,"offset":292}},"content":["SYNOPSIS"]},{"type":"block","id":"5tEYj-eEqRhVvoN_QUmHD","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":11,"column":1,"offset":294},"end":{"line":18,"column":4,"offset":502}},"content":[{"type":"verbatim","value":"use Sort::Naturally;\n\n# sort strings containing a mix of letters and digits sensibly\nmy @a =   <1 11 100 14th 2 210 21 30 3rd d1 Any any d10 D2 D21 d3 aid Are ANY >;\n\nsay @a.sort: { .&naturally };"}]},{"type":"para","id":"jUwh0KFWLYRH6qsX0lGda","margin":"","location":{"start":{"line":20,"column":1,"offset":504},"end":{"line":20,"column":8,"offset":511}},"text":"text","content":["yields:"]},{"type":"block","id":"QFvC1IbLblzXRJU-AyMyl","margin":"","name":"code","config":[],"location":{"start":{"line":22,"column":1,"offset":513},"end":{"line":22,"column":75,"offset":587}},"content":[{"type":"verbatim","value":"1 2 3rd 11 14th 21 30 100 141 210 aid ANY Any any Are d1 D2 d3 d10 D21"}]},{"type":"para","id":"5pw4rmWhc7iNENAhHQZED","margin":"","location":{"start":{"line":24,"column":1,"offset":589},"end":{"line":24,"column":23,"offset":611}},"text":"text","content":["compared to ",{"type":"fcode","name":"C","content":["@a.sort"]},":"]},{"type":"block","id":"DEwIPGIPzoekh1G0o0LKx","margin":"","name":"code","config":[],"location":{"start":{"line":26,"column":1,"offset":613},"end":{"line":26,"column":75,"offset":687}},"content":[{"type":"verbatim","value":"1 100 11 141 14th 2 21 210 30 3rd ANY Any Are D2 D21 aid any d1 d10 d3"}]},{"type":"block","id":"sv4ZDseJeF8ebVsbAwTOO","margin":"","level":1,"name":"head","location":{"start":{"line":28,"column":1,"offset":689},"end":{"line":29,"column":12,"offset":712}},"content":["DESCRIPTION"]},{"type":"para","id":"jM3q1Y1SzmiMVzM7Xlq_i","margin":"","location":{"start":{"line":31,"column":1,"offset":714},"end":{"line":31,"column":543,"offset":1256}},"text":"text","content":["This implementation of a natural sort order transform will yield results similar, though not identical to the Perl 5 Sort::Naturally. When sorting strings that contain groups of digits, it will sort the groups of consecutive digits by \"order of magnitude\", then lexically by lower-cased terms. Order of magnitude is something of a simplification. The transformation routine &naturally doesn't try to interpret or evaluate a group of digits as a number, it just counts how many digits are in each group and uses that as its order of magnitude."]},{"type":"para","id":"uCvEclI2foGjgceM7edV7","margin":"","location":{"start":{"line":33,"column":1,"offset":1258},"end":{"line":33,"column":22,"offset":1279}},"text":"text","content":["The implications are:"]},{"type":"list","id":"irPZTbUxlvvq6po3Bxg6h","margin":"","level":1,"list":"itemized","content":[{"type":"block","id":"eWvGBFXbxEQst7O39MGgm","margin":"","name":"item","level":1,"location":{"start":{"line":35,"column":3,"offset":1283},"end":{"line":35,"column":321,"offset":1601}},"content":[{"type":"para","id":"Qlr7PmUf5cc9O3QfalMrW","margin":"","location":{"start":{"line":35,"column":5,"offset":1285},"end":{"line":35,"column":321,"offset":1601}},"text":"text","content":["It doesn't understand the (non)significance of leading zeros in numbers; 0010, 0100 and 1000 are all treated as being of the same order of magnitude and will all be sorted to be after 20 and 200. This is the correct behavior for strings of digits where leading zeros are significant, like zip codes or phone numbers."]}]},{"type":"block","id":"I8RTT3l8F28U26mZj1YKY","margin":"","name":"item","level":1,"location":{"start":{"line":37,"column":3,"offset":1605},"end":{"line":37,"column":162,"offset":1764}},"content":[{"type":"para","id":"zPsrzwdvnMRVulo0LDR88","margin":"","location":{"start":{"line":37,"column":5,"offset":1607},"end":{"line":37,"column":162,"offset":1764}},"text":"text","content":["It doesn't understand floating point numbers; the groups of digits before and after a decimal point are treated as two separate numbers for sorting purposes."]}]},{"type":"block","id":"CQ1q8lVxFUh9T0NsZTxvp","margin":"","name":"item","level":1,"location":{"start":{"line":39,"column":3,"offset":1768},"end":{"line":39,"column":75,"offset":1840}},"content":[{"type":"para","id":"Att0KnWX3CmUwG4exMV6i","margin":"","location":{"start":{"line":39,"column":5,"offset":1770},"end":{"line":39,"column":75,"offset":1840}},"text":"text","content":["It doesn't understand or deal with scientific or exponential notation."]}]}]},{"type":"para","id":"5UUBj1gz036HuL46mxyIK","margin":"","location":{"start":{"line":41,"column":1,"offset":1842},"end":{"line":41,"column":26,"offset":1867}},"text":"text","content":["However, that also means:"]},{"type":"list","id":"fEbZBlR1T3leVugLn4nzk","margin":"","level":1,"list":"itemized","content":[{"type":"block","id":"CcxpNAr7qZ4PKWeymmNYx","margin":"","name":"item","level":1,"location":{"start":{"line":43,"column":3,"offset":1871},"end":{"line":43,"column":149,"offset":2017}},"content":[{"type":"para","id":"qo_Iq-Ewp_fWeIwN_sCnJ","margin":"","location":{"start":{"line":43,"column":5,"offset":1873},"end":{"line":43,"column":149,"offset":2017}},"text":"text","content":["You are not limited by number magnitude. It will sort arbitrarily large numbers with ease regardless of the math capability of your hardware/OS."]}]},{"type":"block","id":"fmVMPwgNw1CshfFBLAgml","margin":"","name":"item","level":1,"location":{"start":{"line":45,"column":3,"offset":2021},"end":{"line":45,"column":156,"offset":2174}},"content":[{"type":"para","id":"lRZ0NnhpEj2H4Vp2gmnFB","margin":"","location":{"start":{"line":45,"column":5,"offset":2023},"end":{"line":45,"column":156,"offset":2174}},"text":"text","content":["It is quite speedy. (For liberal values of speedy.) Since it doesn't need to interpret numbers by value it eliminates a lot of code that would do that."]}]}]},{"type":"para","id":"f41sZ1GccR-IdNCY9c0fI","margin":"","location":{"start":{"line":47,"column":1,"offset":2176},"end":{"line":47,"column":381,"offset":2556}},"text":"text","content":["It could have been modified to ignore leading zeros, and in fact I experimented with that bit, but ran into issues with strings where leading zeros WERE significant. Just remember, it is for sorting strings, not numbers. It makes some attempt at treating groups of digits in a kind of numbery way, but they are still strings. If you truly want to sort numbers, use a numeric sort."]},{"type":"block","id":"k2X3Ju44QDXlTCm2Q8wwO","margin":"","level":1,"name":"head","location":{"start":{"line":49,"column":1,"offset":2558},"end":{"line":50,"column":6,"offset":2569}},"content":["USAGE"]},{"type":"para","id":"NgGUgXZ8mmbGiMgb9PSVi","margin":"","location":{"start":{"line":52,"column":1,"offset":2571},"end":{"line":52,"column":191,"offset":2761}},"text":"text","content":["Sort::Naturally provides a transformation routine: ",{"type":"fcode","name":"C","content":["&naturally"]},", which you can use as a sorting block modifier. It performs a transform of the terms so they will end up in the natural order."]},{"type":"block","id":"wPnyFr5viqIBGSOhetjZv","margin":"","level":3,"name":"head","location":{"start":{"line":54,"column":1,"offset":2763},"end":{"line":54,"column":44,"offset":2806}},"content":["BACKWARD COMPATIBILITY BREAKING CHANGES"]},{"type":"para","id":"yKsRhl6u7yg0RE1hy6kZZ","margin":"","location":{"start":{"line":56,"column":1,"offset":2808},"end":{"line":56,"column":390,"offset":3197}},"text":"text","content":["Previous versions provided some pre-made augmented methods and infix comparators that are no longer provided. Partially because they were causing compilation failures due to incomplete and not yet implemented compiler features, and partially because I decided it was a bad idea to unnecessarily pollute the name-space. If you would like to have the syntactic sugar, it can be added easily."]},{"type":"para","id":"6G-UCROXeZ1VxyDlgE_zc","margin":"","location":{"start":{"line":58,"column":1,"offset":3199},"end":{"line":58,"column":67,"offset":3265}},"text":"text","content":["To create the method ",{"type":"fcode","name":"C","content":[".nsort"]}," that can be used similar to ",{"type":"fcode","name":"C","content":[".sort"]},":"]},{"type":"block","id":"4ERoZeuhOPj6sq0VoTJP7","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":60,"column":1,"offset":3267},"end":{"line":67,"column":4,"offset":3407}},"content":[{"type":"verbatim","value":"use Sort::Naturally;\n\nuse MONKEY-TYPING;\naugment class Any {\n    method nsort (*@) { self.list.flat.sort( { .&naturally } ) };\n}"}]},{"type":"para","id":"Ik3OIAYMtuTidL2LP9gk9","margin":"","location":{"start":{"line":69,"column":1,"offset":3409},"end":{"line":69,"column":203,"offset":3611}},"text":"text","content":[{"type":"fcode","name":"I","content":["(Note: since this was originally written, augmenting rules have changed in Raku. Now, if you augment a parent class (Any), you must then re-compose any subtypes that you want to see the augmentation.)"]}]},{"type":"para","id":"3tHO-JaM5BtXluB-oghcz","margin":"","location":{"start":{"line":71,"column":1,"offset":3613},"end":{"line":71,"column":40,"offset":3652}},"text":"text","content":["For a natural sorting infix comparator:"]},{"type":"para","id":"fMtMjtHaeF7655LpwpODP","margin":"","location":{"start":{"line":73,"column":1,"offset":3654},"end":{"line":73,"column":63,"offset":3716}},"text":"text","content":[{"type":"fcode","name":"C","content":["sub infix:<ncmp>($a, $b) { $a.&naturally cmp $b.&naturally }"]}]},{"type":"block","id":"qnJuRe-LZEls8F2BMD5zZ","margin":"","level":3,"name":"head","location":{"start":{"line":75,"column":1,"offset":3718},"end":{"line":75,"column":34,"offset":3751}},"content":["PERL 5 BACKWARD COMPATIBILITY"]},{"type":"para","id":"kgdwy7-u02bC4EsJUMxMN","margin":"","location":{"start":{"line":77,"column":1,"offset":3753},"end":{"line":77,"column":417,"offset":4169}},"text":"text","content":["Perl 5 Sort::Naturally has an odd convention in that numbers at the beginning of strings are sorted in ASCII order (digits sort before letters) but numbers embedded inside strings are sorted in non-ASCII order (digits sort after letters). While this is just plain strange in my opinion, some people may rely on or prefer this behavior so Raku ",{"type":"fcode","name":"C","content":["Sort::Naturally"]}," has a \"p5 compatibility mode\" routine. ",{"type":"fcode","name":"C","content":["p5naturally()"]},"."]},{"type":"para","id":"2WtVu2YmlpegMzCIpZKxS","margin":"","location":{"start":{"line":79,"column":1,"offset":4171},"end":{"line":79,"column":16,"offset":4186}},"text":"text","content":["for comparison:"]},{"type":"block","id":"QrD4izTzuGaqKDMAPg8cm","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":81,"column":1,"offset":4188},"end":{"line":88,"column":4,"offset":4556}},"content":[{"type":"verbatim","value":"('       sort:',<foo12z foo foo13a fooa Foolio Foo12a foolio foo12 foo12a 9x 14>\\\n   .sort).join(' ').say;\n('  naturally:',<foo12z foo foo13a fooa Foolio Foo12a foolio foo12 foo12a 9x 14>\\\n   .sort({ .&naturally })).join(' ').say;\n('p5naturally:',<foo12z foo foo13a fooa Foolio Foo12a foolio foo12 foo12a 9x 14>\\\n   .sort({ .&p5naturally })).join(' ').say;"}]},{"type":"para","id":"pU3ye21XSaYp_cJIbd-oo","margin":"","location":{"start":{"line":90,"column":1,"offset":4558},"end":{"line":90,"column":8,"offset":4565}},"text":"text","content":["yields:"]},{"type":"block","id":"nii9PZjp5niGRO3YpHDGm","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":92,"column":1,"offset":4567},"end":{"line":96,"column":4,"offset":4806}},"content":[{"type":"verbatim","value":"       sort: 14 9x Foo12a Foolio foo foo12 foo12a foo12z foo13a fooa foolio\n  naturally: 9x 14 foo foo12 Foo12a foo12a foo12z foo13a fooa Foolio foolio\np5naturally: 9x 14 foo fooa Foolio foolio foo12 Foo12a foo12a foo12z foo13a"}]},{"type":"block","id":"IJYnV-tEDvAo0S6LCQBdn","margin":"","level":1,"name":"head","location":{"start":{"line":98,"column":1,"offset":4808},"end":{"line":99,"column":5,"offset":4817}},"content":["BUGS"]},{"type":"para","id":"TPcs2nMrm1jsCKSRNtvL3","margin":"","location":{"start":{"line":101,"column":1,"offset":4819},"end":{"line":101,"column":451,"offset":5269}},"text":"text","content":["Tests and the p5 routine will fail under locales that specify lower case letters to sort before upper case. (EBCDIC locales notably). They will still sort ",{"type":"fcode","name":"I","content":["consistently"]},", just not in the order advertised. I can probably implement some kind of run time check to modify the behavior based on current locale. I'll look into it more seriously later if necessary. Right now, there are no Raku compilers for any EBCDIC OSs so it is not really an issue yet."]},{"type":"block","id":"-EZ5QC9wFqomofsEP99Sj","margin":"","level":1,"name":"head","location":{"start":{"line":103,"column":1,"offset":5271},"end":{"line":104,"column":7,"offset":5284}},"content":["AUTHOR"]},{"type":"para","id":"9ouBmWli1KeJTdQnJGP8Z","margin":"","location":{"start":{"line":106,"column":1,"offset":5286},"end":{"line":106,"column":44,"offset":5329}},"text":"text","content":["Stephen Schulze (also known as thundergnat)"]},{"type":"block","id":"xglxzol6DCV87-z22MOjR","margin":"","level":1,"name":"head","location":{"start":{"line":108,"column":1,"offset":5331},"end":{"line":109,"column":8,"offset":5346}},"content":["LICENSE"]},{"type":"para","id":"k0nRm6Ul6HNuEvXJWSIyK","margin":"","location":{"start":{"line":111,"column":1,"offset":5348},"end":{"line":111,"column":46,"offset":5393}},"text":"text","content":["Licensed under The Artistic 2.0; see LICENSE."]}]},"publishUrl":"/mods/zef/Sort::Naturally/Sort-Naturally-0.2.3/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"","auth":"zef:thundergnat","authors":["Steve Schulze (thundergnat)"],"build-depends":[],"depends":[],"description":"Provides several routines to ease natural sorting.","dist":"Sort::Naturally:ver<0.2.3>:auth<zef:thundergnat>","license":"Artistic-2.0","name":"Sort::Naturally","path":"S/OR/SORT_NATURALLY/c8d89590d898de322c376277930f3eb2f51e6650.tar.gz","perl":"6.*","provides":{"Sort::Naturally":"lib/Sort/Naturally.pm6"},"resources":[],"source-url":"git://github.com/thundergnat/Sort-Naturally.git","tags":["Sort","Comparitor","Number String","Order"],"test-depends":[],"version":"0.2.3"},"files":[{"file":"work_mods/zef/Sort::Naturally/Sort-Naturally-0.2.3/README.md","publishUrl":"/mods/zef/Sort::Naturally/Sort-Naturally-0.2.3/README.md"},{"file":"work_mods/zef/Sort::Naturally/Sort-Naturally-0.2.3/lib/Sort/Naturally.pm6","publishUrl":"/mods/zef/Sort::Naturally/Sort-Naturally-0.2.3/lib/Sort/Naturally.pm6"}],"src":"zef","url":"/mods/zef/Sort::Naturally"}}}
=end data


    =begin React :component<RenderItem>
    =begin data
    {"type":"page","file":"work_mods/zef/Sort::Naturally/Sort-Naturally-0.2.3/README.md","sources":[],"node":{"type":"block","id":"UyZDXdRhj75CVs_HNAAqB","margin":"","name":"root","content":[{"type":"para","id":"LzEA3froPGvGNFSJ8sn2P","margin":"","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":159,"offset":158}},"text":"text","content":[{"meta":"https://github.com/thundergnat/Sort-Naturally/actions","type":"fcode","name":"L","content":[{"type":"block","id":"KJkM9m6YAa7LnTLZKwVtV","margin":"","name":"Image","config":[],"location":{"start":{"line":1,"column":2,"offset":1},"end":{"line":1,"column":103,"offset":102}},"content":[{"type":"image","src":"https://github.com/thundergnat/Sort-Naturally/actions/workflows/test.yml/badge.svg","alt":"Actions Status"}]}]}]},{"type":"block","id":"p0G7UUT6-b1XcQxWE0PmV","margin":"","level":1,"name":"head","location":{"start":{"line":3,"column":1,"offset":160},"end":{"line":4,"column":21,"offset":201}},"content":["NAME Sort::Naturally"]},{"type":"para","id":"heikfeD0DMY9tpI_7QhN0","margin":"","location":{"start":{"line":6,"column":1,"offset":203},"end":{"line":6,"column":71,"offset":273}},"text":"text","content":["Provides a transform routine to modify sorting into a \"natural\" order."]},{"type":"block","id":"mkhG0y2GCimAwlEkZmMpR","margin":"","level":1,"name":"head","location":{"start":{"line":8,"column":1,"offset":275},"end":{"line":9,"column":9,"offset":292}},"content":["SYNOPSIS"]},{"type":"block","id":"5tEYj-eEqRhVvoN_QUmHD","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":11,"column":1,"offset":294},"end":{"line":18,"column":4,"offset":502}},"content":[{"type":"verbatim","value":"use Sort::Naturally;\n\n# sort strings containing a mix of letters and digits sensibly\nmy @a =   <1 11 100 14th 2 210 21 30 3rd d1 Any any d10 D2 D21 d3 aid Are ANY >;\n\nsay @a.sort: { .&naturally };"}]},{"type":"para","id":"jUwh0KFWLYRH6qsX0lGda","margin":"","location":{"start":{"line":20,"column":1,"offset":504},"end":{"line":20,"column":8,"offset":511}},"text":"text","content":["yields:"]},{"type":"block","id":"QFvC1IbLblzXRJU-AyMyl","margin":"","name":"code","config":[],"location":{"start":{"line":22,"column":1,"offset":513},"end":{"line":22,"column":75,"offset":587}},"content":[{"type":"verbatim","value":"1 2 3rd 11 14th 21 30 100 141 210 aid ANY Any any Are d1 D2 d3 d10 D21"}]},{"type":"para","id":"5pw4rmWhc7iNENAhHQZED","margin":"","location":{"start":{"line":24,"column":1,"offset":589},"end":{"line":24,"column":23,"offset":611}},"text":"text","content":["compared to ",{"type":"fcode","name":"C","content":["@a.sort"]},":"]},{"type":"block","id":"DEwIPGIPzoekh1G0o0LKx","margin":"","name":"code","config":[],"location":{"start":{"line":26,"column":1,"offset":613},"end":{"line":26,"column":75,"offset":687}},"content":[{"type":"verbatim","value":"1 100 11 141 14th 2 21 210 30 3rd ANY Any Are D2 D21 aid any d1 d10 d3"}]},{"type":"block","id":"sv4ZDseJeF8ebVsbAwTOO","margin":"","level":1,"name":"head","location":{"start":{"line":28,"column":1,"offset":689},"end":{"line":29,"column":12,"offset":712}},"content":["DESCRIPTION"]},{"type":"para","id":"jM3q1Y1SzmiMVzM7Xlq_i","margin":"","location":{"start":{"line":31,"column":1,"offset":714},"end":{"line":31,"column":543,"offset":1256}},"text":"text","content":["This implementation of a natural sort order transform will yield results similar, though not identical to the Perl 5 Sort::Naturally. When sorting strings that contain groups of digits, it will sort the groups of consecutive digits by \"order of magnitude\", then lexically by lower-cased terms. Order of magnitude is something of a simplification. The transformation routine &naturally doesn't try to interpret or evaluate a group of digits as a number, it just counts how many digits are in each group and uses that as its order of magnitude."]},{"type":"para","id":"uCvEclI2foGjgceM7edV7","margin":"","location":{"start":{"line":33,"column":1,"offset":1258},"end":{"line":33,"column":22,"offset":1279}},"text":"text","content":["The implications are:"]},{"type":"list","id":"irPZTbUxlvvq6po3Bxg6h","margin":"","level":1,"list":"itemized","content":[{"type":"block","id":"eWvGBFXbxEQst7O39MGgm","margin":"","name":"item","level":1,"location":{"start":{"line":35,"column":3,"offset":1283},"end":{"line":35,"column":321,"offset":1601}},"content":[{"type":"para","id":"Qlr7PmUf5cc9O3QfalMrW","margin":"","location":{"start":{"line":35,"column":5,"offset":1285},"end":{"line":35,"column":321,"offset":1601}},"text":"text","content":["It doesn't understand the (non)significance of leading zeros in numbers; 0010, 0100 and 1000 are all treated as being of the same order of magnitude and will all be sorted to be after 20 and 200. This is the correct behavior for strings of digits where leading zeros are significant, like zip codes or phone numbers."]}]},{"type":"block","id":"I8RTT3l8F28U26mZj1YKY","margin":"","name":"item","level":1,"location":{"start":{"line":37,"column":3,"offset":1605},"end":{"line":37,"column":162,"offset":1764}},"content":[{"type":"para","id":"zPsrzwdvnMRVulo0LDR88","margin":"","location":{"start":{"line":37,"column":5,"offset":1607},"end":{"line":37,"column":162,"offset":1764}},"text":"text","content":["It doesn't understand floating point numbers; the groups of digits before and after a decimal point are treated as two separate numbers for sorting purposes."]}]},{"type":"block","id":"CQ1q8lVxFUh9T0NsZTxvp","margin":"","name":"item","level":1,"location":{"start":{"line":39,"column":3,"offset":1768},"end":{"line":39,"column":75,"offset":1840}},"content":[{"type":"para","id":"Att0KnWX3CmUwG4exMV6i","margin":"","location":{"start":{"line":39,"column":5,"offset":1770},"end":{"line":39,"column":75,"offset":1840}},"text":"text","content":["It doesn't understand or deal with scientific or exponential notation."]}]}]},{"type":"para","id":"5UUBj1gz036HuL46mxyIK","margin":"","location":{"start":{"line":41,"column":1,"offset":1842},"end":{"line":41,"column":26,"offset":1867}},"text":"text","content":["However, that also means:"]},{"type":"list","id":"fEbZBlR1T3leVugLn4nzk","margin":"","level":1,"list":"itemized","content":[{"type":"block","id":"CcxpNAr7qZ4PKWeymmNYx","margin":"","name":"item","level":1,"location":{"start":{"line":43,"column":3,"offset":1871},"end":{"line":43,"column":149,"offset":2017}},"content":[{"type":"para","id":"qo_Iq-Ewp_fWeIwN_sCnJ","margin":"","location":{"start":{"line":43,"column":5,"offset":1873},"end":{"line":43,"column":149,"offset":2017}},"text":"text","content":["You are not limited by number magnitude. It will sort arbitrarily large numbers with ease regardless of the math capability of your hardware/OS."]}]},{"type":"block","id":"fmVMPwgNw1CshfFBLAgml","margin":"","name":"item","level":1,"location":{"start":{"line":45,"column":3,"offset":2021},"end":{"line":45,"column":156,"offset":2174}},"content":[{"type":"para","id":"lRZ0NnhpEj2H4Vp2gmnFB","margin":"","location":{"start":{"line":45,"column":5,"offset":2023},"end":{"line":45,"column":156,"offset":2174}},"text":"text","content":["It is quite speedy. (For liberal values of speedy.) Since it doesn't need to interpret numbers by value it eliminates a lot of code that would do that."]}]}]},{"type":"para","id":"f41sZ1GccR-IdNCY9c0fI","margin":"","location":{"start":{"line":47,"column":1,"offset":2176},"end":{"line":47,"column":381,"offset":2556}},"text":"text","content":["It could have been modified to ignore leading zeros, and in fact I experimented with that bit, but ran into issues with strings where leading zeros WERE significant. Just remember, it is for sorting strings, not numbers. It makes some attempt at treating groups of digits in a kind of numbery way, but they are still strings. If you truly want to sort numbers, use a numeric sort."]},{"type":"block","id":"k2X3Ju44QDXlTCm2Q8wwO","margin":"","level":1,"name":"head","location":{"start":{"line":49,"column":1,"offset":2558},"end":{"line":50,"column":6,"offset":2569}},"content":["USAGE"]},{"type":"para","id":"NgGUgXZ8mmbGiMgb9PSVi","margin":"","location":{"start":{"line":52,"column":1,"offset":2571},"end":{"line":52,"column":191,"offset":2761}},"text":"text","content":["Sort::Naturally provides a transformation routine: ",{"type":"fcode","name":"C","content":["&naturally"]},", which you can use as a sorting block modifier. It performs a transform of the terms so they will end up in the natural order."]},{"type":"block","id":"wPnyFr5viqIBGSOhetjZv","margin":"","level":3,"name":"head","location":{"start":{"line":54,"column":1,"offset":2763},"end":{"line":54,"column":44,"offset":2806}},"content":["BACKWARD COMPATIBILITY BREAKING CHANGES"]},{"type":"para","id":"yKsRhl6u7yg0RE1hy6kZZ","margin":"","location":{"start":{"line":56,"column":1,"offset":2808},"end":{"line":56,"column":390,"offset":3197}},"text":"text","content":["Previous versions provided some pre-made augmented methods and infix comparators that are no longer provided. Partially because they were causing compilation failures due to incomplete and not yet implemented compiler features, and partially because I decided it was a bad idea to unnecessarily pollute the name-space. If you would like to have the syntactic sugar, it can be added easily."]},{"type":"para","id":"6G-UCROXeZ1VxyDlgE_zc","margin":"","location":{"start":{"line":58,"column":1,"offset":3199},"end":{"line":58,"column":67,"offset":3265}},"text":"text","content":["To create the method ",{"type":"fcode","name":"C","content":[".nsort"]}," that can be used similar to ",{"type":"fcode","name":"C","content":[".sort"]},":"]},{"type":"block","id":"4ERoZeuhOPj6sq0VoTJP7","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":60,"column":1,"offset":3267},"end":{"line":67,"column":4,"offset":3407}},"content":[{"type":"verbatim","value":"use Sort::Naturally;\n\nuse MONKEY-TYPING;\naugment class Any {\n    method nsort (*@) { self.list.flat.sort( { .&naturally } ) };\n}"}]},{"type":"para","id":"Ik3OIAYMtuTidL2LP9gk9","margin":"","location":{"start":{"line":69,"column":1,"offset":3409},"end":{"line":69,"column":203,"offset":3611}},"text":"text","content":[{"type":"fcode","name":"I","content":["(Note: since this was originally written, augmenting rules have changed in Raku. Now, if you augment a parent class (Any), you must then re-compose any subtypes that you want to see the augmentation.)"]}]},{"type":"para","id":"3tHO-JaM5BtXluB-oghcz","margin":"","location":{"start":{"line":71,"column":1,"offset":3613},"end":{"line":71,"column":40,"offset":3652}},"text":"text","content":["For a natural sorting infix comparator:"]},{"type":"para","id":"fMtMjtHaeF7655LpwpODP","margin":"","location":{"start":{"line":73,"column":1,"offset":3654},"end":{"line":73,"column":63,"offset":3716}},"text":"text","content":[{"type":"fcode","name":"C","content":["sub infix:<ncmp>($a, $b) { $a.&naturally cmp $b.&naturally }"]}]},{"type":"block","id":"qnJuRe-LZEls8F2BMD5zZ","margin":"","level":3,"name":"head","location":{"start":{"line":75,"column":1,"offset":3718},"end":{"line":75,"column":34,"offset":3751}},"content":["PERL 5 BACKWARD COMPATIBILITY"]},{"type":"para","id":"kgdwy7-u02bC4EsJUMxMN","margin":"","location":{"start":{"line":77,"column":1,"offset":3753},"end":{"line":77,"column":417,"offset":4169}},"text":"text","content":["Perl 5 Sort::Naturally has an odd convention in that numbers at the beginning of strings are sorted in ASCII order (digits sort before letters) but numbers embedded inside strings are sorted in non-ASCII order (digits sort after letters). While this is just plain strange in my opinion, some people may rely on or prefer this behavior so Raku ",{"type":"fcode","name":"C","content":["Sort::Naturally"]}," has a \"p5 compatibility mode\" routine. ",{"type":"fcode","name":"C","content":["p5naturally()"]},"."]},{"type":"para","id":"2WtVu2YmlpegMzCIpZKxS","margin":"","location":{"start":{"line":79,"column":1,"offset":4171},"end":{"line":79,"column":16,"offset":4186}},"text":"text","content":["for comparison:"]},{"type":"block","id":"QrD4izTzuGaqKDMAPg8cm","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":81,"column":1,"offset":4188},"end":{"line":88,"column":4,"offset":4556}},"content":[{"type":"verbatim","value":"('       sort:',<foo12z foo foo13a fooa Foolio Foo12a foolio foo12 foo12a 9x 14>\\\n   .sort).join(' ').say;\n('  naturally:',<foo12z foo foo13a fooa Foolio Foo12a foolio foo12 foo12a 9x 14>\\\n   .sort({ .&naturally })).join(' ').say;\n('p5naturally:',<foo12z foo foo13a fooa Foolio Foo12a foolio foo12 foo12a 9x 14>\\\n   .sort({ .&p5naturally })).join(' ').say;"}]},{"type":"para","id":"pU3ye21XSaYp_cJIbd-oo","margin":"","location":{"start":{"line":90,"column":1,"offset":4558},"end":{"line":90,"column":8,"offset":4565}},"text":"text","content":["yields:"]},{"type":"block","id":"nii9PZjp5niGRO3YpHDGm","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":92,"column":1,"offset":4567},"end":{"line":96,"column":4,"offset":4806}},"content":[{"type":"verbatim","value":"       sort: 14 9x Foo12a Foolio foo foo12 foo12a foo12z foo13a fooa foolio\n  naturally: 9x 14 foo foo12 Foo12a foo12a foo12z foo13a fooa Foolio foolio\np5naturally: 9x 14 foo fooa Foolio foolio foo12 Foo12a foo12a foo12z foo13a"}]},{"type":"block","id":"IJYnV-tEDvAo0S6LCQBdn","margin":"","level":1,"name":"head","location":{"start":{"line":98,"column":1,"offset":4808},"end":{"line":99,"column":5,"offset":4817}},"content":["BUGS"]},{"type":"para","id":"TPcs2nMrm1jsCKSRNtvL3","margin":"","location":{"start":{"line":101,"column":1,"offset":4819},"end":{"line":101,"column":451,"offset":5269}},"text":"text","content":["Tests and the p5 routine will fail under locales that specify lower case letters to sort before upper case. (EBCDIC locales notably). They will still sort ",{"type":"fcode","name":"I","content":["consistently"]},", just not in the order advertised. I can probably implement some kind of run time check to modify the behavior based on current locale. I'll look into it more seriously later if necessary. Right now, there are no Raku compilers for any EBCDIC OSs so it is not really an issue yet."]},{"type":"block","id":"-EZ5QC9wFqomofsEP99Sj","margin":"","level":1,"name":"head","location":{"start":{"line":103,"column":1,"offset":5271},"end":{"line":104,"column":7,"offset":5284}},"content":["AUTHOR"]},{"type":"para","id":"9ouBmWli1KeJTdQnJGP8Z","margin":"","location":{"start":{"line":106,"column":1,"offset":5286},"end":{"line":106,"column":44,"offset":5329}},"text":"text","content":["Stephen Schulze (also known as thundergnat)"]},{"type":"block","id":"xglxzol6DCV87-z22MOjR","margin":"","level":1,"name":"head","location":{"start":{"line":108,"column":1,"offset":5331},"end":{"line":109,"column":8,"offset":5346}},"content":["LICENSE"]},{"type":"para","id":"k0nRm6Ul6HNuEvXJWSIyK","margin":"","location":{"start":{"line":111,"column":1,"offset":5348},"end":{"line":111,"column":46,"offset":5393}},"text":"text","content":["Licensed under The Artistic 2.0; see LICENSE."]}]},"publishUrl":"/mods/zef/Sort::Naturally/Sort-Naturally-0.2.3/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"","auth":"zef:thundergnat","authors":["Steve Schulze (thundergnat)"],"build-depends":[],"depends":[],"description":"Provides several routines to ease natural sorting.","dist":"Sort::Naturally:ver<0.2.3>:auth<zef:thundergnat>","license":"Artistic-2.0","name":"Sort::Naturally","path":"S/OR/SORT_NATURALLY/c8d89590d898de322c376277930f3eb2f51e6650.tar.gz","perl":"6.*","provides":{"Sort::Naturally":"lib/Sort/Naturally.pm6"},"resources":[],"source-url":"git://github.com/thundergnat/Sort-Naturally.git","tags":["Sort","Comparitor","Number String","Order"],"test-depends":[],"version":"0.2.3"},"files":[{"file":"work_mods/zef/Sort::Naturally/Sort-Naturally-0.2.3/README.md","publishUrl":"/mods/zef/Sort::Naturally/Sort-Naturally-0.2.3/README.md"},{"file":"work_mods/zef/Sort::Naturally/Sort-Naturally-0.2.3/lib/Sort/Naturally.pm6","publishUrl":"/mods/zef/Sort::Naturally/Sort-Naturally-0.2.3/lib/Sort/Naturally.pm6"}],"src":"zef","url":"/mods/zef/Sort::Naturally"}}}
    =end data
    =end React


Sort::Naturally


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


sortuk

NAME

INSTALLATION

USAGE

AUTHOR

LICENSE

sortuk v0.0.1

Authors

License

Dependencies

Test Dependencies

Provides

Documentation