TITLE

Simple Binary Tree Role with pretty printing


SUBTITLE

data

=begin data
{"type":"page","file":"work_mods/zef/BTree/README.md","sources":[],"node":{"type":"block","id":"4DRLaAjneq5s7AZCbbhDq","margin":"","name":"root","content":[{"type":"para","id":"DJRmzGio7mOjk_VY4BVe1","margin":"","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":129,"offset":128}},"text":"text","content":[{"meta":"https://github.com/Scimon/raku-BTree/actions","type":"fcode","name":"L","content":[{"type":"block","id":"05qgLmpk1sx5HkxIA6C_L","margin":"","name":"Image","config":[],"location":{"start":{"line":1,"column":2,"offset":1},"end":{"line":1,"column":82,"offset":81}},"content":[{"type":"image","src":"https://github.com/Scimon/raku-BTree/workflows/test/badge.svg","alt":"Actions Status"}]}]}]},{"type":"block","id":"5sVpyYaPrC79NWhYeC3zn","margin":"","level":1,"name":"head","location":{"start":{"line":3,"column":1,"offset":130},"end":{"line":3,"column":7,"offset":136}},"content":["NAME"]},{"type":"para","id":"bNc9cqnY7J8Mr_uQAny06","margin":"","location":{"start":{"line":5,"column":1,"offset":138},"end":{"line":5,"column":53,"offset":190}},"text":"text","content":["BTree - Simple Binary Tree Role with pretty printing"]},{"type":"block","id":"mptdRqFGUgXpjQ-I_8KTd","margin":"","level":1,"name":"head","location":{"start":{"line":7,"column":1,"offset":192},"end":{"line":7,"column":11,"offset":202}},"content":["SYNOPSIS"]},{"type":"block","id":"q-6uzY2vkfUL9bKiklCpD","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":9,"column":1,"offset":204},"end":{"line":14,"column":4,"offset":306}},"content":[{"type":"verbatim","value":"use BTree;\nclass IntTree does BTree[Int] {};\nmy IntTree(Str) $tree = \"1(2)(3)\";\nsay $tree;"}]},{"type":"block","id":"7xZUEuRbJP5RAsrPcA6xR","margin":"","level":1,"name":"head","location":{"start":{"line":16,"column":1,"offset":308},"end":{"line":16,"column":14,"offset":321}},"content":["DESCRIPTION"]},{"type":"para","id":"GA6VoF-cwXNFR9nodiO9-","margin":"","location":{"start":{"line":18,"column":1,"offset":323},"end":{"line":18,"column":153,"offset":475}},"text":"text","content":["BTree is intended to be a simple role that can be used to represent binary trees. It's intended to be a basis for a series of different types for trees."]},{"type":"block","id":"I1s8aO6shomoSw_ZJkn0D","margin":"","level":1,"name":"head","location":{"start":{"line":20,"column":1,"offset":477},"end":{"line":20,"column":9,"offset":485}},"content":["AUTHOR"]},{"type":"para","id":"TrzlgGqriuyYbqs9a16SC","margin":"","location":{"start":{"line":22,"column":1,"offset":487},"end":{"line":22,"column":41,"offset":527}},"text":"text","content":["Scimon Proctor ",{"meta":"mailto:simon.proctor@gmail.com","type":"fcode","name":"L","content":["simon.proctor@gmail.com"]}]},{"type":"block","id":"Ysb7DnayiHPTXstdvvfKU","margin":"","level":1,"name":"head","location":{"start":{"line":24,"column":1,"offset":529},"end":{"line":24,"column":24,"offset":552}},"content":["COPYRIGHT AND LICENSE"]},{"type":"para","id":"euHX1spL4FHXnfWETUhsL","margin":"","location":{"start":{"line":26,"column":1,"offset":554},"end":{"line":26,"column":30,"offset":583}},"text":"text","content":["Copyright 2021 Scimon Proctor"]},{"type":"para","id":"vY5FAxiCkOzPRisC-hBfm","margin":"","location":{"start":{"line":28,"column":1,"offset":585},"end":{"line":28,"column":104,"offset":688}},"text":"text","content":["This library is free software; you can redistribute it and/or modify it under the Artistic License 2.0."]}]},"publishUrl":"/mods/zef/BTree/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"","auth":"zef:Scimon","authors":["Scimon Proctor"],"build-depends":[],"depends":[],"description":"Simple Binary Tree Role with pretty printing","dist":"BTree:ver<0.0.1>:auth<zef:Scimon>","license":"Artistic-2.0","name":"BTree","path":"B/TR/BTREE/0fe89670bebf806f7f4d475ce5147152b27c2708.tar.gz","perl":"6.d","provides":{"BTree":"lib/BTree.rakumod","BTree::Grammar":"lib/BTree/Grammar.rakumod","BTree::PrettyTree":"lib/BTree/PrettyTree.rakumod","BTree::Representation":"lib/BTree/Representation.rakumod"},"resources":[],"source-url":"https://github.com/Scimon/raku-BTree.git","tags":[],"test-depends":[],"version":"0.0.1"},"files":[{"file":"work_mods/zef/BTree/README.md","publishUrl":"/mods/zef/BTree/README.md"},{"file":"work_mods/zef/BTree/lib/BTree.rakumod","publishUrl":"/mods/zef/BTree/lib/BTree.rakumod"}],"src":"zef","url":"/mods/zef/BTree"}}}
=end data


React

    =begin React :component<RenderItem>
    =begin data
    {"type":"page","file":"work_mods/zef/BTree/README.md","sources":[],"node":{"type":"block","id":"4DRLaAjneq5s7AZCbbhDq","margin":"","name":"root","content":[{"type":"para","id":"DJRmzGio7mOjk_VY4BVe1","margin":"","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":129,"offset":128}},"text":"text","content":[{"meta":"https://github.com/Scimon/raku-BTree/actions","type":"fcode","name":"L","content":[{"type":"block","id":"05qgLmpk1sx5HkxIA6C_L","margin":"","name":"Image","config":[],"location":{"start":{"line":1,"column":2,"offset":1},"end":{"line":1,"column":82,"offset":81}},"content":[{"type":"image","src":"https://github.com/Scimon/raku-BTree/workflows/test/badge.svg","alt":"Actions Status"}]}]}]},{"type":"block","id":"5sVpyYaPrC79NWhYeC3zn","margin":"","level":1,"name":"head","location":{"start":{"line":3,"column":1,"offset":130},"end":{"line":3,"column":7,"offset":136}},"content":["NAME"]},{"type":"para","id":"bNc9cqnY7J8Mr_uQAny06","margin":"","location":{"start":{"line":5,"column":1,"offset":138},"end":{"line":5,"column":53,"offset":190}},"text":"text","content":["BTree - Simple Binary Tree Role with pretty printing"]},{"type":"block","id":"mptdRqFGUgXpjQ-I_8KTd","margin":"","level":1,"name":"head","location":{"start":{"line":7,"column":1,"offset":192},"end":{"line":7,"column":11,"offset":202}},"content":["SYNOPSIS"]},{"type":"block","id":"q-6uzY2vkfUL9bKiklCpD","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":9,"column":1,"offset":204},"end":{"line":14,"column":4,"offset":306}},"content":[{"type":"verbatim","value":"use BTree;\nclass IntTree does BTree[Int] {};\nmy IntTree(Str) $tree = \"1(2)(3)\";\nsay $tree;"}]},{"type":"block","id":"7xZUEuRbJP5RAsrPcA6xR","margin":"","level":1,"name":"head","location":{"start":{"line":16,"column":1,"offset":308},"end":{"line":16,"column":14,"offset":321}},"content":["DESCRIPTION"]},{"type":"para","id":"GA6VoF-cwXNFR9nodiO9-","margin":"","location":{"start":{"line":18,"column":1,"offset":323},"end":{"line":18,"column":153,"offset":475}},"text":"text","content":["BTree is intended to be a simple role that can be used to represent binary trees. It's intended to be a basis for a series of different types for trees."]},{"type":"block","id":"I1s8aO6shomoSw_ZJkn0D","margin":"","level":1,"name":"head","location":{"start":{"line":20,"column":1,"offset":477},"end":{"line":20,"column":9,"offset":485}},"content":["AUTHOR"]},{"type":"para","id":"TrzlgGqriuyYbqs9a16SC","margin":"","location":{"start":{"line":22,"column":1,"offset":487},"end":{"line":22,"column":41,"offset":527}},"text":"text","content":["Scimon Proctor ",{"meta":"mailto:simon.proctor@gmail.com","type":"fcode","name":"L","content":["simon.proctor@gmail.com"]}]},{"type":"block","id":"Ysb7DnayiHPTXstdvvfKU","margin":"","level":1,"name":"head","location":{"start":{"line":24,"column":1,"offset":529},"end":{"line":24,"column":24,"offset":552}},"content":["COPYRIGHT AND LICENSE"]},{"type":"para","id":"euHX1spL4FHXnfWETUhsL","margin":"","location":{"start":{"line":26,"column":1,"offset":554},"end":{"line":26,"column":30,"offset":583}},"text":"text","content":["Copyright 2021 Scimon Proctor"]},{"type":"para","id":"vY5FAxiCkOzPRisC-hBfm","margin":"","location":{"start":{"line":28,"column":1,"offset":585},"end":{"line":28,"column":104,"offset":688}},"text":"text","content":["This library is free software; you can redistribute it and/or modify it under the Artistic License 2.0."]}]},"publishUrl":"/mods/zef/BTree/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"","auth":"zef:Scimon","authors":["Scimon Proctor"],"build-depends":[],"depends":[],"description":"Simple Binary Tree Role with pretty printing","dist":"BTree:ver<0.0.1>:auth<zef:Scimon>","license":"Artistic-2.0","name":"BTree","path":"B/TR/BTREE/0fe89670bebf806f7f4d475ce5147152b27c2708.tar.gz","perl":"6.d","provides":{"BTree":"lib/BTree.rakumod","BTree::Grammar":"lib/BTree/Grammar.rakumod","BTree::PrettyTree":"lib/BTree/PrettyTree.rakumod","BTree::Representation":"lib/BTree/Representation.rakumod"},"resources":[],"source-url":"https://github.com/Scimon/raku-BTree.git","tags":[],"test-depends":[],"version":"0.0.1"},"files":[{"file":"work_mods/zef/BTree/README.md","publishUrl":"/mods/zef/BTree/README.md"},{"file":"work_mods/zef/BTree/lib/BTree.rakumod","publishUrl":"/mods/zef/BTree/lib/BTree.rakumod"}],"src":"zef","url":"/mods/zef/BTree"}}}
    =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

BTree


Luxafor Indicators based on Google Calendar and Webcam Status


=begin data
{"type":"page","file":"work_mods/zef/BusyIndicator/BusyIndicator-0.3.0/README.md","sources":[],"node":{"type":"block","id":"dUzhBozEoDfrYlwHvTS6m","margin":"","name":"root","content":[{"type":"block","id":"mLIOrWgAfL0m5Nga5g6E_","margin":"","level":1,"name":"head","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":7,"offset":6}},"content":["NAME"]},{"type":"para","id":"LQ4e-zbIKkxcF455FJg59","margin":"","location":{"start":{"line":3,"column":1,"offset":8},"end":{"line":3,"column":84,"offset":91}},"text":"text","content":["busy-indicator.raku - Luxafor Indicators based on Google Calendar and Webcam Status"]},{"type":"block","id":"I4xIzemc-9belyy-iiXJv","margin":"","level":1,"name":"head","location":{"start":{"line":5,"column":1,"offset":93},"end":{"line":5,"column":11,"offset":103}},"content":["SYNOPSIS"]},{"type":"block","id":"jievbmNU0SvVkNas8KDtH","margin":"","name":"code","config":[],"location":{"start":{"line":7,"column":1,"offset":105},"end":{"line":7,"column":54,"offset":158}},"content":[{"type":"verbatim","value":"# busy-indicator.rakuo --calendar=you@example.com"}]},{"type":"block","id":"Hf2HCfMBee0SjNWK_4nFd","margin":"","level":1,"name":"head","location":{"start":{"line":9,"column":1,"offset":160},"end":{"line":9,"column":14,"offset":173}},"content":["DESCRIPTION"]},{"type":"para","id":"AB_23jhewKYsAAfuH_IzZ","margin":"","location":{"start":{"line":11,"column":1,"offset":175},"end":{"line":11,"column":311,"offset":485}},"text":"text","content":["This controls Luxafor flag indicators based on a combination of Google Calendar meetings (when in a meeting, the flag is on, as well as two minutes before and after the meeting) and webcam usage (when the webcam is in use, it turns the Luxafor flag on). It also provides for manual control of the Luxafor flag."]},{"type":"para","id":"DUsPzmtiG1FWILKrwC_n2","margin":"","location":{"start":{"line":13,"column":1,"offset":487},"end":{"line":13,"column":106,"offset":592}},"text":"text","content":["This allows people to know if I'm \"busy\" or not without disturbing me or a conference call I might be on."]},{"type":"block","id":"jcSuDaer22Fdl5RZ9xIOt","margin":"","level":1,"name":"head","location":{"start":{"line":15,"column":1,"offset":594},"end":{"line":15,"column":22,"offset":615}},"content":["OPTIONAL PARAMETERS"]},{"type":"block","id":"qAlDFZ1PpDQdtF9Xj3Avo","margin":"","level":2,"name":"head","location":{"start":{"line":17,"column":1,"offset":617},"end":{"line":17,"column":25,"offset":641}},"content":["--calendar=",{"type":"block","id":"348opHqu0dqx0ZXTP0Cua","margin":"","name":"Html","location":{"start":{"line":17,"column":15,"offset":631},"end":{"line":17,"column":25,"offset":641}},"content":[{"type":"verbatim","value":"<calendar>"}]}]},{"type":"para","id":"61y-rK0YMqhzII3SyNaql","margin":"","location":{"start":{"line":19,"column":1,"offset":643},"end":{"line":19,"column":148,"offset":790}},"text":"text","content":["This is a comma-seperated list of Google calendars your Google account has access to examine and which you want to use to control the Luxafor flag."]},{"type":"para","id":"Ph72UB-CSsAjacmB03Xnu","margin":"","location":{"start":{"line":21,"column":1,"offset":792},"end":{"line":21,"column":299,"offset":1090}},"text":"text","content":["To access these calendars, this program uses the ",{"type":"fcode","name":"C","content":["gcalcli"]}," program. Thus, you need to install ",{"type":"fcode","name":"C","content":["gcalcli"]}," before using this option. You also need to execute gcalcli once from the command line (which will open a browser for you to authenticate to Google) to have ",{"type":"fcode","name":"C","content":["gcalcli"]}," cache a Google access token."]},{"type":"para","id":"SPNRDJRs8t1gjHWTdN5v1","margin":"","location":{"start":{"line":23,"column":1,"offset":1092},"end":{"line":23,"column":88,"offset":1179}},"text":"text","content":["If you don't want to use Google calendar integration, simply don't provide this option."]},{"type":"block","id":"fc7HcLefc5Qnlpu8ola1v","margin":"","level":2,"name":"head","location":{"start":{"line":25,"column":1,"offset":1181},"end":{"line":25,"column":24,"offset":1204}},"content":["--interval=",{"type":"block","id":"dixYwRailCaFc-vO8Gjr8","margin":"","name":"Html","location":{"start":{"line":25,"column":15,"offset":1195},"end":{"line":25,"column":24,"offset":1204}},"content":[{"type":"verbatim","value":"<seconds>"}]}]},{"type":"para","id":"Gjmkw3DxhE-5dJqnIED1t","margin":"","location":{"start":{"line":27,"column":1,"offset":1206},"end":{"line":27,"column":138,"offset":1343}},"text":"text","content":["This determines how often the script fetches Google calendar entries and writes a status line to the screen. The default is ",{"type":"fcode","name":"C","content":["60"]}," seconds."]},{"type":"block","id":"DthEmBNjwZC9T4pW5lkLH","margin":"","level":2,"name":"head","location":{"start":{"line":29,"column":1,"offset":1345},"end":{"line":29,"column":21,"offset":1365}},"content":["--port=",{"type":"block","id":"D4WH3JlPp5TNTkblLCh_S","margin":"","name":"Html","location":{"start":{"line":29,"column":11,"offset":1355},"end":{"line":29,"column":21,"offset":1365}},"content":[{"type":"verbatim","value":"<udp port>"}]}]},{"type":"para","id":"iFsiKvsCpy8lC4nYnlpxo","margin":"","location":{"start":{"line":31,"column":1,"offset":1367},"end":{"line":31,"column":302,"offset":1668}},"text":"text","content":["This determines what control port is used for this script. By default, it is 0 (disabled). If you use a control port (this is an advanced usage), you must specify a port number. Note that no authentication is used for this port, so it must not be firewalled or otherwise protected from outside access."]},{"type":"block","id":"ov_7T8MhjaGKJ6wW7n5Le","margin":"","level":2,"name":"head","location":{"start":{"line":33,"column":1,"offset":1670},"end":{"line":33,"column":16,"offset":1685}},"content":["--ignore-ooo"]},{"type":"para","id":"6hxXwcgodegbLAy9-XdDf","margin":"","location":{"start":{"line":35,"column":1,"offset":1687},"end":{"line":35,"column":248,"offset":1934}},"text":"text","content":["Ignores meetings on the calendar with a title of \"OOO\" (in any case). I use these as \"out of office\" meetings to block time, but have a meeting visible in another calendar that has details, so the OOO meetings provide no useful additional context."]},{"type":"block","id":"uTpTYhgGoOt3CuuVu8N2V","margin":"","level":1,"name":"head","location":{"start":{"line":37,"column":1,"offset":1936},"end":{"line":37,"column":17,"offset":1952}},"content":["USER INTERFACE"]},{"type":"para","id":"waYnZOrVaFiXZdr8oXEGB","margin":"","location":{"start":{"line":39,"column":1,"offset":1954},"end":{"line":39,"column":257,"offset":2210}},"text":"text","content":["Once you run the program, every minute (or whatever you specified for the ",{"type":"fcode","name":"C","content":["--interval"]}," option) it will update the screen with a status. This status will indicate if you are currently in a meeting or, otherwise, the next meeting that is scheduled for today."]},{"type":"para","id":"W5r7ySx89rzoFloHqHJ8h","margin":"","location":{"start":{"line":41,"column":1,"offset":2212},"end":{"line":41,"column":94,"offset":2305}},"text":"text","content":["There are some keyboard commands that can be used to override the automatic busy indications:"]},{"type":"para","id":"M5C3fVYX_81LYIE9kEgS2","margin":"","location":{"start":{"line":43,"column":1,"offset":2307},"end":{"line":43,"column":62,"offset":2368}},"text":"text","content":["The \"b\" command will turn the light(s) on (with a red light)."]},{"type":"para","id":"iecpMthb5nsBG_gB6AzWA","margin":"","location":{"start":{"line":45,"column":1,"offset":2370},"end":{"line":45,"column":67,"offset":2436}},"text":"text","content":["The \"o\" command will turn the light(s) off until the next meeting."]},{"type":"para","id":"tV81qNosy4a6TXMmUBpzq","margin":"","location":{"start":{"line":47,"column":1,"offset":2438},"end":{"line":47,"column":62,"offset":2499}},"text":"text","content":["The \"g\" command will turn the light on, but as a green light."]},{"type":"para","id":"plnCkh4EHRxaCcAaOL2cw","margin":"","location":{"start":{"line":49,"column":1,"offset":2501},"end":{"line":49,"column":52,"offset":2552}},"text":"text","content":["The \"n\" displays the next meeting on your calendar."]},{"type":"para","id":"DEImQbncjFeKGcVYAcUlh","margin":"","location":{"start":{"line":51,"column":1,"offset":2554},"end":{"line":51,"column":62,"offset":2615}},"text":"text","content":["The \"a\" shows you an \"agenda\" view of your upcoming meetings."]},{"type":"block","id":"ua619dS1DIZ8Atet679hE","margin":"","level":1,"name":"head","location":{"start":{"line":53,"column":1,"offset":2617},"end":{"line":53,"column":29,"offset":2645}},"content":["INSTALLATION PREREQUISITES"]},{"type":"para","id":"Fv261JAAHqbZSOUP2MiBs","margin":"","location":{"start":{"line":55,"column":1,"offset":2647},"end":{"line":55,"column":50,"offset":2696}},"text":"text","content":["You must have a Luxafor flag to use this program."]},{"type":"para","id":"RaPIhJdXoXhzcFfV_MiFp","margin":"","location":{"start":{"line":57,"column":1,"offset":2698},"end":{"line":57,"column":103,"offset":2800}},"text":"text","content":["You need relatively recent Raku to be installed. Download Raku for your OS from: ",{"meta":"https://www.raku.org/","type":"fcode","name":"L","content":["https://www.raku.org/"]}]},{"type":"para","id":"ZPF_cJ2-b1CrV900w_v36","margin":"","location":{"start":{"line":59,"column":1,"offset":2802},"end":{"line":59,"column":79,"offset":2880}},"text":"text","content":["You must install ",{"type":"fcode","name":"C","content":["LibUSB"]}," development libraries. On Ubuntu, this is done with:"]},{"type":"block","id":"IbWlIdjaQXUg95dhFKiNr","margin":"","name":"code","config":[],"location":{"start":{"line":61,"column":1,"offset":2882},"end":{"line":61,"column":42,"offset":2923}},"content":[{"type":"verbatim","value":"sudo apt-get install libusb-1.0-0-dev"}]},{"type":"para","id":"xAOg1kyq-EwcjUk-wO1II","margin":"","location":{"start":{"line":63,"column":1,"offset":2925},"end":{"line":63,"column":96,"offset":3020}},"text":"text","content":["You must also install ",{"type":"fcode","name":"C","content":["gcalcli"]}," if using the Google Calendar integration. To do that on Ubuntu:"]},{"type":"block","id":"dLUF0afsWT3V-bauZePtB","margin":"","name":"code","config":[],"location":{"start":{"line":65,"column":1,"offset":3022},"end":{"line":65,"column":33,"offset":3054}},"content":[{"type":"verbatim","value":"sudo apt-get install gcalcli"}]},{"type":"para","id":"-729Qpdwyq5U4xoadQyEC","margin":"","location":{"start":{"line":67,"column":1,"offset":3056},"end":{"line":67,"column":208,"offset":3263}},"text":"text","content":["Then you'll want to run gcalcli the first time, and log into Google with your proper credentials (the first time you run gcalcli, it'll open a browser for you to log into your Google account): gcalcli agenda"]},{"type":"para","id":"24kykK7CMDJy5tuiEAkxC","margin":"","location":{"start":{"line":69,"column":1,"offset":3265},"end":{"line":69,"column":157,"offset":3421}},"text":"text","content":["You must ensure that the Luxafor Flag is not bound to the ",{"type":"fcode","name":"C","content":["usbhid"]}," module. To do that on Ubuntu, create a file ",{"type":"fcode","name":"C","content":["/etc/modprobe.d/luxafor.conf"]}," that contains:"]},{"type":"block","id":"uZ_nG1DvVY8a67hfmBSPv","margin":"","name":"code","config":[],"location":{"start":{"line":71,"column":1,"offset":3423},"end":{"line":71,"column":47,"offset":3469}},"content":[{"type":"verbatim","value":"options usbhid quirks=0x04d8:0xf372:0x0004"}]},{"type":"para","id":"z2TuXptYNbDnsJuLmTZC5","margin":"","location":{"start":{"line":73,"column":1,"offset":3471},"end":{"line":73,"column":72,"offset":3542}},"text":"text","content":["You will need to reboot after making this change for it to take effect."]},{"type":"para","id":"E_dym8l4fjh1SomBxDZzX","margin":"","location":{"start":{"line":75,"column":1,"offset":3544},"end":{"line":75,"column":172,"offset":3715}},"text":"text","content":["If you wish to run this program as a standard user (highly recommended), you also need to create a file named ",{"type":"fcode","name":"C","content":["/etc/udev/rules.d/luxafor.rules"]}," with the following content:"]},{"type":"block","id":"1GlKxarOKN30-1nesK-Q2","margin":"","name":"code","config":[],"location":{"start":{"line":77,"column":1,"offset":3717},"end":{"line":77,"column":96,"offset":3812}},"content":[{"type":"verbatim","value":"SUBSYTEM==\"usb\", ATTR{idVendor}=\"04d8\", ATTR{idProduct}==\"f372\" MODE=\"0664\" OWNER=\"jmaslak\""}]},{"type":"para","id":"olaqA9H6f_1oD9ajz_cDV","margin":"","location":{"start":{"line":79,"column":1,"offset":3814},"end":{"line":79,"column":117,"offset":3930}},"text":"text","content":["Replace ",{"type":"fcode","name":"C","content":["jmaslak"]}," in the above file with your username. Then you will need to reboot for this change to take effect."]},{"type":"para","id":"kvws-c1gkyWHQ-7RbrmiR","margin":"","location":{"start":{"line":81,"column":1,"offset":3932},"end":{"line":81,"column":124,"offset":4055}},"text":"text","content":["As root (or another user depending on your Raku installation), you can install this package with: zef install BusyIndicator"]},{"type":"para","id":"-9wsi7haLwUZe-jEEfi3Z","margin":"","location":{"start":{"line":83,"column":1,"offset":4057},"end":{"line":83,"column":78,"offset":4134}},"text":"text","content":["Now you can run the script using \"busy-indicator-raku\" from the command line!"]},{"type":"block","id":"dPckxkw0NhQ_eu00kolGW","margin":"","level":1,"name":"head","location":{"start":{"line":85,"column":1,"offset":4136},"end":{"line":85,"column":12,"offset":4147}},"content":["COPYRIGHT"]},{"type":"para","id":"U4uS1HSLT84pQBslQN20i","margin":"","location":{"start":{"line":87,"column":1,"offset":4149},"end":{"line":87,"column":141,"offset":4289}},"text":"text","content":["Copyright © 2019-2023 Joelle Maslak This application is free software; you can distribute it and/or modify it under the Artistic License 2.0"]},{"type":"para","id":"SkN53Re8FLfyU8Zvq6QM1","margin":"","location":{"start":{"line":89,"column":1,"offset":4291},"end":{"line":89,"column":170,"offset":4460}},"text":"text","content":["Also included is a modified version of Travis Gibson's ",{"type":"fcode","name":"C","content":["LibUSB"]}," which has a copyright: Copyright © 2020 Travis Gibson It is also licensed under the Artistic License 2.0."]}]},"publishUrl":"/mods/zef/BusyIndicator/BusyIndicator-0.3.0/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"","auth":"zef:jmaslak","authors":["Joelle Maslak"],"build-depends":[],"depends":["LibUSB"],"description":"Luxafor Indicators based on Google Calendar and Webcam Status","dist":"BusyIndicator:ver<0.3.0>:auth<zef:jmaslak>","license":"Artistic-2.0","name":"BusyIndicator","path":"B/US/BUSYINDICATOR/8fc093b75648f2a5ba4ebeeff2e534e09d61d61e.tar.gz","perl":"6.d","provides":{"BusyIndicator":"lib/BusyIndicator.rakumod","BusyIndicator::LibUSB":"lib/BusyIndicator/LibUSB.rakumod","BusyIndicator::Luxafor":"lib/BusyIndicator/Luxafor.rakumod"},"resources":[],"source-url":"https://github.com/jmaslak/Raku-BusyIndicator.git","tags":[],"test-depends":[],"version":"0.3.0"},"files":[{"file":"work_mods/zef/BusyIndicator/BusyIndicator-0.3.0/README.md","publishUrl":"/mods/zef/BusyIndicator/BusyIndicator-0.3.0/README.md"},{"file":"work_mods/zef/BusyIndicator/BusyIndicator-0.3.0/CODE_OF_CONDUCT.md","publishUrl":"/mods/zef/BusyIndicator/BusyIndicator-0.3.0/CODE_OF_CONDUCT.md"},{"file":"work_mods/zef/BusyIndicator/BusyIndicator-0.3.0/bin/busy-indicator.rakudoc","publishUrl":"/mods/zef/BusyIndicator/BusyIndicator-0.3.0/bin/busy-indicator.rakudoc"},{"file":"work_mods/zef/BusyIndicator/BusyIndicator-0.3.0/lib/BusyIndicator.rakumod","publishUrl":"/mods/zef/BusyIndicator/BusyIndicator-0.3.0/lib/BusyIndicator.rakumod"},{"file":"work_mods/zef/BusyIndicator/BusyIndicator-0.3.0/lib/BusyIndicator/LibUSB.rakumod","publishUrl":"/mods/zef/BusyIndicator/BusyIndicator-0.3.0/lib/BusyIndicator/LibUSB.rakumod"}],"src":"zef","url":"/mods/zef/BusyIndicator"}}}
=end data


    =begin React :component<RenderItem>
    =begin data
    {"type":"page","file":"work_mods/zef/BusyIndicator/BusyIndicator-0.3.0/README.md","sources":[],"node":{"type":"block","id":"dUzhBozEoDfrYlwHvTS6m","margin":"","name":"root","content":[{"type":"block","id":"mLIOrWgAfL0m5Nga5g6E_","margin":"","level":1,"name":"head","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":7,"offset":6}},"content":["NAME"]},{"type":"para","id":"LQ4e-zbIKkxcF455FJg59","margin":"","location":{"start":{"line":3,"column":1,"offset":8},"end":{"line":3,"column":84,"offset":91}},"text":"text","content":["busy-indicator.raku - Luxafor Indicators based on Google Calendar and Webcam Status"]},{"type":"block","id":"I4xIzemc-9belyy-iiXJv","margin":"","level":1,"name":"head","location":{"start":{"line":5,"column":1,"offset":93},"end":{"line":5,"column":11,"offset":103}},"content":["SYNOPSIS"]},{"type":"block","id":"jievbmNU0SvVkNas8KDtH","margin":"","name":"code","config":[],"location":{"start":{"line":7,"column":1,"offset":105},"end":{"line":7,"column":54,"offset":158}},"content":[{"type":"verbatim","value":"# busy-indicator.rakuo --calendar=you@example.com"}]},{"type":"block","id":"Hf2HCfMBee0SjNWK_4nFd","margin":"","level":1,"name":"head","location":{"start":{"line":9,"column":1,"offset":160},"end":{"line":9,"column":14,"offset":173}},"content":["DESCRIPTION"]},{"type":"para","id":"AB_23jhewKYsAAfuH_IzZ","margin":"","location":{"start":{"line":11,"column":1,"offset":175},"end":{"line":11,"column":311,"offset":485}},"text":"text","content":["This controls Luxafor flag indicators based on a combination of Google Calendar meetings (when in a meeting, the flag is on, as well as two minutes before and after the meeting) and webcam usage (when the webcam is in use, it turns the Luxafor flag on). It also provides for manual control of the Luxafor flag."]},{"type":"para","id":"DUsPzmtiG1FWILKrwC_n2","margin":"","location":{"start":{"line":13,"column":1,"offset":487},"end":{"line":13,"column":106,"offset":592}},"text":"text","content":["This allows people to know if I'm \"busy\" or not without disturbing me or a conference call I might be on."]},{"type":"block","id":"jcSuDaer22Fdl5RZ9xIOt","margin":"","level":1,"name":"head","location":{"start":{"line":15,"column":1,"offset":594},"end":{"line":15,"column":22,"offset":615}},"content":["OPTIONAL PARAMETERS"]},{"type":"block","id":"qAlDFZ1PpDQdtF9Xj3Avo","margin":"","level":2,"name":"head","location":{"start":{"line":17,"column":1,"offset":617},"end":{"line":17,"column":25,"offset":641}},"content":["--calendar=",{"type":"block","id":"348opHqu0dqx0ZXTP0Cua","margin":"","name":"Html","location":{"start":{"line":17,"column":15,"offset":631},"end":{"line":17,"column":25,"offset":641}},"content":[{"type":"verbatim","value":"<calendar>"}]}]},{"type":"para","id":"61y-rK0YMqhzII3SyNaql","margin":"","location":{"start":{"line":19,"column":1,"offset":643},"end":{"line":19,"column":148,"offset":790}},"text":"text","content":["This is a comma-seperated list of Google calendars your Google account has access to examine and which you want to use to control the Luxafor flag."]},{"type":"para","id":"Ph72UB-CSsAjacmB03Xnu","margin":"","location":{"start":{"line":21,"column":1,"offset":792},"end":{"line":21,"column":299,"offset":1090}},"text":"text","content":["To access these calendars, this program uses the ",{"type":"fcode","name":"C","content":["gcalcli"]}," program. Thus, you need to install ",{"type":"fcode","name":"C","content":["gcalcli"]}," before using this option. You also need to execute gcalcli once from the command line (which will open a browser for you to authenticate to Google) to have ",{"type":"fcode","name":"C","content":["gcalcli"]}," cache a Google access token."]},{"type":"para","id":"SPNRDJRs8t1gjHWTdN5v1","margin":"","location":{"start":{"line":23,"column":1,"offset":1092},"end":{"line":23,"column":88,"offset":1179}},"text":"text","content":["If you don't want to use Google calendar integration, simply don't provide this option."]},{"type":"block","id":"fc7HcLefc5Qnlpu8ola1v","margin":"","level":2,"name":"head","location":{"start":{"line":25,"column":1,"offset":1181},"end":{"line":25,"column":24,"offset":1204}},"content":["--interval=",{"type":"block","id":"dixYwRailCaFc-vO8Gjr8","margin":"","name":"Html","location":{"start":{"line":25,"column":15,"offset":1195},"end":{"line":25,"column":24,"offset":1204}},"content":[{"type":"verbatim","value":"<seconds>"}]}]},{"type":"para","id":"Gjmkw3DxhE-5dJqnIED1t","margin":"","location":{"start":{"line":27,"column":1,"offset":1206},"end":{"line":27,"column":138,"offset":1343}},"text":"text","content":["This determines how often the script fetches Google calendar entries and writes a status line to the screen. The default is ",{"type":"fcode","name":"C","content":["60"]}," seconds."]},{"type":"block","id":"DthEmBNjwZC9T4pW5lkLH","margin":"","level":2,"name":"head","location":{"start":{"line":29,"column":1,"offset":1345},"end":{"line":29,"column":21,"offset":1365}},"content":["--port=",{"type":"block","id":"D4WH3JlPp5TNTkblLCh_S","margin":"","name":"Html","location":{"start":{"line":29,"column":11,"offset":1355},"end":{"line":29,"column":21,"offset":1365}},"content":[{"type":"verbatim","value":"<udp port>"}]}]},{"type":"para","id":"iFsiKvsCpy8lC4nYnlpxo","margin":"","location":{"start":{"line":31,"column":1,"offset":1367},"end":{"line":31,"column":302,"offset":1668}},"text":"text","content":["This determines what control port is used for this script. By default, it is 0 (disabled). If you use a control port (this is an advanced usage), you must specify a port number. Note that no authentication is used for this port, so it must not be firewalled or otherwise protected from outside access."]},{"type":"block","id":"ov_7T8MhjaGKJ6wW7n5Le","margin":"","level":2,"name":"head","location":{"start":{"line":33,"column":1,"offset":1670},"end":{"line":33,"column":16,"offset":1685}},"content":["--ignore-ooo"]},{"type":"para","id":"6hxXwcgodegbLAy9-XdDf","margin":"","location":{"start":{"line":35,"column":1,"offset":1687},"end":{"line":35,"column":248,"offset":1934}},"text":"text","content":["Ignores meetings on the calendar with a title of \"OOO\" (in any case). I use these as \"out of office\" meetings to block time, but have a meeting visible in another calendar that has details, so the OOO meetings provide no useful additional context."]},{"type":"block","id":"uTpTYhgGoOt3CuuVu8N2V","margin":"","level":1,"name":"head","location":{"start":{"line":37,"column":1,"offset":1936},"end":{"line":37,"column":17,"offset":1952}},"content":["USER INTERFACE"]},{"type":"para","id":"waYnZOrVaFiXZdr8oXEGB","margin":"","location":{"start":{"line":39,"column":1,"offset":1954},"end":{"line":39,"column":257,"offset":2210}},"text":"text","content":["Once you run the program, every minute (or whatever you specified for the ",{"type":"fcode","name":"C","content":["--interval"]}," option) it will update the screen with a status. This status will indicate if you are currently in a meeting or, otherwise, the next meeting that is scheduled for today."]},{"type":"para","id":"W5r7ySx89rzoFloHqHJ8h","margin":"","location":{"start":{"line":41,"column":1,"offset":2212},"end":{"line":41,"column":94,"offset":2305}},"text":"text","content":["There are some keyboard commands that can be used to override the automatic busy indications:"]},{"type":"para","id":"M5C3fVYX_81LYIE9kEgS2","margin":"","location":{"start":{"line":43,"column":1,"offset":2307},"end":{"line":43,"column":62,"offset":2368}},"text":"text","content":["The \"b\" command will turn the light(s) on (with a red light)."]},{"type":"para","id":"iecpMthb5nsBG_gB6AzWA","margin":"","location":{"start":{"line":45,"column":1,"offset":2370},"end":{"line":45,"column":67,"offset":2436}},"text":"text","content":["The \"o\" command will turn the light(s) off until the next meeting."]},{"type":"para","id":"tV81qNosy4a6TXMmUBpzq","margin":"","location":{"start":{"line":47,"column":1,"offset":2438},"end":{"line":47,"column":62,"offset":2499}},"text":"text","content":["The \"g\" command will turn the light on, but as a green light."]},{"type":"para","id":"plnCkh4EHRxaCcAaOL2cw","margin":"","location":{"start":{"line":49,"column":1,"offset":2501},"end":{"line":49,"column":52,"offset":2552}},"text":"text","content":["The \"n\" displays the next meeting on your calendar."]},{"type":"para","id":"DEImQbncjFeKGcVYAcUlh","margin":"","location":{"start":{"line":51,"column":1,"offset":2554},"end":{"line":51,"column":62,"offset":2615}},"text":"text","content":["The \"a\" shows you an \"agenda\" view of your upcoming meetings."]},{"type":"block","id":"ua619dS1DIZ8Atet679hE","margin":"","level":1,"name":"head","location":{"start":{"line":53,"column":1,"offset":2617},"end":{"line":53,"column":29,"offset":2645}},"content":["INSTALLATION PREREQUISITES"]},{"type":"para","id":"Fv261JAAHqbZSOUP2MiBs","margin":"","location":{"start":{"line":55,"column":1,"offset":2647},"end":{"line":55,"column":50,"offset":2696}},"text":"text","content":["You must have a Luxafor flag to use this program."]},{"type":"para","id":"RaPIhJdXoXhzcFfV_MiFp","margin":"","location":{"start":{"line":57,"column":1,"offset":2698},"end":{"line":57,"column":103,"offset":2800}},"text":"text","content":["You need relatively recent Raku to be installed. Download Raku for your OS from: ",{"meta":"https://www.raku.org/","type":"fcode","name":"L","content":["https://www.raku.org/"]}]},{"type":"para","id":"ZPF_cJ2-b1CrV900w_v36","margin":"","location":{"start":{"line":59,"column":1,"offset":2802},"end":{"line":59,"column":79,"offset":2880}},"text":"text","content":["You must install ",{"type":"fcode","name":"C","content":["LibUSB"]}," development libraries. On Ubuntu, this is done with:"]},{"type":"block","id":"IbWlIdjaQXUg95dhFKiNr","margin":"","name":"code","config":[],"location":{"start":{"line":61,"column":1,"offset":2882},"end":{"line":61,"column":42,"offset":2923}},"content":[{"type":"verbatim","value":"sudo apt-get install libusb-1.0-0-dev"}]},{"type":"para","id":"xAOg1kyq-EwcjUk-wO1II","margin":"","location":{"start":{"line":63,"column":1,"offset":2925},"end":{"line":63,"column":96,"offset":3020}},"text":"text","content":["You must also install ",{"type":"fcode","name":"C","content":["gcalcli"]}," if using the Google Calendar integration. To do that on Ubuntu:"]},{"type":"block","id":"dLUF0afsWT3V-bauZePtB","margin":"","name":"code","config":[],"location":{"start":{"line":65,"column":1,"offset":3022},"end":{"line":65,"column":33,"offset":3054}},"content":[{"type":"verbatim","value":"sudo apt-get install gcalcli"}]},{"type":"para","id":"-729Qpdwyq5U4xoadQyEC","margin":"","location":{"start":{"line":67,"column":1,"offset":3056},"end":{"line":67,"column":208,"offset":3263}},"text":"text","content":["Then you'll want to run gcalcli the first time, and log into Google with your proper credentials (the first time you run gcalcli, it'll open a browser for you to log into your Google account): gcalcli agenda"]},{"type":"para","id":"24kykK7CMDJy5tuiEAkxC","margin":"","location":{"start":{"line":69,"column":1,"offset":3265},"end":{"line":69,"column":157,"offset":3421}},"text":"text","content":["You must ensure that the Luxafor Flag is not bound to the ",{"type":"fcode","name":"C","content":["usbhid"]}," module. To do that on Ubuntu, create a file ",{"type":"fcode","name":"C","content":["/etc/modprobe.d/luxafor.conf"]}," that contains:"]},{"type":"block","id":"uZ_nG1DvVY8a67hfmBSPv","margin":"","name":"code","config":[],"location":{"start":{"line":71,"column":1,"offset":3423},"end":{"line":71,"column":47,"offset":3469}},"content":[{"type":"verbatim","value":"options usbhid quirks=0x04d8:0xf372:0x0004"}]},{"type":"para","id":"z2TuXptYNbDnsJuLmTZC5","margin":"","location":{"start":{"line":73,"column":1,"offset":3471},"end":{"line":73,"column":72,"offset":3542}},"text":"text","content":["You will need to reboot after making this change for it to take effect."]},{"type":"para","id":"E_dym8l4fjh1SomBxDZzX","margin":"","location":{"start":{"line":75,"column":1,"offset":3544},"end":{"line":75,"column":172,"offset":3715}},"text":"text","content":["If you wish to run this program as a standard user (highly recommended), you also need to create a file named ",{"type":"fcode","name":"C","content":["/etc/udev/rules.d/luxafor.rules"]}," with the following content:"]},{"type":"block","id":"1GlKxarOKN30-1nesK-Q2","margin":"","name":"code","config":[],"location":{"start":{"line":77,"column":1,"offset":3717},"end":{"line":77,"column":96,"offset":3812}},"content":[{"type":"verbatim","value":"SUBSYTEM==\"usb\", ATTR{idVendor}=\"04d8\", ATTR{idProduct}==\"f372\" MODE=\"0664\" OWNER=\"jmaslak\""}]},{"type":"para","id":"olaqA9H6f_1oD9ajz_cDV","margin":"","location":{"start":{"line":79,"column":1,"offset":3814},"end":{"line":79,"column":117,"offset":3930}},"text":"text","content":["Replace ",{"type":"fcode","name":"C","content":["jmaslak"]}," in the above file with your username. Then you will need to reboot for this change to take effect."]},{"type":"para","id":"kvws-c1gkyWHQ-7RbrmiR","margin":"","location":{"start":{"line":81,"column":1,"offset":3932},"end":{"line":81,"column":124,"offset":4055}},"text":"text","content":["As root (or another user depending on your Raku installation), you can install this package with: zef install BusyIndicator"]},{"type":"para","id":"-9wsi7haLwUZe-jEEfi3Z","margin":"","location":{"start":{"line":83,"column":1,"offset":4057},"end":{"line":83,"column":78,"offset":4134}},"text":"text","content":["Now you can run the script using \"busy-indicator-raku\" from the command line!"]},{"type":"block","id":"dPckxkw0NhQ_eu00kolGW","margin":"","level":1,"name":"head","location":{"start":{"line":85,"column":1,"offset":4136},"end":{"line":85,"column":12,"offset":4147}},"content":["COPYRIGHT"]},{"type":"para","id":"U4uS1HSLT84pQBslQN20i","margin":"","location":{"start":{"line":87,"column":1,"offset":4149},"end":{"line":87,"column":141,"offset":4289}},"text":"text","content":["Copyright © 2019-2023 Joelle Maslak This application is free software; you can distribute it and/or modify it under the Artistic License 2.0"]},{"type":"para","id":"SkN53Re8FLfyU8Zvq6QM1","margin":"","location":{"start":{"line":89,"column":1,"offset":4291},"end":{"line":89,"column":170,"offset":4460}},"text":"text","content":["Also included is a modified version of Travis Gibson's ",{"type":"fcode","name":"C","content":["LibUSB"]}," which has a copyright: Copyright © 2020 Travis Gibson It is also licensed under the Artistic License 2.0."]}]},"publishUrl":"/mods/zef/BusyIndicator/BusyIndicator-0.3.0/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"","auth":"zef:jmaslak","authors":["Joelle Maslak"],"build-depends":[],"depends":["LibUSB"],"description":"Luxafor Indicators based on Google Calendar and Webcam Status","dist":"BusyIndicator:ver<0.3.0>:auth<zef:jmaslak>","license":"Artistic-2.0","name":"BusyIndicator","path":"B/US/BUSYINDICATOR/8fc093b75648f2a5ba4ebeeff2e534e09d61d61e.tar.gz","perl":"6.d","provides":{"BusyIndicator":"lib/BusyIndicator.rakumod","BusyIndicator::LibUSB":"lib/BusyIndicator/LibUSB.rakumod","BusyIndicator::Luxafor":"lib/BusyIndicator/Luxafor.rakumod"},"resources":[],"source-url":"https://github.com/jmaslak/Raku-BusyIndicator.git","tags":[],"test-depends":[],"version":"0.3.0"},"files":[{"file":"work_mods/zef/BusyIndicator/BusyIndicator-0.3.0/README.md","publishUrl":"/mods/zef/BusyIndicator/BusyIndicator-0.3.0/README.md"},{"file":"work_mods/zef/BusyIndicator/BusyIndicator-0.3.0/CODE_OF_CONDUCT.md","publishUrl":"/mods/zef/BusyIndicator/BusyIndicator-0.3.0/CODE_OF_CONDUCT.md"},{"file":"work_mods/zef/BusyIndicator/BusyIndicator-0.3.0/bin/busy-indicator.rakudoc","publishUrl":"/mods/zef/BusyIndicator/BusyIndicator-0.3.0/bin/busy-indicator.rakudoc"},{"file":"work_mods/zef/BusyIndicator/BusyIndicator-0.3.0/lib/BusyIndicator.rakumod","publishUrl":"/mods/zef/BusyIndicator/BusyIndicator-0.3.0/lib/BusyIndicator.rakumod"},{"file":"work_mods/zef/BusyIndicator/BusyIndicator-0.3.0/lib/BusyIndicator/LibUSB.rakumod","publishUrl":"/mods/zef/BusyIndicator/BusyIndicator-0.3.0/lib/BusyIndicator/LibUSB.rakumod"}],"src":"zef","url":"/mods/zef/BusyIndicator"}}}
    =end data
    =end React


BusyIndicator


Simple codec for the BSON (Binary JSON) serialization format


=begin data
{"type":"page","file":"work_mods/zef/BSON::Simple/README.md","sources":[],"node":{"type":"block","id":"QEBVk5lIIuV9nfC7fEmMA","margin":"","name":"root","content":[{"type":"para","id":"DgUz8mItxtKbr0dz2Ab0y","margin":"","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":129,"offset":128}},"text":"text","content":[{"meta":"https://github.com/japhb/BSON-Simple/actions","type":"fcode","name":"L","content":[{"type":"block","id":"1_IcHL-4dIKM6KY0E7vmL","margin":"","name":"Image","config":[],"location":{"start":{"line":1,"column":2,"offset":1},"end":{"line":1,"column":82,"offset":81}},"content":[{"type":"image","src":"https://github.com/japhb/BSON-Simple/workflows/test/badge.svg","alt":"Actions Status"}]}]}]},{"type":"block","id":"4U3p49X39UYMTpLvVl34w","margin":"","level":1,"name":"head","location":{"start":{"line":3,"column":1,"offset":130},"end":{"line":3,"column":7,"offset":136}},"content":["NAME"]},{"type":"para","id":"3AonWgbJkFhPp-q8diAEO","margin":"","location":{"start":{"line":5,"column":1,"offset":138},"end":{"line":5,"column":76,"offset":213}},"text":"text","content":["BSON::Simple - Simple codec for the BSON (Binary JSON) serialization format"]},{"type":"block","id":"yTc1a9tyEXAhnDOWcVYSf","margin":"","level":1,"name":"head","location":{"start":{"line":7,"column":1,"offset":215},"end":{"line":7,"column":11,"offset":225}},"content":["SYNOPSIS"]},{"type":"block","id":"1SuvJo33dlw1foLGzES1U","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":9,"column":1,"offset":227},"end":{"line":27,"column":4,"offset":998}},"content":[{"type":"verbatim","value":"use BSON::Simple;\n\n# Encode a Raku value to BSON, or vice-versa\nmy $bson = bson-encode($value);\nmy $val1 = bson-decode($bson);              # Dies if more data past first decoded document\nmy $val2 = bson-decode($bson, my $pos = 0); # Updates $pos after decoding first document\n\n# Request warnings when decoding deprecated BSON element types\n# (default is to ignore deprecations and handle all known element types)\nmy $*BSON_SIMPLE_WARN_DEPRECATED = True;\nmy $bad  = bson-decode($deprecated);     # Warns, but returns decoding anyway\n\n# Decode into default Raku Hash and Blob types, instead of ordered hashes\n# and wrapped BSON::Simple::Binary objects\nmy $*BSON_SIMPLE_PLAIN_HASHES = True;\nmy $*BSON_SIMPLE_PLAIN_BLOBS  = True;\nmy $simple = bson-decode($bson);"}]},{"type":"block","id":"JFiUZ2oJx4v4DueJrYQLT","margin":"","level":1,"name":"head","location":{"start":{"line":29,"column":1,"offset":1000},"end":{"line":29,"column":14,"offset":1013}},"content":["DESCRIPTION"]},{"type":"para","id":"Bzc8CglfD6q_Vd85WuY81","margin":"","location":{"start":{"line":31,"column":1,"offset":1015},"end":{"line":31,"column":242,"offset":1256}},"text":"text","content":["BSON::Simple is a trivial implementation of the core functionality of the ",{"meta":"https://bsonspec.org/","type":"fcode","name":"L","content":["BSON serialization format"]},", used as the primary data format of the ",{"meta":"https://en.wikipedia.org/wiki/MongoDB","type":"fcode","name":"L","content":["MongoDB document-oriented database"]},"."]},{"type":"para","id":"vNmLyGnZJGnNb5h6XUu8X","margin":"","location":{"start":{"line":33,"column":1,"offset":1258},"end":{"line":33,"column":281,"offset":1538}},"text":"text","content":["Note that because it is important to retain key order, BSON maps are decoded as ordered hashes using the Hash::Ordered module. Likewise, several BSON types that must maintain a distinction from Raku's standard types are decoded into objects that do the BSON::Simple::Special role."]},{"type":"para","id":"15KV_8adVZroCa2RGJukm","margin":"","location":{"start":{"line":35,"column":1,"offset":1540},"end":{"line":35,"column":367,"offset":1906}},"text":"text","content":["If you would prefer to decode into standard (unordered) Raku hashes, you can set the ",{"type":"fcode","name":"C","content":["$*BSON_SIMPLE_PLAIN_HASHES"]}," dynamic variable to ",{"type":"fcode","name":"C","content":["True"]},". Likewise, if you would prefer to decode default-subtype Binary fields into plain Raku ",{"type":"fcode","name":"C","content":["Blob"]}," objects (rather than wrapped into a ",{"type":"fcode","name":"C","content":["BSON::Simple::Binary"]}," object), set the ",{"type":"fcode","name":"C","content":["$*BSON_SIMPLE_PLAIN_BLOBS"]}," dynamic variable to ",{"type":"fcode","name":"C","content":["True"]},"."]},{"type":"block","id":"PicDXHscINLq_hYGp9zXf","margin":"","level":1,"name":"head","location":{"start":{"line":37,"column":1,"offset":1908},"end":{"line":37,"column":10,"offset":1917}},"content":["CAVEATS"]},{"type":"list","id":"FxEBaOhuYn8rbgkFcXzsW","margin":"","level":1,"list":"itemized","content":[{"type":"block","id":"C9FJ9Pkjk5UwZTWX4fKsf","margin":"","name":"item","level":1,"location":{"start":{"line":39,"column":1,"offset":1919},"end":{"line":39,"column":43,"offset":1961}},"content":[{"type":"para","id":"iEBeSgti8N9vJZdGVp9mw","margin":"","location":{"start":{"line":39,"column":3,"offset":1921},"end":{"line":39,"column":43,"offset":1961}},"text":"text","content":["Does not support the Decimal128 type yet"]}]}]},{"type":"block","id":"mHzV0jWIVFi45uvEgjKhr","margin":"","level":1,"name":"head","location":{"start":{"line":41,"column":1,"offset":1963},"end":{"line":41,"column":10,"offset":1972}},"content":["RELATED"]},{"type":"para","id":"MJEnmbbTp-ujHygXtp51j","margin":"","location":{"start":{"line":43,"column":1,"offset":1974},"end":{"line":43,"column":556,"offset":2529}},"text":"text","content":["The older ",{"meta":"https://raku.land/cpan:MARTIMM/BSON","type":"fcode","name":"L","content":["BSON Raku module"]}," also implements the BSON format. It has a much more detailed API, making it considerably more verbose in actual usage than BSON::Simple. It is also more difficult to adapt as one optional encoding among many for a generic data service (which might serve CSV, JSON, CBOR, and BSON, for example). Finally, its internal design makes it somewhat more difficult to optimize, as it was written before modern buffer handling was added to Raku and before parallelism overhead was fully understood."]},{"type":"para","id":"LbuC-qnyVFdqSNISS0_Ll","margin":"","location":{"start":{"line":45,"column":1,"offset":2531},"end":{"line":45,"column":150,"offset":2680}},"text":"text","content":["On the other hand, that original BSON module has a decade of real world testing and many hundreds of commits behind it, and this module is brand new."]},{"type":"para","id":"ju25lpavZocviDVOBrr_s","margin":"","location":{"start":{"line":47,"column":1,"offset":2682},"end":{"line":47,"column":135,"offset":2816}},"text":"text","content":["To see how this module compares to other data serialization modules, see ",{"meta":"https://github.com/japhb/serializer-perf","type":"fcode","name":"L","content":["serializer-perf"]}," ."]},{"type":"block","id":"YQZqssBjy7xpLDLcM3l_C","margin":"","level":1,"name":"head","location":{"start":{"line":49,"column":1,"offset":2818},"end":{"line":49,"column":9,"offset":2826}},"content":["AUTHOR"]},{"type":"para","id":"GclI39PMO5TtrzT_hjfch","margin":"","location":{"start":{"line":51,"column":1,"offset":2828},"end":{"line":51,"column":35,"offset":2862}},"text":"text","content":["Geoffrey Broadwell ",{"meta":"mailto:gjb@sonic.net","type":"fcode","name":"L","content":["gjb@sonic.net"]}]},{"type":"block","id":"EZSbvpV8iP7Y9c9kdv6wk","margin":"","level":1,"name":"head","location":{"start":{"line":53,"column":1,"offset":2864},"end":{"line":53,"column":24,"offset":2887}},"content":["COPYRIGHT AND LICENSE"]},{"type":"para","id":"xCdQk0S6BbkALFB4ePt7C","margin":"","location":{"start":{"line":55,"column":1,"offset":2889},"end":{"line":55,"column":34,"offset":2922}},"text":"text","content":["Copyright 2021 Geoffrey Broadwell"]},{"type":"para","id":"8ZvG7_8JBRH6uH2eifzvk","margin":"","location":{"start":{"line":57,"column":1,"offset":2924},"end":{"line":57,"column":104,"offset":3027}},"text":"text","content":["This library is free software; you can redistribute it and/or modify it under the Artistic License 2.0."]}]},"publishUrl":"/mods/zef/BSON::Simple/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"","auth":"zef:japhb","authors":["Geoffrey Broadwell"],"build-depends":[],"depends":["Base64::Native","Hash::Ordered"],"description":"Simple codec for the BSON (Binary JSON) serialization format","dist":"BSON::Simple:ver<0.0.1>:auth<zef:japhb>","license":"Artistic-2.0","name":"BSON::Simple","path":"B/SO/BSON_SIMPLE/c4b7309e010116e6083141a0d866c0f16a868f16.tar.gz","perl":"6.d","provides":{"BSON::Simple":"lib/BSON/Simple.rakumod"},"resources":[],"source-url":"https://github.com/japhb/BSON-Simple.git","tags":[],"test-depends":[],"version":"0.0.1"},"files":[{"file":"work_mods/zef/BSON::Simple/README.md","publishUrl":"/mods/zef/BSON::Simple/README.md"},{"file":"work_mods/zef/BSON::Simple/lib/BSON/Simple.rakumod","publishUrl":"/mods/zef/BSON::Simple/lib/BSON/Simple.rakumod"}],"src":"zef","url":"/mods/zef/BSON::Simple"}}}
=end data


    =begin React :component<RenderItem>
    =begin data
    {"type":"page","file":"work_mods/zef/BSON::Simple/README.md","sources":[],"node":{"type":"block","id":"QEBVk5lIIuV9nfC7fEmMA","margin":"","name":"root","content":[{"type":"para","id":"DgUz8mItxtKbr0dz2Ab0y","margin":"","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":129,"offset":128}},"text":"text","content":[{"meta":"https://github.com/japhb/BSON-Simple/actions","type":"fcode","name":"L","content":[{"type":"block","id":"1_IcHL-4dIKM6KY0E7vmL","margin":"","name":"Image","config":[],"location":{"start":{"line":1,"column":2,"offset":1},"end":{"line":1,"column":82,"offset":81}},"content":[{"type":"image","src":"https://github.com/japhb/BSON-Simple/workflows/test/badge.svg","alt":"Actions Status"}]}]}]},{"type":"block","id":"4U3p49X39UYMTpLvVl34w","margin":"","level":1,"name":"head","location":{"start":{"line":3,"column":1,"offset":130},"end":{"line":3,"column":7,"offset":136}},"content":["NAME"]},{"type":"para","id":"3AonWgbJkFhPp-q8diAEO","margin":"","location":{"start":{"line":5,"column":1,"offset":138},"end":{"line":5,"column":76,"offset":213}},"text":"text","content":["BSON::Simple - Simple codec for the BSON (Binary JSON) serialization format"]},{"type":"block","id":"yTc1a9tyEXAhnDOWcVYSf","margin":"","level":1,"name":"head","location":{"start":{"line":7,"column":1,"offset":215},"end":{"line":7,"column":11,"offset":225}},"content":["SYNOPSIS"]},{"type":"block","id":"1SuvJo33dlw1foLGzES1U","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":9,"column":1,"offset":227},"end":{"line":27,"column":4,"offset":998}},"content":[{"type":"verbatim","value":"use BSON::Simple;\n\n# Encode a Raku value to BSON, or vice-versa\nmy $bson = bson-encode($value);\nmy $val1 = bson-decode($bson);              # Dies if more data past first decoded document\nmy $val2 = bson-decode($bson, my $pos = 0); # Updates $pos after decoding first document\n\n# Request warnings when decoding deprecated BSON element types\n# (default is to ignore deprecations and handle all known element types)\nmy $*BSON_SIMPLE_WARN_DEPRECATED = True;\nmy $bad  = bson-decode($deprecated);     # Warns, but returns decoding anyway\n\n# Decode into default Raku Hash and Blob types, instead of ordered hashes\n# and wrapped BSON::Simple::Binary objects\nmy $*BSON_SIMPLE_PLAIN_HASHES = True;\nmy $*BSON_SIMPLE_PLAIN_BLOBS  = True;\nmy $simple = bson-decode($bson);"}]},{"type":"block","id":"JFiUZ2oJx4v4DueJrYQLT","margin":"","level":1,"name":"head","location":{"start":{"line":29,"column":1,"offset":1000},"end":{"line":29,"column":14,"offset":1013}},"content":["DESCRIPTION"]},{"type":"para","id":"Bzc8CglfD6q_Vd85WuY81","margin":"","location":{"start":{"line":31,"column":1,"offset":1015},"end":{"line":31,"column":242,"offset":1256}},"text":"text","content":["BSON::Simple is a trivial implementation of the core functionality of the ",{"meta":"https://bsonspec.org/","type":"fcode","name":"L","content":["BSON serialization format"]},", used as the primary data format of the ",{"meta":"https://en.wikipedia.org/wiki/MongoDB","type":"fcode","name":"L","content":["MongoDB document-oriented database"]},"."]},{"type":"para","id":"vNmLyGnZJGnNb5h6XUu8X","margin":"","location":{"start":{"line":33,"column":1,"offset":1258},"end":{"line":33,"column":281,"offset":1538}},"text":"text","content":["Note that because it is important to retain key order, BSON maps are decoded as ordered hashes using the Hash::Ordered module. Likewise, several BSON types that must maintain a distinction from Raku's standard types are decoded into objects that do the BSON::Simple::Special role."]},{"type":"para","id":"15KV_8adVZroCa2RGJukm","margin":"","location":{"start":{"line":35,"column":1,"offset":1540},"end":{"line":35,"column":367,"offset":1906}},"text":"text","content":["If you would prefer to decode into standard (unordered) Raku hashes, you can set the ",{"type":"fcode","name":"C","content":["$*BSON_SIMPLE_PLAIN_HASHES"]}," dynamic variable to ",{"type":"fcode","name":"C","content":["True"]},". Likewise, if you would prefer to decode default-subtype Binary fields into plain Raku ",{"type":"fcode","name":"C","content":["Blob"]}," objects (rather than wrapped into a ",{"type":"fcode","name":"C","content":["BSON::Simple::Binary"]}," object), set the ",{"type":"fcode","name":"C","content":["$*BSON_SIMPLE_PLAIN_BLOBS"]}," dynamic variable to ",{"type":"fcode","name":"C","content":["True"]},"."]},{"type":"block","id":"PicDXHscINLq_hYGp9zXf","margin":"","level":1,"name":"head","location":{"start":{"line":37,"column":1,"offset":1908},"end":{"line":37,"column":10,"offset":1917}},"content":["CAVEATS"]},{"type":"list","id":"FxEBaOhuYn8rbgkFcXzsW","margin":"","level":1,"list":"itemized","content":[{"type":"block","id":"C9FJ9Pkjk5UwZTWX4fKsf","margin":"","name":"item","level":1,"location":{"start":{"line":39,"column":1,"offset":1919},"end":{"line":39,"column":43,"offset":1961}},"content":[{"type":"para","id":"iEBeSgti8N9vJZdGVp9mw","margin":"","location":{"start":{"line":39,"column":3,"offset":1921},"end":{"line":39,"column":43,"offset":1961}},"text":"text","content":["Does not support the Decimal128 type yet"]}]}]},{"type":"block","id":"mHzV0jWIVFi45uvEgjKhr","margin":"","level":1,"name":"head","location":{"start":{"line":41,"column":1,"offset":1963},"end":{"line":41,"column":10,"offset":1972}},"content":["RELATED"]},{"type":"para","id":"MJEnmbbTp-ujHygXtp51j","margin":"","location":{"start":{"line":43,"column":1,"offset":1974},"end":{"line":43,"column":556,"offset":2529}},"text":"text","content":["The older ",{"meta":"https://raku.land/cpan:MARTIMM/BSON","type":"fcode","name":"L","content":["BSON Raku module"]}," also implements the BSON format. It has a much more detailed API, making it considerably more verbose in actual usage than BSON::Simple. It is also more difficult to adapt as one optional encoding among many for a generic data service (which might serve CSV, JSON, CBOR, and BSON, for example). Finally, its internal design makes it somewhat more difficult to optimize, as it was written before modern buffer handling was added to Raku and before parallelism overhead was fully understood."]},{"type":"para","id":"LbuC-qnyVFdqSNISS0_Ll","margin":"","location":{"start":{"line":45,"column":1,"offset":2531},"end":{"line":45,"column":150,"offset":2680}},"text":"text","content":["On the other hand, that original BSON module has a decade of real world testing and many hundreds of commits behind it, and this module is brand new."]},{"type":"para","id":"ju25lpavZocviDVOBrr_s","margin":"","location":{"start":{"line":47,"column":1,"offset":2682},"end":{"line":47,"column":135,"offset":2816}},"text":"text","content":["To see how this module compares to other data serialization modules, see ",{"meta":"https://github.com/japhb/serializer-perf","type":"fcode","name":"L","content":["serializer-perf"]}," ."]},{"type":"block","id":"YQZqssBjy7xpLDLcM3l_C","margin":"","level":1,"name":"head","location":{"start":{"line":49,"column":1,"offset":2818},"end":{"line":49,"column":9,"offset":2826}},"content":["AUTHOR"]},{"type":"para","id":"GclI39PMO5TtrzT_hjfch","margin":"","location":{"start":{"line":51,"column":1,"offset":2828},"end":{"line":51,"column":35,"offset":2862}},"text":"text","content":["Geoffrey Broadwell ",{"meta":"mailto:gjb@sonic.net","type":"fcode","name":"L","content":["gjb@sonic.net"]}]},{"type":"block","id":"EZSbvpV8iP7Y9c9kdv6wk","margin":"","level":1,"name":"head","location":{"start":{"line":53,"column":1,"offset":2864},"end":{"line":53,"column":24,"offset":2887}},"content":["COPYRIGHT AND LICENSE"]},{"type":"para","id":"xCdQk0S6BbkALFB4ePt7C","margin":"","location":{"start":{"line":55,"column":1,"offset":2889},"end":{"line":55,"column":34,"offset":2922}},"text":"text","content":["Copyright 2021 Geoffrey Broadwell"]},{"type":"para","id":"8ZvG7_8JBRH6uH2eifzvk","margin":"","location":{"start":{"line":57,"column":1,"offset":2924},"end":{"line":57,"column":104,"offset":3027}},"text":"text","content":["This library is free software; you can redistribute it and/or modify it under the Artistic License 2.0."]}]},"publishUrl":"/mods/zef/BSON::Simple/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"","auth":"zef:japhb","authors":["Geoffrey Broadwell"],"build-depends":[],"depends":["Base64::Native","Hash::Ordered"],"description":"Simple codec for the BSON (Binary JSON) serialization format","dist":"BSON::Simple:ver<0.0.1>:auth<zef:japhb>","license":"Artistic-2.0","name":"BSON::Simple","path":"B/SO/BSON_SIMPLE/c4b7309e010116e6083141a0d866c0f16a868f16.tar.gz","perl":"6.d","provides":{"BSON::Simple":"lib/BSON/Simple.rakumod"},"resources":[],"source-url":"https://github.com/japhb/BSON-Simple.git","tags":[],"test-depends":[],"version":"0.0.1"},"files":[{"file":"work_mods/zef/BSON::Simple/README.md","publishUrl":"/mods/zef/BSON::Simple/README.md"},{"file":"work_mods/zef/BSON::Simple/lib/BSON/Simple.rakumod","publishUrl":"/mods/zef/BSON::Simple/lib/BSON/Simple.rakumod"}],"src":"zef","url":"/mods/zef/BSON::Simple"}}}
    =end data
    =end React


BSON::Simple


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


BTree

NAME

SYNOPSIS

DESCRIPTION

AUTHOR

COPYRIGHT AND LICENSE

BTree v0.0.1

Authors

License

Dependencies

Test Dependencies

Provides

Documentation