TITLE

Raku interface to GNU Readline, the CLI-based line reading library


SUBTITLE

data

=begin data
{"type":"page","file":"work_mods/zef/Readline/dist/README.md","sources":[],"node":{"type":"block","id":"9gQbxr7ErAUcD770wnl4T","margin":"","name":"root","content":[{"type":"block","id":"tRaGsb6c-sr0onh9q_QT5","margin":"","level":1,"name":"head","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":2,"column":8,"offset":16}},"content":["Readline"]},{"type":"block","id":"Ny1JrZRuV3ikyzVNiQ4fa","margin":"","level":5,"name":"head","location":{"start":{"line":4,"column":1,"offset":18},"end":{"line":4,"column":83,"offset":100}},"content":[{"type":"fcode","name":"I","content":["Note: This README will soon be updated based on new development priorities"]}]},{"type":"para","id":"wsVADfSzAGgI3gRdRGN0x","margin":"","location":{"start":{"line":6,"column":1,"offset":102},"end":{"line":6,"column":53,"offset":154}},"text":"text","content":["Readline provides a Perl 6 interface to libreadline."]},{"type":"para","id":"aGvloC7B3eRrJrys7kPuS","margin":"","location":{"start":{"line":8,"column":1,"offset":156},"end":{"line":9,"column":66,"offset":301}},"text":"text","content":["XXX This will probably be a frontend to Readline::Gnu when that's factored out.\nXXX For the moment keep all the code here in the Readline module."]},{"type":"block","id":"a5h_ZWMU6j2APLJIsHqz4","margin":"","level":1,"name":"head","location":{"start":{"line":11,"column":1,"offset":303},"end":{"line":12,"column":13,"offset":328}},"content":["Installation"]},{"type":"para","id":"JVE2OQM9b05rA-pGZ0IPF","margin":"","location":{"start":{"line":14,"column":1,"offset":330},"end":{"line":14,"column":398,"offset":727}},"text":"text","content":["Please make sure that libreadline is installed beforehand, the tests will fail otherwise. If libreadline is installed but the tests still fail, please note that the Perl 6 package searches a given set of directories for libreadline.{so,dynlib}.* files, otherwise it defaults to v7. If your libreadline installation isn't on any of these paths, or requires non-standard setup, please file an issue."]},{"type":"para","id":"Y27MvYgzKfB3HFHqeI3xu","margin":"","location":{"start":{"line":16,"column":1,"offset":729},"end":{"line":16,"column":129,"offset":857}},"text":"text","content":["For those of you on Linux Debian and Linux-alike systems, you should be able to get the latest version with this CLI invocation:"]},{"type":"block","id":"zKHZu_Q2fD0p-41pOWLDv","margin":"","name":"code","config":[],"location":{"start":{"line":18,"column":1,"offset":859},"end":{"line":20,"column":4,"offset":901}},"content":[{"type":"verbatim","value":"\tsudo apt-get install libreadline7"}]},{"type":"para","id":"lrwrdc6nn12iG-BiHaL_8","margin":"","location":{"start":{"line":21,"column":1,"offset":902},"end":{"line":21,"column":85,"offset":986}},"text":"text","content":["(I'd prefer to use LibraryCheck, but it fails inside the 'is native()' method call.)"]},{"type":"para","id":"GMR6TRQ6IPrSq0eH3hHYd","margin":"","location":{"start":{"line":24,"column":1,"offset":989},"end":{"line":24,"column":127,"offset":1115}},"text":"text","content":["On Macs, use Hombrew to install readline. If you installed Rakudo-Star with homebrew after Sept. 1 it should already be there."]},{"type":"para","id":"GkW_w05b9K7N68jknQa66","margin":"","location":{"start":{"line":26,"column":1,"offset":1117},"end":{"line":26,"column":37,"offset":1153}},"text":"text","content":["If not you can install just Readline"]},{"type":"block","id":"cL-ydg1jhFFy-loUrFcr_","margin":"","name":"code","config":[],"location":{"start":{"line":28,"column":1,"offset":1155},"end":{"line":30,"column":4,"offset":1188}},"content":[{"type":"verbatim","value":"    brew install readline"}]},{"type":"para","id":"H6djj6QDDpvgOZ7xB0U9U","margin":"","location":{"start":{"line":32,"column":1,"offset":1190},"end":{"line":32,"column":36,"offset":1225}},"text":"text","content":["or update your rakudo-star install."]},{"type":"block","id":"O9xVcgIiKDRbRKpI_-HN0","margin":"","name":"code","config":[],"location":{"start":{"line":34,"column":1,"offset":1227},"end":{"line":36,"column":4,"offset":1263}},"content":[{"type":"verbatim","value":"    brew upgrade rakudo-star"}]},{"type":"list","id":"_NL2DvEMG-zCFmAPdriXE","margin":"","level":1,"list":"itemized","content":[{"type":"block","id":"i0QJ1cIyNJkFHDXjSc03o","margin":"","name":"item","level":1,"location":{"start":{"line":40,"column":1,"offset":1267},"end":{"line":40,"column":65,"offset":1331}},"content":[{"type":"para","id":"Vm_MPKPOEgloIaiSC__nk","margin":"","location":{"start":{"line":40,"column":3,"offset":1269},"end":{"line":40,"column":65,"offset":1331}},"text":"text","content":["Using zef (a module management tool bundled with Rakudo Star):"]}]}]},{"type":"block","id":"_p_uQ-frNoGm2Qp3tq25E","margin":"","name":"code","config":[],"location":{"start":{"line":44,"column":1,"offset":1335},"end":{"line":46,"column":4,"offset":1381}},"content":[{"type":"verbatim","value":"    zef update && zef install Readline"}]},{"type":"para","id":"oDP9H4l6gzXHpUummyHuZ","margin":"","location":{"start":{"line":49,"column":1,"offset":1384},"end":{"line":49,"column":70,"offset":1453}},"text":"text","content":["Or alternatively installing it from a checkout of this repo with zef:"]},{"type":"block","id":"EERloc_9hfFkHmrAl2ats","margin":"","name":"code","config":[],"location":{"start":{"line":51,"column":1,"offset":1455},"end":{"line":53,"column":4,"offset":1480}},"content":[{"type":"verbatim","value":"    zef install ."}]},{"type":"block","id":"ghpjTOUJ4iJFWbF1KrPZI","margin":"","level":2,"name":"head","location":{"start":{"line":57,"column":1,"offset":1484},"end":{"line":57,"column":9,"offset":1492}},"content":["Usage"]},{"type":"para","id":"yMBcEKIgE6e3x73-Ftr1R","margin":"","location":{"start":{"line":59,"column":1,"offset":1494},"end":{"line":59,"column":47,"offset":1540}},"text":"text","content":["See the ",{"type":"fcode","name":"C","content":["examples/"]}," directory in this project."]},{"type":"block","id":"kZ4BXR4sg40YxEkrV78O7","margin":"","level":2,"name":"head","location":{"start":{"line":61,"column":1,"offset":1542},"end":{"line":61,"column":11,"offset":1552}},"content":["Testing"]},{"type":"para","id":"FOSixwDU1XPSN_JlgPrNJ","margin":"","location":{"start":{"line":63,"column":1,"offset":1554},"end":{"line":63,"column":14,"offset":1567}},"text":"text","content":["To run tests:"]},{"type":"block","id":"jFqvx8Z1MLjzBgyizI_GP","margin":"","name":"code","config":[],"location":{"start":{"line":65,"column":1,"offset":1569},"end":{"line":67,"column":4,"offset":1595}},"content":[{"type":"verbatim","value":"    prove -e perl6"}]},{"type":"block","id":"7cRvU86_KJsCWKyDDHzMX","margin":"","level":2,"name":"head","location":{"start":{"line":69,"column":1,"offset":1597},"end":{"line":69,"column":10,"offset":1606}},"content":["Author"]},{"type":"para","id":"YA-lB3RP0RQu9qX2oHFTB","margin":"","location":{"start":{"line":71,"column":1,"offset":1608},"end":{"line":72,"column":76,"offset":1742}},"text":"text","content":["Jeffrey Goff, DrForr on #perl6, ",{"meta":"https://github.com/drforr/","type":"fcode","name":"L","content":["https://github.com/drforr/"]},"\n(Recently taken over by Daniel Lathrop (fooist), ",{"meta":"https://github.com/fooist/","type":"fcode","name":"L","content":["https://github.com/fooist/"]}]},{"type":"block","id":"_HlOoRzeoYKueq-ngVarq","margin":"","level":2,"name":"head","location":{"start":{"line":74,"column":1,"offset":1744},"end":{"line":74,"column":11,"offset":1754}},"content":["License"]},{"type":"para","id":"plhgQUEZmqJC6sW5KZlf0","margin":"","location":{"start":{"line":76,"column":1,"offset":1756},"end":{"line":76,"column":21,"offset":1776}},"text":"text","content":["Artistic License 2.0"]}]},"publishUrl":"/mods/zef/Readline/dist/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"","auth":"zef:clarkema","authors":["Jeffrey Goff <drforr@pobox.com>","Daniel Lathrop <dwl@foo.ist>","Mike Clarke <clarkema@clarkema.org>"],"build-depends":["LibraryCheck"],"depends":[],"description":"Raku interface to GNU Readline, the CLI-based line reading library","dist":"Readline:ver<0.1.7>:auth<zef:clarkema>","license":"Artistic-2.0","meta6":"0","name":"Readline","path":"R/EA/READLINE/6bf81b82026641a849aa03175e5690da54e9e58e.tar.gz","perl":"6.c","provides":{"Readline":"lib/Readline.pm"},"resources":[],"source-url":"https://github.com/clarkema/raku-readline.git","support":{"source":"https://github.com/clarkema/raku-readline"},"tags":["terminal","readline","CLI"],"test-depends":["Test"],"version":"0.1.7"},"files":[{"file":"work_mods/zef/Readline/dist/README.md","publishUrl":"/mods/zef/Readline/dist/README.md"},{"file":"work_mods/zef/Readline/dist/lib/Readline.pm","publishUrl":"/mods/zef/Readline/dist/lib/Readline.pm"}],"src":"zef","url":"/mods/zef/Readline"}}}
=end data


React

    =begin React :component<RenderItem>
    =begin data
    {"type":"page","file":"work_mods/zef/Readline/dist/README.md","sources":[],"node":{"type":"block","id":"9gQbxr7ErAUcD770wnl4T","margin":"","name":"root","content":[{"type":"block","id":"tRaGsb6c-sr0onh9q_QT5","margin":"","level":1,"name":"head","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":2,"column":8,"offset":16}},"content":["Readline"]},{"type":"block","id":"Ny1JrZRuV3ikyzVNiQ4fa","margin":"","level":5,"name":"head","location":{"start":{"line":4,"column":1,"offset":18},"end":{"line":4,"column":83,"offset":100}},"content":[{"type":"fcode","name":"I","content":["Note: This README will soon be updated based on new development priorities"]}]},{"type":"para","id":"wsVADfSzAGgI3gRdRGN0x","margin":"","location":{"start":{"line":6,"column":1,"offset":102},"end":{"line":6,"column":53,"offset":154}},"text":"text","content":["Readline provides a Perl 6 interface to libreadline."]},{"type":"para","id":"aGvloC7B3eRrJrys7kPuS","margin":"","location":{"start":{"line":8,"column":1,"offset":156},"end":{"line":9,"column":66,"offset":301}},"text":"text","content":["XXX This will probably be a frontend to Readline::Gnu when that's factored out.\nXXX For the moment keep all the code here in the Readline module."]},{"type":"block","id":"a5h_ZWMU6j2APLJIsHqz4","margin":"","level":1,"name":"head","location":{"start":{"line":11,"column":1,"offset":303},"end":{"line":12,"column":13,"offset":328}},"content":["Installation"]},{"type":"para","id":"JVE2OQM9b05rA-pGZ0IPF","margin":"","location":{"start":{"line":14,"column":1,"offset":330},"end":{"line":14,"column":398,"offset":727}},"text":"text","content":["Please make sure that libreadline is installed beforehand, the tests will fail otherwise. If libreadline is installed but the tests still fail, please note that the Perl 6 package searches a given set of directories for libreadline.{so,dynlib}.* files, otherwise it defaults to v7. If your libreadline installation isn't on any of these paths, or requires non-standard setup, please file an issue."]},{"type":"para","id":"Y27MvYgzKfB3HFHqeI3xu","margin":"","location":{"start":{"line":16,"column":1,"offset":729},"end":{"line":16,"column":129,"offset":857}},"text":"text","content":["For those of you on Linux Debian and Linux-alike systems, you should be able to get the latest version with this CLI invocation:"]},{"type":"block","id":"zKHZu_Q2fD0p-41pOWLDv","margin":"","name":"code","config":[],"location":{"start":{"line":18,"column":1,"offset":859},"end":{"line":20,"column":4,"offset":901}},"content":[{"type":"verbatim","value":"\tsudo apt-get install libreadline7"}]},{"type":"para","id":"lrwrdc6nn12iG-BiHaL_8","margin":"","location":{"start":{"line":21,"column":1,"offset":902},"end":{"line":21,"column":85,"offset":986}},"text":"text","content":["(I'd prefer to use LibraryCheck, but it fails inside the 'is native()' method call.)"]},{"type":"para","id":"GMR6TRQ6IPrSq0eH3hHYd","margin":"","location":{"start":{"line":24,"column":1,"offset":989},"end":{"line":24,"column":127,"offset":1115}},"text":"text","content":["On Macs, use Hombrew to install readline. If you installed Rakudo-Star with homebrew after Sept. 1 it should already be there."]},{"type":"para","id":"GkW_w05b9K7N68jknQa66","margin":"","location":{"start":{"line":26,"column":1,"offset":1117},"end":{"line":26,"column":37,"offset":1153}},"text":"text","content":["If not you can install just Readline"]},{"type":"block","id":"cL-ydg1jhFFy-loUrFcr_","margin":"","name":"code","config":[],"location":{"start":{"line":28,"column":1,"offset":1155},"end":{"line":30,"column":4,"offset":1188}},"content":[{"type":"verbatim","value":"    brew install readline"}]},{"type":"para","id":"H6djj6QDDpvgOZ7xB0U9U","margin":"","location":{"start":{"line":32,"column":1,"offset":1190},"end":{"line":32,"column":36,"offset":1225}},"text":"text","content":["or update your rakudo-star install."]},{"type":"block","id":"O9xVcgIiKDRbRKpI_-HN0","margin":"","name":"code","config":[],"location":{"start":{"line":34,"column":1,"offset":1227},"end":{"line":36,"column":4,"offset":1263}},"content":[{"type":"verbatim","value":"    brew upgrade rakudo-star"}]},{"type":"list","id":"_NL2DvEMG-zCFmAPdriXE","margin":"","level":1,"list":"itemized","content":[{"type":"block","id":"i0QJ1cIyNJkFHDXjSc03o","margin":"","name":"item","level":1,"location":{"start":{"line":40,"column":1,"offset":1267},"end":{"line":40,"column":65,"offset":1331}},"content":[{"type":"para","id":"Vm_MPKPOEgloIaiSC__nk","margin":"","location":{"start":{"line":40,"column":3,"offset":1269},"end":{"line":40,"column":65,"offset":1331}},"text":"text","content":["Using zef (a module management tool bundled with Rakudo Star):"]}]}]},{"type":"block","id":"_p_uQ-frNoGm2Qp3tq25E","margin":"","name":"code","config":[],"location":{"start":{"line":44,"column":1,"offset":1335},"end":{"line":46,"column":4,"offset":1381}},"content":[{"type":"verbatim","value":"    zef update && zef install Readline"}]},{"type":"para","id":"oDP9H4l6gzXHpUummyHuZ","margin":"","location":{"start":{"line":49,"column":1,"offset":1384},"end":{"line":49,"column":70,"offset":1453}},"text":"text","content":["Or alternatively installing it from a checkout of this repo with zef:"]},{"type":"block","id":"EERloc_9hfFkHmrAl2ats","margin":"","name":"code","config":[],"location":{"start":{"line":51,"column":1,"offset":1455},"end":{"line":53,"column":4,"offset":1480}},"content":[{"type":"verbatim","value":"    zef install ."}]},{"type":"block","id":"ghpjTOUJ4iJFWbF1KrPZI","margin":"","level":2,"name":"head","location":{"start":{"line":57,"column":1,"offset":1484},"end":{"line":57,"column":9,"offset":1492}},"content":["Usage"]},{"type":"para","id":"yMBcEKIgE6e3x73-Ftr1R","margin":"","location":{"start":{"line":59,"column":1,"offset":1494},"end":{"line":59,"column":47,"offset":1540}},"text":"text","content":["See the ",{"type":"fcode","name":"C","content":["examples/"]}," directory in this project."]},{"type":"block","id":"kZ4BXR4sg40YxEkrV78O7","margin":"","level":2,"name":"head","location":{"start":{"line":61,"column":1,"offset":1542},"end":{"line":61,"column":11,"offset":1552}},"content":["Testing"]},{"type":"para","id":"FOSixwDU1XPSN_JlgPrNJ","margin":"","location":{"start":{"line":63,"column":1,"offset":1554},"end":{"line":63,"column":14,"offset":1567}},"text":"text","content":["To run tests:"]},{"type":"block","id":"jFqvx8Z1MLjzBgyizI_GP","margin":"","name":"code","config":[],"location":{"start":{"line":65,"column":1,"offset":1569},"end":{"line":67,"column":4,"offset":1595}},"content":[{"type":"verbatim","value":"    prove -e perl6"}]},{"type":"block","id":"7cRvU86_KJsCWKyDDHzMX","margin":"","level":2,"name":"head","location":{"start":{"line":69,"column":1,"offset":1597},"end":{"line":69,"column":10,"offset":1606}},"content":["Author"]},{"type":"para","id":"YA-lB3RP0RQu9qX2oHFTB","margin":"","location":{"start":{"line":71,"column":1,"offset":1608},"end":{"line":72,"column":76,"offset":1742}},"text":"text","content":["Jeffrey Goff, DrForr on #perl6, ",{"meta":"https://github.com/drforr/","type":"fcode","name":"L","content":["https://github.com/drforr/"]},"\n(Recently taken over by Daniel Lathrop (fooist), ",{"meta":"https://github.com/fooist/","type":"fcode","name":"L","content":["https://github.com/fooist/"]}]},{"type":"block","id":"_HlOoRzeoYKueq-ngVarq","margin":"","level":2,"name":"head","location":{"start":{"line":74,"column":1,"offset":1744},"end":{"line":74,"column":11,"offset":1754}},"content":["License"]},{"type":"para","id":"plhgQUEZmqJC6sW5KZlf0","margin":"","location":{"start":{"line":76,"column":1,"offset":1756},"end":{"line":76,"column":21,"offset":1776}},"text":"text","content":["Artistic License 2.0"]}]},"publishUrl":"/mods/zef/Readline/dist/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"","auth":"zef:clarkema","authors":["Jeffrey Goff <drforr@pobox.com>","Daniel Lathrop <dwl@foo.ist>","Mike Clarke <clarkema@clarkema.org>"],"build-depends":["LibraryCheck"],"depends":[],"description":"Raku interface to GNU Readline, the CLI-based line reading library","dist":"Readline:ver<0.1.7>:auth<zef:clarkema>","license":"Artistic-2.0","meta6":"0","name":"Readline","path":"R/EA/READLINE/6bf81b82026641a849aa03175e5690da54e9e58e.tar.gz","perl":"6.c","provides":{"Readline":"lib/Readline.pm"},"resources":[],"source-url":"https://github.com/clarkema/raku-readline.git","support":{"source":"https://github.com/clarkema/raku-readline"},"tags":["terminal","readline","CLI"],"test-depends":["Test"],"version":"0.1.7"},"files":[{"file":"work_mods/zef/Readline/dist/README.md","publishUrl":"/mods/zef/Readline/dist/README.md"},{"file":"work_mods/zef/Readline/dist/lib/Readline.pm","publishUrl":"/mods/zef/Readline/dist/lib/Readline.pm"}],"src":"zef","url":"/mods/zef/Readline"}}}
    =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

Readline


A lock with shared/exclusive access modes


=begin data
{"type":"page","file":"work_mods/zef/ReadWriteLock/ReadWriteLock-0.3.0/README.md","sources":[],"node":{"type":"block","id":"JeAgIDCFbKB1OmoDRSD5p","margin":"","name":"root","content":[{"type":"para","id":"Dckc2UsCD9UHctTiTRxCQ","margin":"","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":135,"offset":134}},"text":"text","content":[{"meta":"https://github.com/lizmat/ReadWriteLock/actions","type":"fcode","name":"L","content":[{"type":"block","id":"Y9K5_O1zi_zqNf2wlWM5d","margin":"","name":"Image","config":[],"location":{"start":{"line":1,"column":2,"offset":1},"end":{"line":1,"column":85,"offset":84}},"content":[{"type":"image","src":"https://github.com/lizmat/ReadWriteLock/workflows/test/badge.svg","alt":"Actions Status"}]}]}]},{"type":"block","id":"nNmZ8AxCF9yuDCrgKR5Tk","margin":"","level":1,"name":"head","location":{"start":{"line":3,"column":1,"offset":136},"end":{"line":4,"column":6,"offset":147}},"content":["TITLE"]},{"type":"para","id":"RGyXyKSbaEcmcde7N8VnU","margin":"","location":{"start":{"line":6,"column":1,"offset":149},"end":{"line":6,"column":59,"offset":207}},"text":"text","content":["ReadWriteLock -- A lock with shared/exclusive access modes"]},{"type":"block","id":"4kNpa7btPPH2jwPb29w3T","margin":"","level":1,"name":"head","location":{"start":{"line":8,"column":1,"offset":209},"end":{"line":9,"column":9,"offset":226}},"content":["SYNOPSIS"]},{"type":"block","id":"ETlqF7OmLaI16eUAnL6OZ","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":11,"column":1,"offset":228},"end":{"line":46,"column":4,"offset":903}},"content":[{"type":"verbatim","value":"use ReadWriteLock;\n\nmy $l = ReadWriteLock.new;\n\nmy $thread-a = Thread.start({\n    $l.lock-shared();\n    for ^5 {\n        sleep 1;\n        say \"thread A doing something under protection of the lock\";\n    }\n    $l.unlock();\n});\n\nmy $thread-b = Thread.start({\n    $l.protect-shared({\n        for ^5 {\n            sleep 1;\n            say \"thread B doing something under protection of the lock\";\n        }\n    });\n});\n\nmy $thread-c = Thread.start({\n    $l.protect-exclusive({\n        for ^5 {\n            sleep 1;\n            say \"thread C doing something under exclusive protection of the lock\";\n        }\n    });\n});\n\n$thread-a.join;\n$thread-b.join;\n$thread-c.join;"}]},{"type":"block","id":"hyUDQf2PlXdO-sN73zr9l","margin":"","level":1,"name":"head","location":{"start":{"line":48,"column":1,"offset":905},"end":{"line":49,"column":9,"offset":922}},"content":["FEATURES"]},{"type":"list","id":"qkrsdAcEd2kbaMOSpcmy5","margin":"","level":1,"list":"itemized","content":[{"type":"block","id":"rdQNdGSFeQPy6wG829xrQ","margin":"","name":"item","level":1,"location":{"start":{"line":51,"column":3,"offset":926},"end":{"line":51,"column":69,"offset":992}},"content":[{"type":"para","id":"pAWLTpo5W_JMZTd5oE10e","margin":"","location":{"start":{"line":51,"column":5,"offset":928},"end":{"line":51,"column":69,"offset":992}},"text":"text","content":["Does what a basic ",{"type":"fcode","name":"C","content":["Lock"]}," does, just slower and with more bugs ;)"]}]},{"type":"block","id":"VGIAoEuWZCO2GfmB_rTFk","margin":"","name":"item","level":1,"location":{"start":{"line":53,"column":3,"offset":996},"end":{"line":53,"column":186,"offset":1179}},"content":[{"type":"para","id":"44SDXNiFfaLpeSyofhqgT","margin":"","location":{"start":{"line":53,"column":5,"offset":998},"end":{"line":53,"column":186,"offset":1179}},"text":"text","content":["Reentrant: the lock can be taken again by a thread that is already holding it It needs to be unlocked the same number of times it was locked before it can be taken by another thread"]}]},{"type":"block","id":"yGazcsgCDBGBwqhyU9SpD","margin":"","name":"item","level":1,"location":{"start":{"line":55,"column":3,"offset":1183},"end":{"line":55,"column":48,"offset":1228}},"content":[{"type":"para","id":"v3MOOSl3_I4vp7Mr4rWGC","margin":"","location":{"start":{"line":55,"column":5,"offset":1185},"end":{"line":55,"column":48,"offset":1228}},"text":"text","content":["Fair in the sense of first-come-first-serve"]}]},{"type":"block","id":"wv6h4k-d9NzqQ_m1v7xRu","margin":"","name":"item","level":1,"location":{"start":{"line":57,"column":3,"offset":1232},"end":{"line":57,"column":123,"offset":1352}},"content":[{"type":"para","id":"Oe2Hov7Vps1mVBb1v1M3f","margin":"","location":{"start":{"line":57,"column":5,"offset":1234},"end":{"line":57,"column":123,"offset":1352}},"text":"text","content":["Shared access: multiple 'readers' can share the lock, yet access is mutually exclusive between 'readers' and 'writers'"]}]},{"type":"block","id":"fWHjHdGqHbiA-Ky9SGFmU","margin":"","name":"item","level":1,"location":{"start":{"line":59,"column":3,"offset":1356},"end":{"line":59,"column":178,"offset":1531}},"content":[{"type":"para","id":"9wUVMB-dxLICSTiAKvoY0","margin":"","location":{"start":{"line":59,"column":5,"offset":1358},"end":{"line":59,"column":178,"offset":1531}},"text":"text","content":["Lock Upgrade: you can upgrade a shared access mode to an exclusive without unlocking first, if no other thread is interferring. In this case you do not need to unlock twice."]}]}]},{"type":"block","id":"f8fbhfJpGxTttHFsqpJTH","margin":"","level":1,"name":"head","location":{"start":{"line":61,"column":1,"offset":1533},"end":{"line":62,"column":17,"offset":1566}},"content":["PLANNED FEATURES"]},{"type":"list","id":"DRp8kwtfNl4fHTLWMgoph","margin":"","level":1,"list":"itemized","content":[{"type":"block","id":"uL62lFPnik0rQYRU-VKTc","margin":"","name":"item","level":1,"location":{"start":{"line":64,"column":3,"offset":1570},"end":{"line":64,"column":80,"offset":1647}},"content":[{"type":"para","id":"-2IGQNTzxHO7zfVojpcHl","margin":"","location":{"start":{"line":64,"column":5,"offset":1572},"end":{"line":64,"column":80,"offset":1647}},"text":"text","content":["Read-for-write access mode that guarantees that a lock upgrade can be taken"]}]},{"type":"block","id":"qoqaA60RGG32pC1PSgIwY","margin":"","name":"item","level":1,"location":{"start":{"line":66,"column":3,"offset":1651},"end":{"line":66,"column":91,"offset":1739}},"content":[{"type":"para","id":"jVwqsuvhhZviCVT8z6Cya","margin":"","location":{"start":{"line":66,"column":5,"offset":1653},"end":{"line":66,"column":91,"offset":1739}},"text":"text","content":["Async version that returns threads to the threadpool and returns a promise from lock()"]}]}]},{"type":"block","id":"Hyka2sM2XUxgNuCGNB3mE","margin":"","level":1,"name":"head","location":{"start":{"line":68,"column":1,"offset":1741},"end":{"line":69,"column":12,"offset":1764}},"content":["DESCRIPTION"]},{"type":"para","id":"7E1uWIBeNSeLS_G7cyvJ8","margin":"","location":{"start":{"line":71,"column":1,"offset":1766},"end":{"line":71,"column":283,"offset":2048}},"text":"text","content":["This module implements a lock/mutex with shared and exclusive access modes, so a set of 'readers' could share the lock while 'writers' need exclusive access. The lock is reentrant, so can be taken multiple times by the same thread, and fair in the sense of come-first-server-first."]},{"type":"para","id":"kxKoDfJqWQrnpZ_1seaeA","margin":"","location":{"start":{"line":73,"column":1,"offset":2050},"end":{"line":73,"column":226,"offset":2275}},"text":"text","content":["Please note that locks of whatever kind are a very low-level synchronisation mechanism and inherently difficult to use correctly, where possible higher-level mechanisms like a ",{"type":"fcode","name":"C","content":["Channel"]},", ",{"type":"fcode","name":"C","content":["Promise"]}," or ",{"type":"fcode","name":"C","content":["Suppply"]}," should be used."]},{"type":"block","id":"zMXkSmg_6QeQTMD8Styv3","margin":"","level":1,"name":"head","location":{"start":{"line":75,"column":1,"offset":2277},"end":{"line":76,"column":9,"offset":2294}},"content":["EXAMPLES"]},{"type":"block","id":"bFedbd0SsODc9sxR0GsA0","margin":"","level":2,"name":"head","location":{"start":{"line":78,"column":1,"offset":2296},"end":{"line":79,"column":12,"offset":2319}},"content":["Constructor"]},{"type":"block","id":"xaCu8ZtaswA5jZ9cDMC0R","margin":"","name":"code","config":[],"location":{"start":{"line":81,"column":1,"offset":2321},"end":{"line":83,"column":32,"offset":2375}},"content":[{"type":"verbatim","value":"use ReadWriteLock\n\nmy $l = ReadWriteLock.new()"}]},{"type":"para","id":"XXHAY4dh_qBXufVFgQfMG","margin":"","location":{"start":{"line":85,"column":1,"offset":2377},"end":{"line":85,"column":68,"offset":2444}},"text":"text","content":["Constructing a ReadWriteLock is very simple and takes no arguments."]},{"type":"block","id":"1BJzIids_6xb9WO0F9sL-","margin":"","level":2,"name":"head","location":{"start":{"line":87,"column":1,"offset":2446},"end":{"line":88,"column":26,"offset":2497}},"content":["Protecting a Code segment"]},{"type":"block","id":"mQrh3qeNFskDxKETUV4oW","margin":"","name":"code","config":[],"location":{"start":{"line":90,"column":1,"offset":2499},"end":{"line":104,"column":8,"offset":2721}},"content":[{"type":"verbatim","value":"$l.protect-shared({\n    # code thunk\n});\n\n$l.protect-exclusive({\n    # code thunk\n});\n\n$l.protect(shared, {\n    # code thunk\n});\n\n$l.protect(exclusive, {\n    # code thunk\n});"}]},{"type":"para","id":"SzNuAByd47IJku0FCMYN7","margin":"","location":{"start":{"line":106,"column":1,"offset":2723},"end":{"line":106,"column":351,"offset":3073}},"text":"text","content":["The ",{"type":"fcode","name":"C","content":["protect()"]}," usage pattern has the distinct benefit that it automatically unlocks in case of e.g. exceptions or whenever the code block is being left. You can either use the 'long' form like ",{"type":"fcode","name":"C","content":["protect-shared()"]},", which is nice and implicit, or pass the access mode in as an argument, which allows determning it from a function and passing it around."]},{"type":"block","id":"PyVhl4GJzly7WIJmxt_m0","margin":"","level":2,"name":"head","location":{"start":{"line":108,"column":1,"offset":3075},"end":{"line":109,"column":25,"offset":3124}},"content":["Direct locking/unlocking"]},{"type":"block","id":"Vt-sTZrgN7FhTtOA737zp","margin":"","name":"code","config":[],"location":{"start":{"line":111,"column":1,"offset":3126},"end":{"line":119,"column":17,"offset":3238}},"content":[{"type":"verbatim","value":"$l.lock-shared();\n\n$l.lock-exclusive();\n\n$l.lock(shared);\n\n$l.lock(exclusive);\n\n$l.unlock();"}]},{"type":"para","id":"lbYaBLZkAwQl-swkGTZiy","margin":"","location":{"start":{"line":121,"column":1,"offset":3240},"end":{"line":121,"column":266,"offset":3505}},"text":"text","content":["Alternatively you can also use stand-alone lock/unlock calls, which allows tricky usages like overhand locking etc, but requires more care to be safe. If you lock multiple times, you need to unlock a matching number of times before the lock becomes available again."]},{"type":"block","id":"g7oaZ7a9mxQ73cy1Wg18j","margin":"","level":2,"name":"head","location":{"start":{"line":123,"column":1,"offset":3507},"end":{"line":124,"column":14,"offset":3534}},"content":["Lock Upgrades"]},{"type":"block","id":"15Q39zDdHvY1iTWzB72_f","margin":"","name":"code","config":[],"location":{"start":{"line":126,"column":1,"offset":3536},"end":{"line":134,"column":17,"offset":3677}},"content":[{"type":"verbatim","value":"$l.lock-shared();\n\n# do something\n\n$l.lock-exclusive();\n\n# do something else that requires exclusive access\n\n$l.unlock();"}]},{"type":"para","id":"J8LscrHlkPBLDAls5A2Yt","margin":"","location":{"start":{"line":136,"column":1,"offset":3679},"end":{"line":136,"column":272,"offset":3950}},"text":"text","content":["You can upgrade a lock that you are holding in shared mode to an exclusive access, as long as no other thread was traying to do the same before (You will get an exception in that case). In this case you only need to unlock once, the lock has been upgraded not re-entered."]}]},"publishUrl":"/mods/zef/ReadWriteLock/ReadWriteLock-0.3.0/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"","auth":"zef:lizmat","authors":["Robert Lemmen","Elizabeth Mattijsen"],"build-depends":[],"depends":[],"description":"A lock with shared/exclusive access modes","dist":"ReadWriteLock:ver<0.3.0>:auth<zef:lizmat>","license":"Artistic-2.0","name":"ReadWriteLock","path":"R/EA/READWRITELOCK/f52dafd35e9ec02ab6992b0024fae2e1a7601d9b.tar.gz","perl":"6.c","provides":{"ReadWriteLock":"lib/ReadWriteLock.rakumod"},"resources":[],"source-url":"https://github.com/lizmat/ReadWriteLock.git","tags":[],"test-depends":["Test::META"],"version":"0.3.0"},"files":[{"file":"work_mods/zef/ReadWriteLock/ReadWriteLock-0.3.0/README.md","publishUrl":"/mods/zef/ReadWriteLock/ReadWriteLock-0.3.0/README.md"},{"file":"work_mods/zef/ReadWriteLock/ReadWriteLock-0.3.0/lib/ReadWriteLock.rakumod","publishUrl":"/mods/zef/ReadWriteLock/ReadWriteLock-0.3.0/lib/ReadWriteLock.rakumod"}],"src":"zef","url":"/mods/zef/ReadWriteLock"}}}
=end data


    =begin React :component<RenderItem>
    =begin data
    {"type":"page","file":"work_mods/zef/ReadWriteLock/ReadWriteLock-0.3.0/README.md","sources":[],"node":{"type":"block","id":"JeAgIDCFbKB1OmoDRSD5p","margin":"","name":"root","content":[{"type":"para","id":"Dckc2UsCD9UHctTiTRxCQ","margin":"","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":135,"offset":134}},"text":"text","content":[{"meta":"https://github.com/lizmat/ReadWriteLock/actions","type":"fcode","name":"L","content":[{"type":"block","id":"Y9K5_O1zi_zqNf2wlWM5d","margin":"","name":"Image","config":[],"location":{"start":{"line":1,"column":2,"offset":1},"end":{"line":1,"column":85,"offset":84}},"content":[{"type":"image","src":"https://github.com/lizmat/ReadWriteLock/workflows/test/badge.svg","alt":"Actions Status"}]}]}]},{"type":"block","id":"nNmZ8AxCF9yuDCrgKR5Tk","margin":"","level":1,"name":"head","location":{"start":{"line":3,"column":1,"offset":136},"end":{"line":4,"column":6,"offset":147}},"content":["TITLE"]},{"type":"para","id":"RGyXyKSbaEcmcde7N8VnU","margin":"","location":{"start":{"line":6,"column":1,"offset":149},"end":{"line":6,"column":59,"offset":207}},"text":"text","content":["ReadWriteLock -- A lock with shared/exclusive access modes"]},{"type":"block","id":"4kNpa7btPPH2jwPb29w3T","margin":"","level":1,"name":"head","location":{"start":{"line":8,"column":1,"offset":209},"end":{"line":9,"column":9,"offset":226}},"content":["SYNOPSIS"]},{"type":"block","id":"ETlqF7OmLaI16eUAnL6OZ","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":11,"column":1,"offset":228},"end":{"line":46,"column":4,"offset":903}},"content":[{"type":"verbatim","value":"use ReadWriteLock;\n\nmy $l = ReadWriteLock.new;\n\nmy $thread-a = Thread.start({\n    $l.lock-shared();\n    for ^5 {\n        sleep 1;\n        say \"thread A doing something under protection of the lock\";\n    }\n    $l.unlock();\n});\n\nmy $thread-b = Thread.start({\n    $l.protect-shared({\n        for ^5 {\n            sleep 1;\n            say \"thread B doing something under protection of the lock\";\n        }\n    });\n});\n\nmy $thread-c = Thread.start({\n    $l.protect-exclusive({\n        for ^5 {\n            sleep 1;\n            say \"thread C doing something under exclusive protection of the lock\";\n        }\n    });\n});\n\n$thread-a.join;\n$thread-b.join;\n$thread-c.join;"}]},{"type":"block","id":"hyUDQf2PlXdO-sN73zr9l","margin":"","level":1,"name":"head","location":{"start":{"line":48,"column":1,"offset":905},"end":{"line":49,"column":9,"offset":922}},"content":["FEATURES"]},{"type":"list","id":"qkrsdAcEd2kbaMOSpcmy5","margin":"","level":1,"list":"itemized","content":[{"type":"block","id":"rdQNdGSFeQPy6wG829xrQ","margin":"","name":"item","level":1,"location":{"start":{"line":51,"column":3,"offset":926},"end":{"line":51,"column":69,"offset":992}},"content":[{"type":"para","id":"pAWLTpo5W_JMZTd5oE10e","margin":"","location":{"start":{"line":51,"column":5,"offset":928},"end":{"line":51,"column":69,"offset":992}},"text":"text","content":["Does what a basic ",{"type":"fcode","name":"C","content":["Lock"]}," does, just slower and with more bugs ;)"]}]},{"type":"block","id":"VGIAoEuWZCO2GfmB_rTFk","margin":"","name":"item","level":1,"location":{"start":{"line":53,"column":3,"offset":996},"end":{"line":53,"column":186,"offset":1179}},"content":[{"type":"para","id":"44SDXNiFfaLpeSyofhqgT","margin":"","location":{"start":{"line":53,"column":5,"offset":998},"end":{"line":53,"column":186,"offset":1179}},"text":"text","content":["Reentrant: the lock can be taken again by a thread that is already holding it It needs to be unlocked the same number of times it was locked before it can be taken by another thread"]}]},{"type":"block","id":"yGazcsgCDBGBwqhyU9SpD","margin":"","name":"item","level":1,"location":{"start":{"line":55,"column":3,"offset":1183},"end":{"line":55,"column":48,"offset":1228}},"content":[{"type":"para","id":"v3MOOSl3_I4vp7Mr4rWGC","margin":"","location":{"start":{"line":55,"column":5,"offset":1185},"end":{"line":55,"column":48,"offset":1228}},"text":"text","content":["Fair in the sense of first-come-first-serve"]}]},{"type":"block","id":"wv6h4k-d9NzqQ_m1v7xRu","margin":"","name":"item","level":1,"location":{"start":{"line":57,"column":3,"offset":1232},"end":{"line":57,"column":123,"offset":1352}},"content":[{"type":"para","id":"Oe2Hov7Vps1mVBb1v1M3f","margin":"","location":{"start":{"line":57,"column":5,"offset":1234},"end":{"line":57,"column":123,"offset":1352}},"text":"text","content":["Shared access: multiple 'readers' can share the lock, yet access is mutually exclusive between 'readers' and 'writers'"]}]},{"type":"block","id":"fWHjHdGqHbiA-Ky9SGFmU","margin":"","name":"item","level":1,"location":{"start":{"line":59,"column":3,"offset":1356},"end":{"line":59,"column":178,"offset":1531}},"content":[{"type":"para","id":"9wUVMB-dxLICSTiAKvoY0","margin":"","location":{"start":{"line":59,"column":5,"offset":1358},"end":{"line":59,"column":178,"offset":1531}},"text":"text","content":["Lock Upgrade: you can upgrade a shared access mode to an exclusive without unlocking first, if no other thread is interferring. In this case you do not need to unlock twice."]}]}]},{"type":"block","id":"f8fbhfJpGxTttHFsqpJTH","margin":"","level":1,"name":"head","location":{"start":{"line":61,"column":1,"offset":1533},"end":{"line":62,"column":17,"offset":1566}},"content":["PLANNED FEATURES"]},{"type":"list","id":"DRp8kwtfNl4fHTLWMgoph","margin":"","level":1,"list":"itemized","content":[{"type":"block","id":"uL62lFPnik0rQYRU-VKTc","margin":"","name":"item","level":1,"location":{"start":{"line":64,"column":3,"offset":1570},"end":{"line":64,"column":80,"offset":1647}},"content":[{"type":"para","id":"-2IGQNTzxHO7zfVojpcHl","margin":"","location":{"start":{"line":64,"column":5,"offset":1572},"end":{"line":64,"column":80,"offset":1647}},"text":"text","content":["Read-for-write access mode that guarantees that a lock upgrade can be taken"]}]},{"type":"block","id":"qoqaA60RGG32pC1PSgIwY","margin":"","name":"item","level":1,"location":{"start":{"line":66,"column":3,"offset":1651},"end":{"line":66,"column":91,"offset":1739}},"content":[{"type":"para","id":"jVwqsuvhhZviCVT8z6Cya","margin":"","location":{"start":{"line":66,"column":5,"offset":1653},"end":{"line":66,"column":91,"offset":1739}},"text":"text","content":["Async version that returns threads to the threadpool and returns a promise from lock()"]}]}]},{"type":"block","id":"Hyka2sM2XUxgNuCGNB3mE","margin":"","level":1,"name":"head","location":{"start":{"line":68,"column":1,"offset":1741},"end":{"line":69,"column":12,"offset":1764}},"content":["DESCRIPTION"]},{"type":"para","id":"7E1uWIBeNSeLS_G7cyvJ8","margin":"","location":{"start":{"line":71,"column":1,"offset":1766},"end":{"line":71,"column":283,"offset":2048}},"text":"text","content":["This module implements a lock/mutex with shared and exclusive access modes, so a set of 'readers' could share the lock while 'writers' need exclusive access. The lock is reentrant, so can be taken multiple times by the same thread, and fair in the sense of come-first-server-first."]},{"type":"para","id":"kxKoDfJqWQrnpZ_1seaeA","margin":"","location":{"start":{"line":73,"column":1,"offset":2050},"end":{"line":73,"column":226,"offset":2275}},"text":"text","content":["Please note that locks of whatever kind are a very low-level synchronisation mechanism and inherently difficult to use correctly, where possible higher-level mechanisms like a ",{"type":"fcode","name":"C","content":["Channel"]},", ",{"type":"fcode","name":"C","content":["Promise"]}," or ",{"type":"fcode","name":"C","content":["Suppply"]}," should be used."]},{"type":"block","id":"zMXkSmg_6QeQTMD8Styv3","margin":"","level":1,"name":"head","location":{"start":{"line":75,"column":1,"offset":2277},"end":{"line":76,"column":9,"offset":2294}},"content":["EXAMPLES"]},{"type":"block","id":"bFedbd0SsODc9sxR0GsA0","margin":"","level":2,"name":"head","location":{"start":{"line":78,"column":1,"offset":2296},"end":{"line":79,"column":12,"offset":2319}},"content":["Constructor"]},{"type":"block","id":"xaCu8ZtaswA5jZ9cDMC0R","margin":"","name":"code","config":[],"location":{"start":{"line":81,"column":1,"offset":2321},"end":{"line":83,"column":32,"offset":2375}},"content":[{"type":"verbatim","value":"use ReadWriteLock\n\nmy $l = ReadWriteLock.new()"}]},{"type":"para","id":"XXHAY4dh_qBXufVFgQfMG","margin":"","location":{"start":{"line":85,"column":1,"offset":2377},"end":{"line":85,"column":68,"offset":2444}},"text":"text","content":["Constructing a ReadWriteLock is very simple and takes no arguments."]},{"type":"block","id":"1BJzIids_6xb9WO0F9sL-","margin":"","level":2,"name":"head","location":{"start":{"line":87,"column":1,"offset":2446},"end":{"line":88,"column":26,"offset":2497}},"content":["Protecting a Code segment"]},{"type":"block","id":"mQrh3qeNFskDxKETUV4oW","margin":"","name":"code","config":[],"location":{"start":{"line":90,"column":1,"offset":2499},"end":{"line":104,"column":8,"offset":2721}},"content":[{"type":"verbatim","value":"$l.protect-shared({\n    # code thunk\n});\n\n$l.protect-exclusive({\n    # code thunk\n});\n\n$l.protect(shared, {\n    # code thunk\n});\n\n$l.protect(exclusive, {\n    # code thunk\n});"}]},{"type":"para","id":"SzNuAByd47IJku0FCMYN7","margin":"","location":{"start":{"line":106,"column":1,"offset":2723},"end":{"line":106,"column":351,"offset":3073}},"text":"text","content":["The ",{"type":"fcode","name":"C","content":["protect()"]}," usage pattern has the distinct benefit that it automatically unlocks in case of e.g. exceptions or whenever the code block is being left. You can either use the 'long' form like ",{"type":"fcode","name":"C","content":["protect-shared()"]},", which is nice and implicit, or pass the access mode in as an argument, which allows determning it from a function and passing it around."]},{"type":"block","id":"PyVhl4GJzly7WIJmxt_m0","margin":"","level":2,"name":"head","location":{"start":{"line":108,"column":1,"offset":3075},"end":{"line":109,"column":25,"offset":3124}},"content":["Direct locking/unlocking"]},{"type":"block","id":"Vt-sTZrgN7FhTtOA737zp","margin":"","name":"code","config":[],"location":{"start":{"line":111,"column":1,"offset":3126},"end":{"line":119,"column":17,"offset":3238}},"content":[{"type":"verbatim","value":"$l.lock-shared();\n\n$l.lock-exclusive();\n\n$l.lock(shared);\n\n$l.lock(exclusive);\n\n$l.unlock();"}]},{"type":"para","id":"lbYaBLZkAwQl-swkGTZiy","margin":"","location":{"start":{"line":121,"column":1,"offset":3240},"end":{"line":121,"column":266,"offset":3505}},"text":"text","content":["Alternatively you can also use stand-alone lock/unlock calls, which allows tricky usages like overhand locking etc, but requires more care to be safe. If you lock multiple times, you need to unlock a matching number of times before the lock becomes available again."]},{"type":"block","id":"g7oaZ7a9mxQ73cy1Wg18j","margin":"","level":2,"name":"head","location":{"start":{"line":123,"column":1,"offset":3507},"end":{"line":124,"column":14,"offset":3534}},"content":["Lock Upgrades"]},{"type":"block","id":"15Q39zDdHvY1iTWzB72_f","margin":"","name":"code","config":[],"location":{"start":{"line":126,"column":1,"offset":3536},"end":{"line":134,"column":17,"offset":3677}},"content":[{"type":"verbatim","value":"$l.lock-shared();\n\n# do something\n\n$l.lock-exclusive();\n\n# do something else that requires exclusive access\n\n$l.unlock();"}]},{"type":"para","id":"J8LscrHlkPBLDAls5A2Yt","margin":"","location":{"start":{"line":136,"column":1,"offset":3679},"end":{"line":136,"column":272,"offset":3950}},"text":"text","content":["You can upgrade a lock that you are holding in shared mode to an exclusive access, as long as no other thread was traying to do the same before (You will get an exception in that case). In this case you only need to unlock once, the lock has been upgraded not re-entered."]}]},"publishUrl":"/mods/zef/ReadWriteLock/ReadWriteLock-0.3.0/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"","auth":"zef:lizmat","authors":["Robert Lemmen","Elizabeth Mattijsen"],"build-depends":[],"depends":[],"description":"A lock with shared/exclusive access modes","dist":"ReadWriteLock:ver<0.3.0>:auth<zef:lizmat>","license":"Artistic-2.0","name":"ReadWriteLock","path":"R/EA/READWRITELOCK/f52dafd35e9ec02ab6992b0024fae2e1a7601d9b.tar.gz","perl":"6.c","provides":{"ReadWriteLock":"lib/ReadWriteLock.rakumod"},"resources":[],"source-url":"https://github.com/lizmat/ReadWriteLock.git","tags":[],"test-depends":["Test::META"],"version":"0.3.0"},"files":[{"file":"work_mods/zef/ReadWriteLock/ReadWriteLock-0.3.0/README.md","publishUrl":"/mods/zef/ReadWriteLock/ReadWriteLock-0.3.0/README.md"},{"file":"work_mods/zef/ReadWriteLock/ReadWriteLock-0.3.0/lib/ReadWriteLock.rakumod","publishUrl":"/mods/zef/ReadWriteLock/ReadWriteLock-0.3.0/lib/ReadWriteLock.rakumod"}],"src":"zef","url":"/mods/zef/ReadWriteLock"}}}
    =end data
    =end React


ReadWriteLock


Raylib bindings for raku, using grammar to parse raylib.h and auto generate the bindings


=begin data
{"type":"page","file":"work_mods/zef/Raylib::Bindings/raylib-raku-0.0.1/README.md","sources":[],"node":{"type":"block","id":"JAR3NXuKK8EdE_ApUhgm1","margin":"","name":"root","content":[{"type":"block","id":"EsyTnCCDza56HMGhqOeR8","margin":"","level":2,"name":"head","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":15,"offset":14}},"content":["raylib-raku"]},{"type":"para","id":"_T0rqOmwgbmc9EVF7nigI","margin":"","location":{"start":{"line":3,"column":1,"offset":16},"end":{"line":3,"column":51,"offset":66}},"text":"text","content":[{"type":"block","id":"b_8KjQg0-oTfkg_VUmr9O","margin":"","name":"Image","config":[],"location":{"start":{"line":3,"column":1,"offset":16},"end":{"line":3,"column":51,"offset":66}},"content":[{"type":"image","src":"examples/camelia-rotating.gif","alt":"Rotating Camelia"}]}]},{"type":"para","id":"jpCMm1OSgLK_Ob0H_q46-","margin":"","location":{"start":{"line":5,"column":1,"offset":68},"end":{"line":5,"column":44,"offset":111}},"text":"text","content":[{"type":"block","id":"LwpcGhN0Rc4mccJk1ZsQw","margin":"","name":"Image","config":[],"location":{"start":{"line":5,"column":1,"offset":68},"end":{"line":5,"column":44,"offset":111}},"content":[{"type":"image","src":"examples/3dcamera-example.png","alt":"3d camera"}]}]},{"type":"para","id":"tEx0mJeaRw2ynVZMGBqHH","margin":"","location":{"start":{"line":7,"column":1,"offset":113},"end":{"line":8,"column":9,"offset":185}},"text":"text","content":["Autogenerated raylib-raku bindings, powered by raku grammar and\nactions."]},{"type":"block","id":"R_Ko0H2TMtbPmcr2v1yXe","margin":"","level":3,"name":"head","location":{"start":{"line":10,"column":1,"offset":187},"end":{"line":10,"column":18,"offset":204}},"content":["Prerequisite:"]},{"type":"para","id":"7NhNycASGtmQJN0sGmxxK","margin":"","location":{"start":{"line":11,"column":1,"offset":205},"end":{"line":12,"column":34,"offset":253}},"text":"text","content":["install raylib\n",{"meta":"https://github.com/raysan5/raylib","type":"fcode","name":"L","content":["https://github.com/raysan5/raylib"]}]},{"type":"block","id":"uP-kIFpL1uccFnmKtXS6N","margin":"","level":3,"name":"head","location":{"start":{"line":14,"column":1,"offset":255},"end":{"line":14,"column":38,"offset":292}},"content":["Generating bindings from raylib.h"]},{"type":"block","id":"nGrYT5sD3a2cJp_fHrQMs","margin":"","name":"code","config":[],"location":{"start":{"line":15,"column":1,"offset":293},"end":{"line":20,"column":4,"offset":487}},"content":[{"type":"verbatim","value":"git clone git@github.com:vushu/raylib-raku.git\ncd raylib-raku\nwget https://raw.githubusercontent.com/raysan5/raylib/master/src/raylib.h -P generator\nraku generator/generate-bindings.raku"}]},{"type":"block","id":"249kBpxISq_s4JINX2GBL","margin":"","level":3,"name":"head","location":{"start":{"line":22,"column":1,"offset":489},"end":{"line":22,"column":9,"offset":497}},"content":["Test"]},{"type":"block","id":"r3eZa_TlaFG1a8STbXXzq","margin":"","name":"code","config":[],"location":{"start":{"line":24,"column":1,"offset":499},"end":{"line":28,"column":4,"offset":599}},"content":[{"type":"verbatim","value":"raku examples/window.raku\nraku examples/rotating-butterfly.raku\nraku examples/3d-camera.raku"}]},{"type":"block","id":"Lb4PCMkyenDizomKlvJJo","margin":"","level":3,"name":"head","location":{"start":{"line":29,"column":1,"offset":600},"end":{"line":29,"column":22,"offset":621}},"content":["Install from repo"]},{"type":"block","id":"iF_XMWXhoekc5wWfnGXlr","margin":"","name":"code","config":[],"location":{"start":{"line":30,"column":1,"offset":622},"end":{"line":35,"column":4,"offset":744}},"content":[{"type":"verbatim","value":"git clone git@github.com:vushu/raylib-raku.git\ncd raylib-raku \nzef install .\nraku examples/rotating-butterfly.raku"}]},{"type":"block","id":"L6Dsl1cMPvdNa4__Zh-wo","margin":"","level":4,"name":"head","location":{"start":{"line":38,"column":1,"offset":747},"end":{"line":38,"column":14,"offset":760}},"content":["Missing:"]},{"type":"list","id":"XriD3Oa4OoSio81hXtfPD","margin":"","level":1,"list":"itemized","content":[{"type":"block","id":"fH2kQg3AcfAXNLgGDT76E","margin":"","name":"item","level":1,"location":{"start":{"line":39,"column":1,"offset":761},"end":{"line":39,"column":46,"offset":806}},"content":[{"type":"para","id":"_KR90bFx9hjkwzewxjBbc","margin":"","location":{"start":{"line":39,"column":3,"offset":763},"end":{"line":39,"column":46,"offset":806}},"text":"text","content":["raylib callbacks are yet to be implemented."]}]},{"type":"block","id":"HVviPal6Iwlv1JFXsSX7k","margin":"","name":"item","level":1,"location":{"start":{"line":40,"column":1,"offset":807},"end":{"line":40,"column":28,"offset":834}},"content":[{"type":"para","id":"4BNI2ujcD1RfeZS59UBKN","margin":"","location":{"start":{"line":40,"column":3,"offset":809},"end":{"line":40,"column":28,"offset":834}},"text":"text","content":["raylib predefined colors."]}]},{"type":"block","id":"57pB_5WgvKQcVpUI1BLlg","margin":"","name":"item","level":1,"location":{"start":{"line":41,"column":1,"offset":835},"end":{"line":41,"column":48,"offset":882}},"content":[{"type":"para","id":"yF5gpsJEHULCzu09I1Tb-","margin":"","location":{"start":{"line":41,"column":3,"offset":837},"end":{"line":41,"column":48,"offset":882}},"text":"text","content":["support for other platforms other than linux."]}]}]},{"type":"para","id":"Fk8Tu10owzjksm7lxiJVj","margin":"","location":{"start":{"line":44,"column":1,"offset":885},"end":{"line":44,"column":27,"offset":911}},"text":"text","content":[{"type":"fcode","name":"I","content":[{"type":"fcode","name":"B","content":["help is appreciated!"]}]}]}]},"publishUrl":"/mods/zef/Raylib::Bindings/raylib-raku-0.0.1/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"","auth":"zef:vushu","authors":["Dan Vu (vushu)"],"build-depends":[],"depends":[],"description":"Raylib bindings for raku, using grammar to parse raylib.h and auto generate the bindings","dist":"Raylib::Bindings:ver<0.0.1>:auth<zef:vushu>","license":"Artistic-2.0","name":"Raylib::Bindings","path":"R/AY/RAYLIB_BINDINGS/cfc1c2687131f7e89b35a5f87e058f4ca5dfc1a9.tar.gz","provides":{"Raylib::Bindings":"lib/Raylib/Bindings.rakumod"},"resources":[],"source-url":"https://github.com/vushu/raylib-raku.git","test-depends":[],"version":"0.0.1"},"files":[{"file":"work_mods/zef/Raylib::Bindings/raylib-raku-0.0.1/README.md","publishUrl":"/mods/zef/Raylib::Bindings/raylib-raku-0.0.1/README.md"}],"src":"zef","url":"/mods/zef/Raylib::Bindings"}}}
=end data


    =begin React :component<RenderItem>
    =begin data
    {"type":"page","file":"work_mods/zef/Raylib::Bindings/raylib-raku-0.0.1/README.md","sources":[],"node":{"type":"block","id":"JAR3NXuKK8EdE_ApUhgm1","margin":"","name":"root","content":[{"type":"block","id":"EsyTnCCDza56HMGhqOeR8","margin":"","level":2,"name":"head","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":15,"offset":14}},"content":["raylib-raku"]},{"type":"para","id":"_T0rqOmwgbmc9EVF7nigI","margin":"","location":{"start":{"line":3,"column":1,"offset":16},"end":{"line":3,"column":51,"offset":66}},"text":"text","content":[{"type":"block","id":"b_8KjQg0-oTfkg_VUmr9O","margin":"","name":"Image","config":[],"location":{"start":{"line":3,"column":1,"offset":16},"end":{"line":3,"column":51,"offset":66}},"content":[{"type":"image","src":"examples/camelia-rotating.gif","alt":"Rotating Camelia"}]}]},{"type":"para","id":"jpCMm1OSgLK_Ob0H_q46-","margin":"","location":{"start":{"line":5,"column":1,"offset":68},"end":{"line":5,"column":44,"offset":111}},"text":"text","content":[{"type":"block","id":"LwpcGhN0Rc4mccJk1ZsQw","margin":"","name":"Image","config":[],"location":{"start":{"line":5,"column":1,"offset":68},"end":{"line":5,"column":44,"offset":111}},"content":[{"type":"image","src":"examples/3dcamera-example.png","alt":"3d camera"}]}]},{"type":"para","id":"tEx0mJeaRw2ynVZMGBqHH","margin":"","location":{"start":{"line":7,"column":1,"offset":113},"end":{"line":8,"column":9,"offset":185}},"text":"text","content":["Autogenerated raylib-raku bindings, powered by raku grammar and\nactions."]},{"type":"block","id":"R_Ko0H2TMtbPmcr2v1yXe","margin":"","level":3,"name":"head","location":{"start":{"line":10,"column":1,"offset":187},"end":{"line":10,"column":18,"offset":204}},"content":["Prerequisite:"]},{"type":"para","id":"7NhNycASGtmQJN0sGmxxK","margin":"","location":{"start":{"line":11,"column":1,"offset":205},"end":{"line":12,"column":34,"offset":253}},"text":"text","content":["install raylib\n",{"meta":"https://github.com/raysan5/raylib","type":"fcode","name":"L","content":["https://github.com/raysan5/raylib"]}]},{"type":"block","id":"uP-kIFpL1uccFnmKtXS6N","margin":"","level":3,"name":"head","location":{"start":{"line":14,"column":1,"offset":255},"end":{"line":14,"column":38,"offset":292}},"content":["Generating bindings from raylib.h"]},{"type":"block","id":"nGrYT5sD3a2cJp_fHrQMs","margin":"","name":"code","config":[],"location":{"start":{"line":15,"column":1,"offset":293},"end":{"line":20,"column":4,"offset":487}},"content":[{"type":"verbatim","value":"git clone git@github.com:vushu/raylib-raku.git\ncd raylib-raku\nwget https://raw.githubusercontent.com/raysan5/raylib/master/src/raylib.h -P generator\nraku generator/generate-bindings.raku"}]},{"type":"block","id":"249kBpxISq_s4JINX2GBL","margin":"","level":3,"name":"head","location":{"start":{"line":22,"column":1,"offset":489},"end":{"line":22,"column":9,"offset":497}},"content":["Test"]},{"type":"block","id":"r3eZa_TlaFG1a8STbXXzq","margin":"","name":"code","config":[],"location":{"start":{"line":24,"column":1,"offset":499},"end":{"line":28,"column":4,"offset":599}},"content":[{"type":"verbatim","value":"raku examples/window.raku\nraku examples/rotating-butterfly.raku\nraku examples/3d-camera.raku"}]},{"type":"block","id":"Lb4PCMkyenDizomKlvJJo","margin":"","level":3,"name":"head","location":{"start":{"line":29,"column":1,"offset":600},"end":{"line":29,"column":22,"offset":621}},"content":["Install from repo"]},{"type":"block","id":"iF_XMWXhoekc5wWfnGXlr","margin":"","name":"code","config":[],"location":{"start":{"line":30,"column":1,"offset":622},"end":{"line":35,"column":4,"offset":744}},"content":[{"type":"verbatim","value":"git clone git@github.com:vushu/raylib-raku.git\ncd raylib-raku \nzef install .\nraku examples/rotating-butterfly.raku"}]},{"type":"block","id":"L6Dsl1cMPvdNa4__Zh-wo","margin":"","level":4,"name":"head","location":{"start":{"line":38,"column":1,"offset":747},"end":{"line":38,"column":14,"offset":760}},"content":["Missing:"]},{"type":"list","id":"XriD3Oa4OoSio81hXtfPD","margin":"","level":1,"list":"itemized","content":[{"type":"block","id":"fH2kQg3AcfAXNLgGDT76E","margin":"","name":"item","level":1,"location":{"start":{"line":39,"column":1,"offset":761},"end":{"line":39,"column":46,"offset":806}},"content":[{"type":"para","id":"_KR90bFx9hjkwzewxjBbc","margin":"","location":{"start":{"line":39,"column":3,"offset":763},"end":{"line":39,"column":46,"offset":806}},"text":"text","content":["raylib callbacks are yet to be implemented."]}]},{"type":"block","id":"HVviPal6Iwlv1JFXsSX7k","margin":"","name":"item","level":1,"location":{"start":{"line":40,"column":1,"offset":807},"end":{"line":40,"column":28,"offset":834}},"content":[{"type":"para","id":"4BNI2ujcD1RfeZS59UBKN","margin":"","location":{"start":{"line":40,"column":3,"offset":809},"end":{"line":40,"column":28,"offset":834}},"text":"text","content":["raylib predefined colors."]}]},{"type":"block","id":"57pB_5WgvKQcVpUI1BLlg","margin":"","name":"item","level":1,"location":{"start":{"line":41,"column":1,"offset":835},"end":{"line":41,"column":48,"offset":882}},"content":[{"type":"para","id":"yF5gpsJEHULCzu09I1Tb-","margin":"","location":{"start":{"line":41,"column":3,"offset":837},"end":{"line":41,"column":48,"offset":882}},"text":"text","content":["support for other platforms other than linux."]}]}]},{"type":"para","id":"Fk8Tu10owzjksm7lxiJVj","margin":"","location":{"start":{"line":44,"column":1,"offset":885},"end":{"line":44,"column":27,"offset":911}},"text":"text","content":[{"type":"fcode","name":"I","content":[{"type":"fcode","name":"B","content":["help is appreciated!"]}]}]}]},"publishUrl":"/mods/zef/Raylib::Bindings/raylib-raku-0.0.1/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"","auth":"zef:vushu","authors":["Dan Vu (vushu)"],"build-depends":[],"depends":[],"description":"Raylib bindings for raku, using grammar to parse raylib.h and auto generate the bindings","dist":"Raylib::Bindings:ver<0.0.1>:auth<zef:vushu>","license":"Artistic-2.0","name":"Raylib::Bindings","path":"R/AY/RAYLIB_BINDINGS/cfc1c2687131f7e89b35a5f87e058f4ca5dfc1a9.tar.gz","provides":{"Raylib::Bindings":"lib/Raylib/Bindings.rakumod"},"resources":[],"source-url":"https://github.com/vushu/raylib-raku.git","test-depends":[],"version":"0.0.1"},"files":[{"file":"work_mods/zef/Raylib::Bindings/raylib-raku-0.0.1/README.md","publishUrl":"/mods/zef/Raylib::Bindings/raylib-raku-0.0.1/README.md"}],"src":"zef","url":"/mods/zef/Raylib::Bindings"}}}
    =end data
    =end React


Raylib::Bindings


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


Readline

Readline

Note: This README will soon be updated based on new development priorities

Installation

Usage

Testing

Author

License

Readline v0.1.7

Authors

License

Dependencies

Test Dependencies

Provides

Documentation