TITLE

Provide an interface to the monit monitoring daemon


SUBTITLE

data

=begin data
{"type":"page","file":"work_mods/zef/Monitor::Monit/Monitor-Monit-0.0.5/README.md","sources":[],"node":{"type":"block","id":"c52LvvOCeeLeMc6lPw376","margin":"","name":"root","content":[{"type":"block","id":"6lOoW8czTceCBm04zXGCF","margin":"","level":1,"name":"head","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":17,"offset":16}},"content":["Monitor::Monit"]},{"type":"para","id":"xmPx00I5fvrtYLunB08HY","margin":"","location":{"start":{"line":3,"column":1,"offset":18},"end":{"line":3,"column":52,"offset":69}},"text":"text","content":["Provide an interface to the monit monitoring daemon"]},{"type":"para","id":"PPucqjh7szA5TJqPE1dEF","margin":"","location":{"start":{"line":5,"column":1,"offset":71},"end":{"line":5,"column":87,"offset":157}},"text":"text","content":[{"type":"block","id":"ZGOS-oMoq7midG9Lsq4wj","margin":"","name":"Image","config":[],"location":{"start":{"line":5,"column":1,"offset":71},"end":{"line":5,"column":87,"offset":157}},"content":[{"type":"image","src":"https://github.com/jonathanstowe/Monitor-Monit/workflows/CI/badge.svg","alt":"Build Status"}]}]},{"type":"block","id":"a8UHVTt-UtDgqg_40-PkD","margin":"","level":2,"name":"head","location":{"start":{"line":7,"column":1,"offset":159},"end":{"line":7,"column":12,"offset":170}},"content":["Synopsis"]},{"type":"block","id":"DLBimweWB2yZUeVEeZh9n","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":9,"column":1,"offset":172},"end":{"line":20,"column":4,"offset":343}},"content":[{"type":"verbatim","value":"\nuse Monitor::Monit;\n\n# use default settings\nmy $mon = Monitor::Monit.new;\n\nfor $mon.service -> $service {\n\tsay $service.name, \" is \", $service.status-name;\n}\n"}]},{"type":"block","id":"kh1N57_mo5UjDJ0j9rLB2","margin":"","level":2,"name":"head","location":{"start":{"line":22,"column":1,"offset":345},"end":{"line":22,"column":15,"offset":359}},"content":["Description"]},{"type":"para","id":"HB3ohGzo5Bl5Chbvslwej","margin":"","location":{"start":{"line":24,"column":1,"offset":361},"end":{"line":25,"column":36,"offset":461}},"text":"text","content":["Monit is a lightweight, relatively simple and widely used system\nand application monitoring service."]},{"type":"para","id":"WK5TCEQpm8MK8g-FLmle8","margin":"","location":{"start":{"line":27,"column":1,"offset":463},"end":{"line":27,"column":57,"offset":519}},"text":"text","content":["This provides a mechanism to interact with its http api."]},{"type":"block","id":"5W91Z_wWghkAcvDux6y_u","margin":"","level":2,"name":"head","location":{"start":{"line":29,"column":1,"offset":521},"end":{"line":29,"column":16,"offset":536}},"content":["Installation"]},{"type":"para","id":"3KWFfE1GFczw4Z1fxw-r5","margin":"","location":{"start":{"line":31,"column":1,"offset":538},"end":{"line":32,"column":50,"offset":659}},"text":"text","content":["In order for this to be useful you will need to have 'monit' installed,\nmost Linux distributions provide it as a package."]},{"type":"para","id":"hEdTR8Svrrnnbe--aqmzZ","margin":"","location":{"start":{"line":34,"column":1,"offset":661},"end":{"line":37,"column":17,"offset":888}},"text":"text","content":["If you set the enviromment variable ",{"type":"fcode","name":"C","content":["MONIT_TEST_LIVE"]}," the tests will\nattempt to connect to a monit daemon on the local host with the default\nport and credentials, if there is no connection then the online tests\nwill be skipped."]},{"type":"para","id":"dHkOP81Zh5zunGvAf4BiN","margin":"","location":{"start":{"line":39,"column":1,"offset":890},"end":{"line":41,"column":72,"offset":1106}},"text":"text","content":["By default the monit daemon will be configured to only listen for local\nconnections on the loopback interface, if you wish to work with a remote\nmonit daemon you may need to alter the monit configuration accordingly."]},{"type":"para","id":"0kh6TR4XEsaFGjhTRztwD","margin":"","location":{"start":{"line":43,"column":1,"offset":1108},"end":{"line":44,"column":69,"offset":1250}},"text":"text","content":["You can provide the details for the running monit daemon you want to test\nwith by setting some environment variables before running the tests:"]},{"type":"list","id":"YAdmgZgi5BbgJyld_-6dr","margin":"","level":1,"list":"itemized","content":[{"type":"block","id":"zQwHo0oaQVLgcSuPKnLQ4","margin":"","name":"item","level":1,"location":{"start":{"line":46,"column":1,"offset":1252},"end":{"line":46,"column":66,"offset":1317}},"content":[{"type":"para","id":"jCjX_2uOhgMMDs6VAgqBy","margin":"","location":{"start":{"line":46,"column":3,"offset":1254},"end":{"line":46,"column":66,"offset":1317}},"text":"text","content":[{"type":"fcode","name":"C","content":["MONIT_TEST_HOST"]}," - the hostname on which the daemon is running"]}]},{"type":"block","id":"aTG5Mf4mz63AzKBnbsrDu","margin":"","name":"item","level":1,"location":{"start":{"line":47,"column":1,"offset":1318},"end":{"line":47,"column":66,"offset":1383}},"content":[{"type":"para","id":"5AIqX9fm3gA3nNxvu-Fo0","margin":"","location":{"start":{"line":47,"column":3,"offset":1320},"end":{"line":47,"column":66,"offset":1383}},"text":"text","content":[{"type":"fcode","name":"C","content":["MONIT_TEST_PORT"]}," - the port the daemon is using (default 2812)"]}]},{"type":"block","id":"eAArrPGH3esDZkb3GC4Yu","margin":"","name":"item","level":1,"location":{"start":{"line":48,"column":1,"offset":1384},"end":{"line":48,"column":69,"offset":1452}},"content":[{"type":"para","id":"V2cs7DiZsaHMbpbjKu1Rl","margin":"","location":{"start":{"line":48,"column":3,"offset":1386},"end":{"line":48,"column":69,"offset":1452}},"text":"text","content":[{"type":"fcode","name":"C","content":["MONIT_TEST_USER"]}," - the username to authenticate (default ",{"type":"fcode","name":"C","content":["admin"]},")"]}]},{"type":"block","id":"6HACuQSqwg6jDU-GVneGf","margin":"","name":"item","level":1,"location":{"start":{"line":49,"column":1,"offset":1453},"end":{"line":49,"column":69,"offset":1521}},"content":[{"type":"para","id":"tbGf4IQPg2fF4Bl3pqs82","margin":"","location":{"start":{"line":49,"column":3,"offset":1455},"end":{"line":49,"column":69,"offset":1521}},"text":"text","content":[{"type":"fcode","name":"C","content":["MONIT_TEST_PASS"]}," - the password to authenticate (default ",{"type":"fcode","name":"C","content":["monit"]},")"]}]}]},{"type":"para","id":"Dj7iVcRX0wCkPQ9bjgvF9","margin":"","location":{"start":{"line":51,"column":1,"offset":1523},"end":{"line":53,"column":40,"offset":1716}},"text":"text","content":["Additionally, if the environment variable ",{"type":"fcode","name":"C","content":["MONIT_TEST_CONTROL"]}," is set to\na true value, the tests will attempt to control the services, you probably don't\nwant to do this on a production system."]},{"type":"para","id":"j9iSzHWl9__JtEHnfLExW","margin":"","location":{"start":{"line":55,"column":1,"offset":1718},"end":{"line":55,"column":96,"offset":1813}},"text":"text","content":["Assuming you have a working Rakudo installation then you should be able to install with ",{"type":"fcode","name":"C","content":["zef"]}," :"]},{"type":"para","id":"QzjKfg0tPpGQtCUSFHzyZ","margin":"","location":{"start":{"line":57,"column":1,"offset":1815},"end":{"line":57,"column":27,"offset":1841}},"text":"text","content":["zef install Monitor::Monit"]},{"type":"block","id":"G_Wy4BISYtTVuFis3yIlN","margin":"","level":2,"name":"head","location":{"start":{"line":59,"column":1,"offset":1843},"end":{"line":59,"column":11,"offset":1853}},"content":["Support"]},{"type":"para","id":"-Mn-RBRoRJRLRUTeEEp-c","margin":"","location":{"start":{"line":61,"column":1,"offset":1855},"end":{"line":63,"column":89,"offset":2092}},"text":"text","content":["I've only tested this against my particular configuration of monit so it is\nentirely possible that I have missed something that is important to you,\nplease feel to make suggestions at ",{"meta":"https://github.com/jonathanstowe/Monitor-Monit/issues","type":"fcode","name":"L","content":["https://github.com/jonathanstowe/Monitor-Monit/issues"]}]},{"type":"para","id":"idKCA6kKSiON88W6qcicy","margin":"","location":{"start":{"line":65,"column":1,"offset":2094},"end":{"line":67,"column":41,"offset":2285}},"text":"text","content":["It is possible that it may not work properly with certain older versions of\nmonit though I can't pinpoint which versions and it's difficult to test so\nany help with that would be appreciated."]},{"type":"block","id":"r55oAIKuDN-Ou8moNb5Rc","margin":"","level":2,"name":"head","location":{"start":{"line":69,"column":1,"offset":2287},"end":{"line":69,"column":25,"offset":2311}},"content":["Copyright and Licence"]},{"type":"para","id":"wEgcr_KW6O5aGCWjkoA56","margin":"","location":{"start":{"line":71,"column":1,"offset":2313},"end":{"line":71,"column":23,"offset":2335}},"text":"text","content":["This is free software."]},{"type":"para","id":"fSCr3ej39ZRnubbutGuat","margin":"","location":{"start":{"line":73,"column":1,"offset":2337},"end":{"line":73,"column":58,"offset":2394}},"text":"text","content":["Please see the ",{"meta":"LICENCE","type":"fcode","name":"L","content":["LICENCE"]}," file in this directory."]},{"type":"para","id":"1sTu7VwVhOIMWwhAw5nWn","margin":"","location":{"start":{"line":75,"column":1,"offset":2396},"end":{"line":75,"column":29,"offset":2424}},"text":"text","content":["© Jonathan Stowe 2016 - 2021"]}]},"publishUrl":"/mods/zef/Monitor::Monit/Monitor-Monit-0.0.5/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"1.0","auth":"zef:jonathanstowe","authors":["Jonathan Stowe <jns+gh@gellyfish.co.uk>"],"build-depends":[],"depends":["HTTP::UserAgent","URI::Template","XML::Class"],"description":"Provide an interface to the monit monitoring daemon","dist":"Monitor::Monit:ver<0.0.5>:auth<zef:jonathanstowe>","license":"Artistic-2.0","meta-version":"1","name":"Monitor::Monit","path":"M/ON/MONITOR_MONIT/19ede26fcfe97d385588a11ac6127b5e729fa327.tar.gz","provides":{"Monitor::Monit":"lib/Monitor/Monit.pm"},"raku":"6.*","resources":[],"source-url":"https://github.com/jonathanstowe/Monitor-Monit.git","support":{"bugtracker":"https://github.com/jonathanstowe/Monitor-Monit/issues","source":"https://github.com/jonathanstowe/Monitor-Monit.git"},"tags":["monitor","api","system"],"test-depends":["Test","CheckSocket"],"version":"0.0.5"},"files":[{"file":"work_mods/zef/Monitor::Monit/Monitor-Monit-0.0.5/README.md","publishUrl":"/mods/zef/Monitor::Monit/Monitor-Monit-0.0.5/README.md"},{"file":"work_mods/zef/Monitor::Monit/Monitor-Monit-0.0.5/lib/Monitor/Monit.pm","publishUrl":"/mods/zef/Monitor::Monit/Monitor-Monit-0.0.5/lib/Monitor/Monit.pm"}],"src":"zef","url":"/mods/zef/Monitor::Monit"}}}
=end data


React

    =begin React :component<RenderItem>
    =begin data
    {"type":"page","file":"work_mods/zef/Monitor::Monit/Monitor-Monit-0.0.5/README.md","sources":[],"node":{"type":"block","id":"c52LvvOCeeLeMc6lPw376","margin":"","name":"root","content":[{"type":"block","id":"6lOoW8czTceCBm04zXGCF","margin":"","level":1,"name":"head","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":17,"offset":16}},"content":["Monitor::Monit"]},{"type":"para","id":"xmPx00I5fvrtYLunB08HY","margin":"","location":{"start":{"line":3,"column":1,"offset":18},"end":{"line":3,"column":52,"offset":69}},"text":"text","content":["Provide an interface to the monit monitoring daemon"]},{"type":"para","id":"PPucqjh7szA5TJqPE1dEF","margin":"","location":{"start":{"line":5,"column":1,"offset":71},"end":{"line":5,"column":87,"offset":157}},"text":"text","content":[{"type":"block","id":"ZGOS-oMoq7midG9Lsq4wj","margin":"","name":"Image","config":[],"location":{"start":{"line":5,"column":1,"offset":71},"end":{"line":5,"column":87,"offset":157}},"content":[{"type":"image","src":"https://github.com/jonathanstowe/Monitor-Monit/workflows/CI/badge.svg","alt":"Build Status"}]}]},{"type":"block","id":"a8UHVTt-UtDgqg_40-PkD","margin":"","level":2,"name":"head","location":{"start":{"line":7,"column":1,"offset":159},"end":{"line":7,"column":12,"offset":170}},"content":["Synopsis"]},{"type":"block","id":"DLBimweWB2yZUeVEeZh9n","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":9,"column":1,"offset":172},"end":{"line":20,"column":4,"offset":343}},"content":[{"type":"verbatim","value":"\nuse Monitor::Monit;\n\n# use default settings\nmy $mon = Monitor::Monit.new;\n\nfor $mon.service -> $service {\n\tsay $service.name, \" is \", $service.status-name;\n}\n"}]},{"type":"block","id":"kh1N57_mo5UjDJ0j9rLB2","margin":"","level":2,"name":"head","location":{"start":{"line":22,"column":1,"offset":345},"end":{"line":22,"column":15,"offset":359}},"content":["Description"]},{"type":"para","id":"HB3ohGzo5Bl5Chbvslwej","margin":"","location":{"start":{"line":24,"column":1,"offset":361},"end":{"line":25,"column":36,"offset":461}},"text":"text","content":["Monit is a lightweight, relatively simple and widely used system\nand application monitoring service."]},{"type":"para","id":"WK5TCEQpm8MK8g-FLmle8","margin":"","location":{"start":{"line":27,"column":1,"offset":463},"end":{"line":27,"column":57,"offset":519}},"text":"text","content":["This provides a mechanism to interact with its http api."]},{"type":"block","id":"5W91Z_wWghkAcvDux6y_u","margin":"","level":2,"name":"head","location":{"start":{"line":29,"column":1,"offset":521},"end":{"line":29,"column":16,"offset":536}},"content":["Installation"]},{"type":"para","id":"3KWFfE1GFczw4Z1fxw-r5","margin":"","location":{"start":{"line":31,"column":1,"offset":538},"end":{"line":32,"column":50,"offset":659}},"text":"text","content":["In order for this to be useful you will need to have 'monit' installed,\nmost Linux distributions provide it as a package."]},{"type":"para","id":"hEdTR8Svrrnnbe--aqmzZ","margin":"","location":{"start":{"line":34,"column":1,"offset":661},"end":{"line":37,"column":17,"offset":888}},"text":"text","content":["If you set the enviromment variable ",{"type":"fcode","name":"C","content":["MONIT_TEST_LIVE"]}," the tests will\nattempt to connect to a monit daemon on the local host with the default\nport and credentials, if there is no connection then the online tests\nwill be skipped."]},{"type":"para","id":"dHkOP81Zh5zunGvAf4BiN","margin":"","location":{"start":{"line":39,"column":1,"offset":890},"end":{"line":41,"column":72,"offset":1106}},"text":"text","content":["By default the monit daemon will be configured to only listen for local\nconnections on the loopback interface, if you wish to work with a remote\nmonit daemon you may need to alter the monit configuration accordingly."]},{"type":"para","id":"0kh6TR4XEsaFGjhTRztwD","margin":"","location":{"start":{"line":43,"column":1,"offset":1108},"end":{"line":44,"column":69,"offset":1250}},"text":"text","content":["You can provide the details for the running monit daemon you want to test\nwith by setting some environment variables before running the tests:"]},{"type":"list","id":"YAdmgZgi5BbgJyld_-6dr","margin":"","level":1,"list":"itemized","content":[{"type":"block","id":"zQwHo0oaQVLgcSuPKnLQ4","margin":"","name":"item","level":1,"location":{"start":{"line":46,"column":1,"offset":1252},"end":{"line":46,"column":66,"offset":1317}},"content":[{"type":"para","id":"jCjX_2uOhgMMDs6VAgqBy","margin":"","location":{"start":{"line":46,"column":3,"offset":1254},"end":{"line":46,"column":66,"offset":1317}},"text":"text","content":[{"type":"fcode","name":"C","content":["MONIT_TEST_HOST"]}," - the hostname on which the daemon is running"]}]},{"type":"block","id":"aTG5Mf4mz63AzKBnbsrDu","margin":"","name":"item","level":1,"location":{"start":{"line":47,"column":1,"offset":1318},"end":{"line":47,"column":66,"offset":1383}},"content":[{"type":"para","id":"5AIqX9fm3gA3nNxvu-Fo0","margin":"","location":{"start":{"line":47,"column":3,"offset":1320},"end":{"line":47,"column":66,"offset":1383}},"text":"text","content":[{"type":"fcode","name":"C","content":["MONIT_TEST_PORT"]}," - the port the daemon is using (default 2812)"]}]},{"type":"block","id":"eAArrPGH3esDZkb3GC4Yu","margin":"","name":"item","level":1,"location":{"start":{"line":48,"column":1,"offset":1384},"end":{"line":48,"column":69,"offset":1452}},"content":[{"type":"para","id":"V2cs7DiZsaHMbpbjKu1Rl","margin":"","location":{"start":{"line":48,"column":3,"offset":1386},"end":{"line":48,"column":69,"offset":1452}},"text":"text","content":[{"type":"fcode","name":"C","content":["MONIT_TEST_USER"]}," - the username to authenticate (default ",{"type":"fcode","name":"C","content":["admin"]},")"]}]},{"type":"block","id":"6HACuQSqwg6jDU-GVneGf","margin":"","name":"item","level":1,"location":{"start":{"line":49,"column":1,"offset":1453},"end":{"line":49,"column":69,"offset":1521}},"content":[{"type":"para","id":"tbGf4IQPg2fF4Bl3pqs82","margin":"","location":{"start":{"line":49,"column":3,"offset":1455},"end":{"line":49,"column":69,"offset":1521}},"text":"text","content":[{"type":"fcode","name":"C","content":["MONIT_TEST_PASS"]}," - the password to authenticate (default ",{"type":"fcode","name":"C","content":["monit"]},")"]}]}]},{"type":"para","id":"Dj7iVcRX0wCkPQ9bjgvF9","margin":"","location":{"start":{"line":51,"column":1,"offset":1523},"end":{"line":53,"column":40,"offset":1716}},"text":"text","content":["Additionally, if the environment variable ",{"type":"fcode","name":"C","content":["MONIT_TEST_CONTROL"]}," is set to\na true value, the tests will attempt to control the services, you probably don't\nwant to do this on a production system."]},{"type":"para","id":"j9iSzHWl9__JtEHnfLExW","margin":"","location":{"start":{"line":55,"column":1,"offset":1718},"end":{"line":55,"column":96,"offset":1813}},"text":"text","content":["Assuming you have a working Rakudo installation then you should be able to install with ",{"type":"fcode","name":"C","content":["zef"]}," :"]},{"type":"para","id":"QzjKfg0tPpGQtCUSFHzyZ","margin":"","location":{"start":{"line":57,"column":1,"offset":1815},"end":{"line":57,"column":27,"offset":1841}},"text":"text","content":["zef install Monitor::Monit"]},{"type":"block","id":"G_Wy4BISYtTVuFis3yIlN","margin":"","level":2,"name":"head","location":{"start":{"line":59,"column":1,"offset":1843},"end":{"line":59,"column":11,"offset":1853}},"content":["Support"]},{"type":"para","id":"-Mn-RBRoRJRLRUTeEEp-c","margin":"","location":{"start":{"line":61,"column":1,"offset":1855},"end":{"line":63,"column":89,"offset":2092}},"text":"text","content":["I've only tested this against my particular configuration of monit so it is\nentirely possible that I have missed something that is important to you,\nplease feel to make suggestions at ",{"meta":"https://github.com/jonathanstowe/Monitor-Monit/issues","type":"fcode","name":"L","content":["https://github.com/jonathanstowe/Monitor-Monit/issues"]}]},{"type":"para","id":"idKCA6kKSiON88W6qcicy","margin":"","location":{"start":{"line":65,"column":1,"offset":2094},"end":{"line":67,"column":41,"offset":2285}},"text":"text","content":["It is possible that it may not work properly with certain older versions of\nmonit though I can't pinpoint which versions and it's difficult to test so\nany help with that would be appreciated."]},{"type":"block","id":"r55oAIKuDN-Ou8moNb5Rc","margin":"","level":2,"name":"head","location":{"start":{"line":69,"column":1,"offset":2287},"end":{"line":69,"column":25,"offset":2311}},"content":["Copyright and Licence"]},{"type":"para","id":"wEgcr_KW6O5aGCWjkoA56","margin":"","location":{"start":{"line":71,"column":1,"offset":2313},"end":{"line":71,"column":23,"offset":2335}},"text":"text","content":["This is free software."]},{"type":"para","id":"fSCr3ej39ZRnubbutGuat","margin":"","location":{"start":{"line":73,"column":1,"offset":2337},"end":{"line":73,"column":58,"offset":2394}},"text":"text","content":["Please see the ",{"meta":"LICENCE","type":"fcode","name":"L","content":["LICENCE"]}," file in this directory."]},{"type":"para","id":"1sTu7VwVhOIMWwhAw5nWn","margin":"","location":{"start":{"line":75,"column":1,"offset":2396},"end":{"line":75,"column":29,"offset":2424}},"text":"text","content":["© Jonathan Stowe 2016 - 2021"]}]},"publishUrl":"/mods/zef/Monitor::Monit/Monitor-Monit-0.0.5/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"1.0","auth":"zef:jonathanstowe","authors":["Jonathan Stowe <jns+gh@gellyfish.co.uk>"],"build-depends":[],"depends":["HTTP::UserAgent","URI::Template","XML::Class"],"description":"Provide an interface to the monit monitoring daemon","dist":"Monitor::Monit:ver<0.0.5>:auth<zef:jonathanstowe>","license":"Artistic-2.0","meta-version":"1","name":"Monitor::Monit","path":"M/ON/MONITOR_MONIT/19ede26fcfe97d385588a11ac6127b5e729fa327.tar.gz","provides":{"Monitor::Monit":"lib/Monitor/Monit.pm"},"raku":"6.*","resources":[],"source-url":"https://github.com/jonathanstowe/Monitor-Monit.git","support":{"bugtracker":"https://github.com/jonathanstowe/Monitor-Monit/issues","source":"https://github.com/jonathanstowe/Monitor-Monit.git"},"tags":["monitor","api","system"],"test-depends":["Test","CheckSocket"],"version":"0.0.5"},"files":[{"file":"work_mods/zef/Monitor::Monit/Monitor-Monit-0.0.5/README.md","publishUrl":"/mods/zef/Monitor::Monit/Monitor-Monit-0.0.5/README.md"},{"file":"work_mods/zef/Monitor::Monit/Monitor-Monit-0.0.5/lib/Monitor/Monit.pm","publishUrl":"/mods/zef/Monitor::Monit/Monitor-Monit-0.0.5/lib/Monitor/Monit.pm"}],"src":"zef","url":"/mods/zef/Monitor::Monit"}}}
    =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

Monitor::Monit


=begin data
{"type":"page","file":"work_mods/zef/MQ::Posix/MQ-Posix-0.0.4/README.md","sources":[],"node":{"type":"block","id":"zTJ_BpMgC8Qlj07nfqJaK","margin":"","name":"root","content":[{"type":"block","id":"peT6iLG_SYyq6TiEv_RKr","margin":"","level":1,"name":"head","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":12,"offset":11}},"content":["MQ::Posix"]},{"type":"para","id":"CmLH-NX-cyU9IgWE1LVoB","margin":"","location":{"start":{"line":3,"column":1,"offset":13},"end":{"line":3,"column":38,"offset":50}},"text":"text","content":["Raku binding for POSIX message queues"]},{"type":"para","id":"WzBB4jSlq-1VOs4oBrn9N","margin":"","location":{"start":{"line":5,"column":1,"offset":52},"end":{"line":5,"column":82,"offset":133}},"text":"text","content":[{"type":"block","id":"hPs3b1qRDHRnnb2jOPv6K","margin":"","name":"Image","config":[],"location":{"start":{"line":5,"column":1,"offset":52},"end":{"line":5,"column":82,"offset":133}},"content":[{"type":"image","src":"https://github.com/jonathanstowe/MQ-Posix/workflows/CI/badge.svg","alt":"Build Status"}]}]},{"type":"block","id":"6Qqx_UP5y_K590GoHuu0R","margin":"","level":2,"name":"head","location":{"start":{"line":7,"column":1,"offset":135},"end":{"line":7,"column":12,"offset":146}},"content":["Synopsis"]},{"type":"block","id":"81MJMiiwPucoCDnlF4mV2","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":9,"column":1,"offset":148},"end":{"line":25,"column":4,"offset":413}},"content":[{"type":"verbatim","value":"\nuse MQ::Posix;\n\nmy $queue = MQ::Posix.new(name => 'test-queue', :create, :r );\n\nreact {\n    whenever $queue.Supply -> $buf {\n        say $buf.decode;\n    }\n    whenever signal(SIGINT) {\n        $queue.close;\n        $queue.unlink;\n        done;\n    }\n}"}]},{"type":"para","id":"Dlfu-ibbiAlvCS1BKmqTf","margin":"","location":{"start":{"line":27,"column":1,"offset":415},"end":{"line":27,"column":30,"offset":444}},"text":"text","content":["And in some separate process:"]},{"type":"block","id":"1_Rorx5sBJu_O3XaIFs10","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":29,"column":1,"offset":446},"end":{"line":39,"column":4,"offset":610}},"content":[{"type":"verbatim","value":"\nuse MQ::Posix;\n\nmy $queue = MQ::Posix.new(name => 'test-queue', :create, :w );\n\nawait $queue.send(\"some test message\", priority => 10);\n\n$queue.close;\n"}]},{"type":"block","id":"sr8dZdMH8EX3wwyRHWRn6","margin":"","level":2,"name":"head","location":{"start":{"line":41,"column":1,"offset":612},"end":{"line":41,"column":15,"offset":626}},"content":["Description"]},{"type":"para","id":"bQQnRKDm4z9YUmwzuQ0Wq","margin":"","location":{"start":{"line":43,"column":1,"offset":628},"end":{"line":44,"column":29,"offset":730}},"text":"text","content":["POSIX message queues offer a mechanism for processes to reliably exchange\ndata in the form of messages"]},{"type":"para","id":"ij5XYbUXwvsdx6KRE5MgD","margin":"","location":{"start":{"line":46,"column":1,"offset":732},"end":{"line":48,"column":14,"offset":899}},"text":"text","content":["The messages are presented as a priority ordered queue with higher priority\nmessages being delivered first and messages of equal priority being delivered\nin age order."]},{"type":"para","id":"VDl_0niNSyJcqNDaf2boj","margin":"","location":{"start":{"line":50,"column":1,"offset":901},"end":{"line":52,"column":16,"offset":1074}},"text":"text","content":["The mechanism is simple, having no provision for message metadata and so forth\nand whilst reliable, unread messages do not persist beyond the lifetime of the\nrunning kernel."]},{"type":"block","id":"2guHORQPvSujkiGsO8QIG","margin":"","level":2,"name":"head","location":{"start":{"line":54,"column":1,"offset":1076},"end":{"line":54,"column":11,"offset":1086}},"content":["Install"]},{"type":"para","id":"r8j0zh3vsHZZXbvYFlUO0","margin":"","location":{"start":{"line":56,"column":1,"offset":1088},"end":{"line":56,"column":93,"offset":1180}},"text":"text","content":["If you have a working installation of Rakudo you should be able to install this with ",{"type":"fcode","name":"I","content":["zef"]}," :"]},{"type":"block","id":"uWAah7TrrfG3LBvXuaqJU","margin":"","name":"code","config":[],"location":{"start":{"line":58,"column":1,"offset":1182},"end":{"line":62,"column":18,"offset":1255}},"content":[{"type":"verbatim","value":"zef install MQ::Posix\n\n# or from a local clone\n\nzef install ."}]},{"type":"block","id":"6svaRmMzhScoYsMzM-8h-","margin":"","level":2,"name":"head","location":{"start":{"line":64,"column":1,"offset":1257},"end":{"line":64,"column":11,"offset":1267}},"content":["Support"]},{"type":"para","id":"M28zUJvPMghX0cDVNQDaM","margin":"","location":{"start":{"line":66,"column":1,"offset":1269},"end":{"line":73,"column":36,"offset":1794}},"text":"text","content":["This should work on any operating system that has good modern POSIX\nsupport, however some systems may not enable kernel message queues by\nthe default and you may need some kernel build configuration to do so.\nAlso the limits and defaults for number of messages and maximum message\nsizes are set in different ways as this is not explicitly stated in the\nstandard, on Linux, for example, you can use the ",{"type":"fcode","name":"C","content":["sysctl"]}," interface\nto control these parameters, on other systems you may need to supply\nthem as kernel build configuration."]},{"type":"para","id":"Ap1LGYSLpVQ17ySSp4A7W","margin":"","location":{"start":{"line":75,"column":1,"offset":1796},"end":{"line":75,"column":149,"offset":1944}},"text":"text","content":["If this doesn't work as expected or you have new features that you would like to see please post in ",{"meta":"https://github.com/jonathanstowe/MQ-Posix/issues","type":"fcode","name":"L","content":["https://github.com/jonathanstowe/MQ-Posix/issues"]}]},{"type":"block","id":"W2rqkUzc647PW0kC_Gi0F","margin":"","level":2,"name":"head","location":{"start":{"line":77,"column":1,"offset":1946},"end":{"line":77,"column":23,"offset":1968}},"content":["Licence & Copyright"]},{"type":"para","id":"KIQ9EH6xJYXJ6YyAAe7fP","margin":"","location":{"start":{"line":79,"column":1,"offset":1970},"end":{"line":79,"column":70,"offset":2039}},"text":"text","content":["This is free software, please see the ",{"meta":"LICENCE","type":"fcode","name":"L","content":["LICENCE"]}," for details."]},{"type":"para","id":"jQkib8wTLaUavD8G9pImf","margin":"","location":{"start":{"line":81,"column":1,"offset":2041},"end":{"line":81,"column":29,"offset":2069}},"text":"text","content":["© Jonathan Stowe 2017 - 2021"]}]},"publishUrl":"/mods/zef/MQ::Posix/MQ-Posix-0.0.4/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"1.0","auth":"zef:jonathanstowe","authors":["Jonathan Stowe <jns+gh@gellyfish.co.uk>"],"build-depends":[],"depends":["NativeHelpers::Array"],"description":"binding for POSIX message queues","dist":"MQ::Posix:ver<0.0.4>:auth<zef:jonathanstowe>","license":"Artistic-2.0","meta-version":"1","name":"MQ::Posix","path":"M/Q_/MQ_POSIX/3aab33518a405bb8b699518eed141de6ea1043c3.tar.gz","provides":{"MQ::Posix":"lib/MQ/Posix.pm"},"raku":"6.*","resources":[],"source-url":"https://github.com/jonathanstowe/MQ-Posix.git","support":{"bugtracker":"https://github.com/jonathanstowe/MQ-Posix/issues","source":"https://github.com/jonathanstowe/MQ-Posix.git"},"tags":["posix","IPC","MQ"],"test-depends":["Test"],"version":"0.0.4"},"files":[{"file":"work_mods/zef/MQ::Posix/MQ-Posix-0.0.4/README.md","publishUrl":"/mods/zef/MQ::Posix/MQ-Posix-0.0.4/README.md"},{"file":"work_mods/zef/MQ::Posix/MQ-Posix-0.0.4/Documentation.md","publishUrl":"/mods/zef/MQ::Posix/MQ-Posix-0.0.4/Documentation.md"},{"file":"work_mods/zef/MQ::Posix/MQ-Posix-0.0.4/lib/MQ/Posix.pm","publishUrl":"/mods/zef/MQ::Posix/MQ-Posix-0.0.4/lib/MQ/Posix.pm"}],"src":"zef","url":"/mods/zef/MQ::Posix"}}}
=end data


    =begin React :component<RenderItem>
    =begin data
    {"type":"page","file":"work_mods/zef/MQ::Posix/MQ-Posix-0.0.4/README.md","sources":[],"node":{"type":"block","id":"zTJ_BpMgC8Qlj07nfqJaK","margin":"","name":"root","content":[{"type":"block","id":"peT6iLG_SYyq6TiEv_RKr","margin":"","level":1,"name":"head","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":12,"offset":11}},"content":["MQ::Posix"]},{"type":"para","id":"CmLH-NX-cyU9IgWE1LVoB","margin":"","location":{"start":{"line":3,"column":1,"offset":13},"end":{"line":3,"column":38,"offset":50}},"text":"text","content":["Raku binding for POSIX message queues"]},{"type":"para","id":"WzBB4jSlq-1VOs4oBrn9N","margin":"","location":{"start":{"line":5,"column":1,"offset":52},"end":{"line":5,"column":82,"offset":133}},"text":"text","content":[{"type":"block","id":"hPs3b1qRDHRnnb2jOPv6K","margin":"","name":"Image","config":[],"location":{"start":{"line":5,"column":1,"offset":52},"end":{"line":5,"column":82,"offset":133}},"content":[{"type":"image","src":"https://github.com/jonathanstowe/MQ-Posix/workflows/CI/badge.svg","alt":"Build Status"}]}]},{"type":"block","id":"6Qqx_UP5y_K590GoHuu0R","margin":"","level":2,"name":"head","location":{"start":{"line":7,"column":1,"offset":135},"end":{"line":7,"column":12,"offset":146}},"content":["Synopsis"]},{"type":"block","id":"81MJMiiwPucoCDnlF4mV2","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":9,"column":1,"offset":148},"end":{"line":25,"column":4,"offset":413}},"content":[{"type":"verbatim","value":"\nuse MQ::Posix;\n\nmy $queue = MQ::Posix.new(name => 'test-queue', :create, :r );\n\nreact {\n    whenever $queue.Supply -> $buf {\n        say $buf.decode;\n    }\n    whenever signal(SIGINT) {\n        $queue.close;\n        $queue.unlink;\n        done;\n    }\n}"}]},{"type":"para","id":"Dlfu-ibbiAlvCS1BKmqTf","margin":"","location":{"start":{"line":27,"column":1,"offset":415},"end":{"line":27,"column":30,"offset":444}},"text":"text","content":["And in some separate process:"]},{"type":"block","id":"1_Rorx5sBJu_O3XaIFs10","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":29,"column":1,"offset":446},"end":{"line":39,"column":4,"offset":610}},"content":[{"type":"verbatim","value":"\nuse MQ::Posix;\n\nmy $queue = MQ::Posix.new(name => 'test-queue', :create, :w );\n\nawait $queue.send(\"some test message\", priority => 10);\n\n$queue.close;\n"}]},{"type":"block","id":"sr8dZdMH8EX3wwyRHWRn6","margin":"","level":2,"name":"head","location":{"start":{"line":41,"column":1,"offset":612},"end":{"line":41,"column":15,"offset":626}},"content":["Description"]},{"type":"para","id":"bQQnRKDm4z9YUmwzuQ0Wq","margin":"","location":{"start":{"line":43,"column":1,"offset":628},"end":{"line":44,"column":29,"offset":730}},"text":"text","content":["POSIX message queues offer a mechanism for processes to reliably exchange\ndata in the form of messages"]},{"type":"para","id":"ij5XYbUXwvsdx6KRE5MgD","margin":"","location":{"start":{"line":46,"column":1,"offset":732},"end":{"line":48,"column":14,"offset":899}},"text":"text","content":["The messages are presented as a priority ordered queue with higher priority\nmessages being delivered first and messages of equal priority being delivered\nin age order."]},{"type":"para","id":"VDl_0niNSyJcqNDaf2boj","margin":"","location":{"start":{"line":50,"column":1,"offset":901},"end":{"line":52,"column":16,"offset":1074}},"text":"text","content":["The mechanism is simple, having no provision for message metadata and so forth\nand whilst reliable, unread messages do not persist beyond the lifetime of the\nrunning kernel."]},{"type":"block","id":"2guHORQPvSujkiGsO8QIG","margin":"","level":2,"name":"head","location":{"start":{"line":54,"column":1,"offset":1076},"end":{"line":54,"column":11,"offset":1086}},"content":["Install"]},{"type":"para","id":"r8j0zh3vsHZZXbvYFlUO0","margin":"","location":{"start":{"line":56,"column":1,"offset":1088},"end":{"line":56,"column":93,"offset":1180}},"text":"text","content":["If you have a working installation of Rakudo you should be able to install this with ",{"type":"fcode","name":"I","content":["zef"]}," :"]},{"type":"block","id":"uWAah7TrrfG3LBvXuaqJU","margin":"","name":"code","config":[],"location":{"start":{"line":58,"column":1,"offset":1182},"end":{"line":62,"column":18,"offset":1255}},"content":[{"type":"verbatim","value":"zef install MQ::Posix\n\n# or from a local clone\n\nzef install ."}]},{"type":"block","id":"6svaRmMzhScoYsMzM-8h-","margin":"","level":2,"name":"head","location":{"start":{"line":64,"column":1,"offset":1257},"end":{"line":64,"column":11,"offset":1267}},"content":["Support"]},{"type":"para","id":"M28zUJvPMghX0cDVNQDaM","margin":"","location":{"start":{"line":66,"column":1,"offset":1269},"end":{"line":73,"column":36,"offset":1794}},"text":"text","content":["This should work on any operating system that has good modern POSIX\nsupport, however some systems may not enable kernel message queues by\nthe default and you may need some kernel build configuration to do so.\nAlso the limits and defaults for number of messages and maximum message\nsizes are set in different ways as this is not explicitly stated in the\nstandard, on Linux, for example, you can use the ",{"type":"fcode","name":"C","content":["sysctl"]}," interface\nto control these parameters, on other systems you may need to supply\nthem as kernel build configuration."]},{"type":"para","id":"Ap1LGYSLpVQ17ySSp4A7W","margin":"","location":{"start":{"line":75,"column":1,"offset":1796},"end":{"line":75,"column":149,"offset":1944}},"text":"text","content":["If this doesn't work as expected or you have new features that you would like to see please post in ",{"meta":"https://github.com/jonathanstowe/MQ-Posix/issues","type":"fcode","name":"L","content":["https://github.com/jonathanstowe/MQ-Posix/issues"]}]},{"type":"block","id":"W2rqkUzc647PW0kC_Gi0F","margin":"","level":2,"name":"head","location":{"start":{"line":77,"column":1,"offset":1946},"end":{"line":77,"column":23,"offset":1968}},"content":["Licence & Copyright"]},{"type":"para","id":"KIQ9EH6xJYXJ6YyAAe7fP","margin":"","location":{"start":{"line":79,"column":1,"offset":1970},"end":{"line":79,"column":70,"offset":2039}},"text":"text","content":["This is free software, please see the ",{"meta":"LICENCE","type":"fcode","name":"L","content":["LICENCE"]}," for details."]},{"type":"para","id":"jQkib8wTLaUavD8G9pImf","margin":"","location":{"start":{"line":81,"column":1,"offset":2041},"end":{"line":81,"column":29,"offset":2069}},"text":"text","content":["© Jonathan Stowe 2017 - 2021"]}]},"publishUrl":"/mods/zef/MQ::Posix/MQ-Posix-0.0.4/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"1.0","auth":"zef:jonathanstowe","authors":["Jonathan Stowe <jns+gh@gellyfish.co.uk>"],"build-depends":[],"depends":["NativeHelpers::Array"],"description":"binding for POSIX message queues","dist":"MQ::Posix:ver<0.0.4>:auth<zef:jonathanstowe>","license":"Artistic-2.0","meta-version":"1","name":"MQ::Posix","path":"M/Q_/MQ_POSIX/3aab33518a405bb8b699518eed141de6ea1043c3.tar.gz","provides":{"MQ::Posix":"lib/MQ/Posix.pm"},"raku":"6.*","resources":[],"source-url":"https://github.com/jonathanstowe/MQ-Posix.git","support":{"bugtracker":"https://github.com/jonathanstowe/MQ-Posix/issues","source":"https://github.com/jonathanstowe/MQ-Posix.git"},"tags":["posix","IPC","MQ"],"test-depends":["Test"],"version":"0.0.4"},"files":[{"file":"work_mods/zef/MQ::Posix/MQ-Posix-0.0.4/README.md","publishUrl":"/mods/zef/MQ::Posix/MQ-Posix-0.0.4/README.md"},{"file":"work_mods/zef/MQ::Posix/MQ-Posix-0.0.4/Documentation.md","publishUrl":"/mods/zef/MQ::Posix/MQ-Posix-0.0.4/Documentation.md"},{"file":"work_mods/zef/MQ::Posix/MQ-Posix-0.0.4/lib/MQ/Posix.pm","publishUrl":"/mods/zef/MQ::Posix/MQ-Posix-0.0.4/lib/MQ/Posix.pm"}],"src":"zef","url":"/mods/zef/MQ::Posix"}}}
    =end data
    =end React


binding for POSIX message queues


MQ::Posix


A library to facilitate using monetary values in Raku


=begin data
{"type":"page","file":"work_mods/zef/Moneys/dist/README.md","sources":[],"node":{"type":"block","id":"Jb7GydORT-ALk_oFOHBBq","margin":"","name":"root","content":[{"type":"block","id":"25FGsAKX7SduwxmAzuDBS","margin":"","level":1,"name":"head","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":8,"offset":7}},"content":["Money"]},{"type":"para","id":"y6wpYYeG0DWq6nrC54qfJ","margin":"","location":{"start":{"line":3,"column":1,"offset":9},"end":{"line":3,"column":364,"offset":372}},"text":"text","content":[{"meta":"https://firstdonoharm.dev/version/3/0/bds-cl-eco-extr-ffd-law-media-mil-my-soc-sup-sv-tal-usta-xuar.html","type":"fcode","name":"L","content":[{"type":"block","id":"6NDjC7DnDvJ-QM36dWdUx","margin":"","name":"Image","config":[],"location":{"start":{"line":3,"column":2,"offset":10},"end":{"line":3,"column":257,"offset":265}},"content":[{"type":"image","src":"https://img.shields.io/static/v1?label=Hippocratic%20License&message=HL3-BDS-CL-ECO-EXTR-FFD-LAW-MEDIA-MIL-MY-SOC-SUP-SV-TAL-USTA-XUAR&labelColor=5e2751&color=bc8c3d","alt":"Hippocratic License HL3-BDS-CL-ECO-EXTR-FFD-LAW-MEDIA-MIL-MY-SOC-SUP-SV-TAL-USTA-XUAR"}]}]}]},{"type":"para","id":"zj8kxYp1lOTCkLjqdCEDQ","margin":"","location":{"start":{"line":5,"column":1,"offset":374},"end":{"line":7,"column":44,"offset":583}},"text":"text","content":[{"type":"fcode","name":"C","content":["Money"]}," is a library that's meant to be an easy-to-use, relatively safe way of\nhandling monetary values in the Raku language. It provides a simple ",{"type":"fcode","name":"C","content":["class Money"]}," that\nhouses ",{"type":"fcode","name":"C","content":["amount"]}," and ",{"type":"fcode","name":"C","content":["currency"]}," information."]},{"type":"block","id":"gfYrcICgUtDlEuYJMx4Nb","margin":"","level":2,"name":"head","location":{"start":{"line":9,"column":1,"offset":585},"end":{"line":9,"column":16,"offset":600}},"content":["Construction"]},{"type":"para","id":"3vrhIP8stIyoY7WVWnKTI","margin":"","location":{"start":{"line":11,"column":1,"offset":602},"end":{"line":11,"column":53,"offset":654}},"text":"text","content":["Constructing a new ",{"type":"fcode","name":"C","content":["Money"]}," is ",{"type":"fcode","name":"I","content":["very"]}," straightforward"]},{"type":"block","id":"2v6NJ0kwSppzhmmju5hmV","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":13,"column":1,"offset":656},"end":{"line":27,"column":4,"offset":1130}},"content":[{"type":"verbatim","value":"my $money = Money.new(amount => 1.0, currency => 'USD'); # constructing a money value\nmy $money = Money.new: :amount(1.0), :currency<USD>;\nmy $money = Money.new(1.0, 'USD'); # arguments can also be positional\n\n# you can also pass in a string and it'll use regexes to parse\nmy $money = Money.new('$1.00 USD');\n\n# better yet:\nwith Money.new('$1.00 USD') -> $money {\n    # you can really make sure your money is parsed right\n} else {\n    # handle errors as needed\n}"}]},{"type":"block","id":"5taHALSwVxk7HmyRk-tvK","margin":"","level":2,"name":"head","location":{"start":{"line":29,"column":1,"offset":1132},"end":{"line":29,"column":14,"offset":1145}},"content":["Operations"]},{"type":"para","id":"tJUGtjGJEq-410p1iZg1C","margin":"","location":{"start":{"line":31,"column":1,"offset":1147},"end":{"line":31,"column":35,"offset":1181}},"text":"text","content":["Again, relatively straightforward:"]},{"type":"block","id":"lgzIFeT6bWj9LzMVhgtaE","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":33,"column":1,"offset":1183},"end":{"line":39,"column":4,"offset":1397}},"content":[{"type":"verbatim","value":"my $money-a = Money.new(5.00, 'USD');\nmy $money-b = Money.new(1.00, 'USD');\n\nmy $money-c = $money-a + $money-b; # => Money.new(6.00, 'USD')\nmy $money-d = $money-a - $money-b; # => Money.new(4.00, 'USD')"}]},{"type":"para","id":"-WKzLvehSg-5PUSC1a1C-","margin":"","location":{"start":{"line":41,"column":1,"offset":1399},"end":{"line":42,"column":9,"offset":1501}},"text":"text","content":["However, when doing arithmetic operations with two ",{"type":"fcode","name":"C","content":["Money"]},"s, you're probably going to want to\ndo this:"]},{"type":"block","id":"xhNbDIWx-O1oQGjOscij0","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":44,"column":1,"offset":1503},"end":{"line":53,"column":4,"offset":1697}},"content":[{"type":"verbatim","value":"my $money-a = Money.new(5.00, 'USD');\nmy $money-b = Money.new(1.00, 'CAD');\n\nwith $money-a + $money-b -> $money-c {\n    # ... this will never happen\n} else {\n    # handle the error\n}"}]}]},"publishUrl":"/mods/zef/Moneys/dist/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"","auth":"zef:arunvickram","build-depends":[],"depends":[],"description":"A library to facilitate using monetary values in Raku","dist":"Moneys:ver<0.0.1>:auth<zef:arunvickram>","name":"Moneys","path":"M/ON/MONEYS/1b2fcddb21057315a5b1a252430c6b7647ae13f5.tar.gz","provides":{"Money":"lib/Moneys.rakumod"},"resources":[],"test-depends":[],"version":"0.0.1"},"files":[{"file":"work_mods/zef/Moneys/dist/README.md","publishUrl":"/mods/zef/Moneys/dist/README.md"},{"file":"work_mods/zef/Moneys/dist/lib/Moneys.rakumod","publishUrl":"/mods/zef/Moneys/dist/lib/Moneys.rakumod"}],"src":"zef","url":"/mods/zef/Moneys"}}}
=end data


    =begin React :component<RenderItem>
    =begin data
    {"type":"page","file":"work_mods/zef/Moneys/dist/README.md","sources":[],"node":{"type":"block","id":"Jb7GydORT-ALk_oFOHBBq","margin":"","name":"root","content":[{"type":"block","id":"25FGsAKX7SduwxmAzuDBS","margin":"","level":1,"name":"head","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":8,"offset":7}},"content":["Money"]},{"type":"para","id":"y6wpYYeG0DWq6nrC54qfJ","margin":"","location":{"start":{"line":3,"column":1,"offset":9},"end":{"line":3,"column":364,"offset":372}},"text":"text","content":[{"meta":"https://firstdonoharm.dev/version/3/0/bds-cl-eco-extr-ffd-law-media-mil-my-soc-sup-sv-tal-usta-xuar.html","type":"fcode","name":"L","content":[{"type":"block","id":"6NDjC7DnDvJ-QM36dWdUx","margin":"","name":"Image","config":[],"location":{"start":{"line":3,"column":2,"offset":10},"end":{"line":3,"column":257,"offset":265}},"content":[{"type":"image","src":"https://img.shields.io/static/v1?label=Hippocratic%20License&message=HL3-BDS-CL-ECO-EXTR-FFD-LAW-MEDIA-MIL-MY-SOC-SUP-SV-TAL-USTA-XUAR&labelColor=5e2751&color=bc8c3d","alt":"Hippocratic License HL3-BDS-CL-ECO-EXTR-FFD-LAW-MEDIA-MIL-MY-SOC-SUP-SV-TAL-USTA-XUAR"}]}]}]},{"type":"para","id":"zj8kxYp1lOTCkLjqdCEDQ","margin":"","location":{"start":{"line":5,"column":1,"offset":374},"end":{"line":7,"column":44,"offset":583}},"text":"text","content":[{"type":"fcode","name":"C","content":["Money"]}," is a library that's meant to be an easy-to-use, relatively safe way of\nhandling monetary values in the Raku language. It provides a simple ",{"type":"fcode","name":"C","content":["class Money"]}," that\nhouses ",{"type":"fcode","name":"C","content":["amount"]}," and ",{"type":"fcode","name":"C","content":["currency"]}," information."]},{"type":"block","id":"gfYrcICgUtDlEuYJMx4Nb","margin":"","level":2,"name":"head","location":{"start":{"line":9,"column":1,"offset":585},"end":{"line":9,"column":16,"offset":600}},"content":["Construction"]},{"type":"para","id":"3vrhIP8stIyoY7WVWnKTI","margin":"","location":{"start":{"line":11,"column":1,"offset":602},"end":{"line":11,"column":53,"offset":654}},"text":"text","content":["Constructing a new ",{"type":"fcode","name":"C","content":["Money"]}," is ",{"type":"fcode","name":"I","content":["very"]}," straightforward"]},{"type":"block","id":"2v6NJ0kwSppzhmmju5hmV","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":13,"column":1,"offset":656},"end":{"line":27,"column":4,"offset":1130}},"content":[{"type":"verbatim","value":"my $money = Money.new(amount => 1.0, currency => 'USD'); # constructing a money value\nmy $money = Money.new: :amount(1.0), :currency<USD>;\nmy $money = Money.new(1.0, 'USD'); # arguments can also be positional\n\n# you can also pass in a string and it'll use regexes to parse\nmy $money = Money.new('$1.00 USD');\n\n# better yet:\nwith Money.new('$1.00 USD') -> $money {\n    # you can really make sure your money is parsed right\n} else {\n    # handle errors as needed\n}"}]},{"type":"block","id":"5taHALSwVxk7HmyRk-tvK","margin":"","level":2,"name":"head","location":{"start":{"line":29,"column":1,"offset":1132},"end":{"line":29,"column":14,"offset":1145}},"content":["Operations"]},{"type":"para","id":"tJUGtjGJEq-410p1iZg1C","margin":"","location":{"start":{"line":31,"column":1,"offset":1147},"end":{"line":31,"column":35,"offset":1181}},"text":"text","content":["Again, relatively straightforward:"]},{"type":"block","id":"lgzIFeT6bWj9LzMVhgtaE","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":33,"column":1,"offset":1183},"end":{"line":39,"column":4,"offset":1397}},"content":[{"type":"verbatim","value":"my $money-a = Money.new(5.00, 'USD');\nmy $money-b = Money.new(1.00, 'USD');\n\nmy $money-c = $money-a + $money-b; # => Money.new(6.00, 'USD')\nmy $money-d = $money-a - $money-b; # => Money.new(4.00, 'USD')"}]},{"type":"para","id":"-WKzLvehSg-5PUSC1a1C-","margin":"","location":{"start":{"line":41,"column":1,"offset":1399},"end":{"line":42,"column":9,"offset":1501}},"text":"text","content":["However, when doing arithmetic operations with two ",{"type":"fcode","name":"C","content":["Money"]},"s, you're probably going to want to\ndo this:"]},{"type":"block","id":"xhNbDIWx-O1oQGjOscij0","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":44,"column":1,"offset":1503},"end":{"line":53,"column":4,"offset":1697}},"content":[{"type":"verbatim","value":"my $money-a = Money.new(5.00, 'USD');\nmy $money-b = Money.new(1.00, 'CAD');\n\nwith $money-a + $money-b -> $money-c {\n    # ... this will never happen\n} else {\n    # handle the error\n}"}]}]},"publishUrl":"/mods/zef/Moneys/dist/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"","auth":"zef:arunvickram","build-depends":[],"depends":[],"description":"A library to facilitate using monetary values in Raku","dist":"Moneys:ver<0.0.1>:auth<zef:arunvickram>","name":"Moneys","path":"M/ON/MONEYS/1b2fcddb21057315a5b1a252430c6b7647ae13f5.tar.gz","provides":{"Money":"lib/Moneys.rakumod"},"resources":[],"test-depends":[],"version":"0.0.1"},"files":[{"file":"work_mods/zef/Moneys/dist/README.md","publishUrl":"/mods/zef/Moneys/dist/README.md"},{"file":"work_mods/zef/Moneys/dist/lib/Moneys.rakumod","publishUrl":"/mods/zef/Moneys/dist/lib/Moneys.rakumod"}],"src":"zef","url":"/mods/zef/Moneys"}}}
    =end data
    =end React


Moneys


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


Monitor::Monit

Monitor::Monit

image https://github.com/jonathanstowe/Monitor-Monit/workflows/CI/badge.svg not found

Synopsis

Description

Installation

Support

Copyright and Licence

Monitor::Monit v0.0.5

Authors

License

Dependencies

Test Dependencies

Provides

Documentation