TITLE

Expedient CPAN distribution packager and uploader


SUBTITLE

data

=begin data
{"type":"page","file":"work_mods/zef/Igo/Igo-0.0.8/README.md","sources":[],"node":{"type":"block","id":"lHzRTXA55AZNTzqAMKjFK","margin":"","name":"root","content":[{"type":"block","id":"JvSaItX1KatFJ6yLPYOjh","margin":"","level":1,"name":"head","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":6,"offset":5}},"content":["Igo"]},{"type":"para","id":"8xHkqJulYGj8_SMR3OXqu","margin":"","location":{"start":{"line":3,"column":1,"offset":7},"end":{"line":3,"column":36,"offset":42}},"text":"text","content":["An expedient CPAN uploader for Raku"]},{"type":"para","id":"dS4Z-NbURjgwJ1fcqrEDS","margin":"","location":{"start":{"line":5,"column":1,"offset":44},"end":{"line":5,"column":77,"offset":120}},"text":"text","content":[{"type":"block","id":"aYyK462BjDCHXq7GNLMZm","margin":"","name":"Image","config":[],"location":{"start":{"line":5,"column":1,"offset":44},"end":{"line":5,"column":77,"offset":120}},"content":[{"type":"image","src":"https://github.com/jonathanstowe/Igo/workflows/CI/badge.svg","alt":"Build Status"}]}]},{"type":"block","id":"AFKpC9eAeI8RKISBmgsm7","margin":"","level":2,"name":"head","location":{"start":{"line":7,"column":1,"offset":122},"end":{"line":7,"column":12,"offset":133}},"content":["Synopsis"]},{"type":"block","id":"wFpw9Du7eI-0faKc6xoJ_","margin":"","name":"code","config":[],"location":{"start":{"line":9,"column":1,"offset":135},"end":{"line":11,"column":68,"offset":280}},"content":[{"type":"verbatim","value":"igo create-layout [--directory=.]\nigo create-archive  [--directory=.]\nigo upload --user=<user> --password=<password>  [--directory=.]"}]},{"type":"block","id":"wbMYtPzZKqF3FvdnYEaM-","margin":"","level":2,"name":"head","location":{"start":{"line":13,"column":1,"offset":282},"end":{"line":13,"column":15,"offset":296}},"content":["Description"]},{"type":"para","id":"NbdyJkFGCspnrUSW63P-B","margin":"","location":{"start":{"line":15,"column":1,"offset":298},"end":{"line":15,"column":59,"offset":356}},"text":"text","content":["This provides a simple way to upload Raku modules to CPAN."]},{"type":"para","id":"lquaqSJM34jptYfis2pgF","margin":"","location":{"start":{"line":17,"column":1,"offset":358},"end":{"line":18,"column":31,"offset":459}},"text":"text","content":["I made it because I found that other things either took over the whole\nworkflow, or didn't do enough."]},{"type":"para","id":"mZmE6szIETll0CNAKatRf","margin":"","location":{"start":{"line":20,"column":1,"offset":461},"end":{"line":22,"column":44,"offset":647}},"text":"text","content":["So all this does is create a tarball of the files in the distribution,\nusing the name and version specified in the META6 file and then uploads\nit to PAUSE with the credentials specified."]},{"type":"para","id":"QuFJSV3_JhXxFtLBjJ7pK","margin":"","location":{"start":{"line":24,"column":1,"offset":649},"end":{"line":30,"column":61,"offset":1129}},"text":"text","content":["The way this works is that the first time it runs it creates an\n",{"meta":"https://github.com/jonathanstowe/Oyatul","type":"fcode","name":"L","content":["Oyatul"]}," layout specification\nin your distribution's directory as ",{"type":"fcode","name":"C","content":[".layout"]}," this will contain all\nof the files found in the directory which don't begin with a '.', now\nif you're anything like me you may have your working directory littered\nwith test files and backups and so forth so you may want to edit this file\nbefore creating the archive, this can be achieved by running"]},{"type":"block","id":"kcR8hxyKjN60ZomPdZoMX","margin":"","name":"code","config":[],"location":{"start":{"line":32,"column":1,"offset":1131},"end":{"line":34,"column":4,"offset":1156}},"content":[{"type":"verbatim","value":"igo create-layout"}]},{"type":"para","id":"OPK15VsV3HVzRG9nalxXx","margin":"","location":{"start":{"line":36,"column":1,"offset":1158},"end":{"line":39,"column":30,"offset":1395}},"text":"text","content":["When you have all the files that you want to release and then edit\nthe ",{"type":"fcode","name":"C","content":[".layout"]}," as required (it's JSON and quite obvious,) to remove\nextraneous files (or, if you want to distribute dot files that didn't get\nadded for instance add them.)"]},{"type":"para","id":"d7i6prWBec0QkIbBybAiv","margin":"","location":{"start":{"line":41,"column":1,"offset":1397},"end":{"line":42,"column":48,"offset":1516}},"text":"text","content":["If you want to check that you really have all the files you need in the\narchive that would be uploaded then you can run"]},{"type":"block","id":"TPau9Y51jwSZfIWogzu0C","margin":"","name":"code","config":[],"location":{"start":{"line":44,"column":1,"offset":1518},"end":{"line":46,"column":4,"offset":1544}},"content":[{"type":"verbatim","value":"igo create-archive"}]},{"type":"para","id":"3rsrWlILXjW6HNMlDdKoM","margin":"","location":{"start":{"line":48,"column":1,"offset":1546},"end":{"line":48,"column":37,"offset":1582}},"text":"text","content":["and inspect and test as you see fit."]},{"type":"para","id":"VoVWlwHUva_F4T-og2l_c","margin":"","location":{"start":{"line":50,"column":1,"offset":1584},"end":{"line":51,"column":3,"offset":1657}},"text":"text","content":["When you are all happy with what you are going to upload then you just\ndo"]},{"type":"block","id":"m6CRX5638YFXKQsTrfgyO","margin":"","name":"code","config":[],"location":{"start":{"line":53,"column":1,"offset":1659},"end":{"line":55,"column":4,"offset":1733}},"content":[{"type":"verbatim","value":"igo upload --username=<PAUSE username> --password=<PAUSE password>"}]},{"type":"para","id":"R5ryzkoBRKQsLyxBwggA5","margin":"","location":{"start":{"line":57,"column":1,"offset":1735},"end":{"line":57,"column":75,"offset":1809}},"text":"text","content":["Which will create the archive and upload it with the credentials supplied."]},{"type":"para","id":"G_rJBiJ5pjNCJu3oROT0v","margin":"","location":{"start":{"line":59,"column":1,"offset":1811},"end":{"line":60,"column":61,"offset":1946}},"text":"text","content":["If you don't want to continuously type the credentials at the command line\nyou can create the file ",{"type":"fcode","name":"C","content":["$HOME/.config/igo/pause.ini"]}," with :"]},{"type":"block","id":"nzrZOLMQsQCf6EXje-Ppq","margin":"","name":"code","config":[],"location":{"start":{"line":62,"column":1,"offset":1948},"end":{"line":65,"column":4,"offset":1991}},"content":[{"type":"verbatim","value":"user <username>\npassword <password>"}]},{"type":"para","id":"E7EpcgUyKvlace8-sRTbN","margin":"","location":{"start":{"line":67,"column":1,"offset":1993},"end":{"line":69,"column":65,"offset":2191}},"text":"text","content":["If you are unhappy with having your password in plaintext then\n",{"meta":"https://github.com/Leont/cpan-upload-tiny","type":"fcode","name":"L","content":["CPAN::Uploader::Tiny"]}," does\nsupport encrypted files, but you can work that our for yourself."]},{"type":"para","id":"1F_xSSF2x0HlWjqUCBST0","margin":"","location":{"start":{"line":71,"column":1,"offset":2193},"end":{"line":72,"column":45,"offset":2300}},"text":"text","content":["Please feel free to use the ",{"type":"fcode","name":"C","content":["Igo"]}," module in your own code, but\nit isn't well documented for the time being."]},{"type":"block","id":"Ab6PcGqfrOrF6uhpgh59B","margin":"","level":2,"name":"head","location":{"start":{"line":74,"column":1,"offset":2302},"end":{"line":74,"column":16,"offset":2317}},"content":["Installation"]},{"type":"para","id":"0jAkn23Zh7GF6gI5q2WOh","margin":"","location":{"start":{"line":76,"column":1,"offset":2319},"end":{"line":76,"column":286,"offset":2604}},"text":"text","content":["This uses ",{"meta":"https://modules.raku.org/dist/Archive::Libarchive:cpan:FRITH","type":"fcode","name":"L","content":["Archive::LibArchive"]}," to make the tarball to upload, so you will need to have ",{"type":"fcode","name":"C","content":["libarchive"]}," installed, either via your platform's package manager or by some other means. I don't know if it is available for Windows."]},{"type":"para","id":"7tmq6OFyhZgPRrQJOmwEp","margin":"","location":{"start":{"line":78,"column":1,"offset":2606},"end":{"line":78,"column":96,"offset":2701}},"text":"text","content":["Assuming you have a working Rakudo installation you should be able to install this with ",{"type":"fcode","name":"I","content":["zef"]}," :"]},{"type":"block","id":"k3iCxnrdklzDJxlPurqGp","margin":"","name":"code","config":[],"location":{"start":{"line":80,"column":1,"offset":2703},"end":{"line":86,"column":20,"offset":2801}},"content":[{"type":"verbatim","value":"# From the source directory\n\nzef install .\n\n# Remote installation\n\nzef install Igo"}]},{"type":"block","id":"yFkiKUUjsV4LhLGuIKDrr","margin":"","level":2,"name":"head","location":{"start":{"line":88,"column":1,"offset":2803},"end":{"line":88,"column":11,"offset":2813}},"content":["Support"]},{"type":"para","id":"4PrBS4zqgbG82fGtHDG-a","margin":"","location":{"start":{"line":90,"column":1,"offset":2815},"end":{"line":90,"column":99,"offset":2913}},"text":"text","content":["Suggestions and patches that may make this more useful in your software are welcomed via github at"]},{"type":"para","id":"WHcQQD8POLeRSgBSLlADW","margin":"","location":{"start":{"line":92,"column":1,"offset":2915},"end":{"line":92,"column":44,"offset":2958}},"text":"text","content":[{"meta":"https://github.com/jonathanstowe/Igo/issues","type":"fcode","name":"L","content":["https://github.com/jonathanstowe/Igo/issues"]}]},{"type":"block","id":"Gu04syqfi2PbqlOB6-qIf","margin":"","level":2,"name":"head","location":{"start":{"line":94,"column":1,"offset":2960},"end":{"line":94,"column":11,"offset":2970}},"content":["Licence"]},{"type":"para","id":"PR0oDmyOjvHioCac-8h53","margin":"","location":{"start":{"line":96,"column":1,"offset":2972},"end":{"line":96,"column":23,"offset":2994}},"text":"text","content":["This is free software."]},{"type":"para","id":"D22VNmWIyWTdXmE_arCcS","margin":"","location":{"start":{"line":98,"column":1,"offset":2996},"end":{"line":98,"column":60,"offset":3055}},"text":"text","content":["Please see the ",{"meta":"LICENCE","type":"fcode","name":"L","content":["LICENCE"]}," file in the distribution."]},{"type":"para","id":"RG6iuNAcHgKjnquDMhEB5","margin":"","location":{"start":{"line":100,"column":1,"offset":3057},"end":{"line":100,"column":29,"offset":3085}},"text":"text","content":["© Jonathan Stowe 2019 - 2021"]}]},"publishUrl":"/mods/zef/Igo/Igo-0.0.8/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"1.0","auth":"zef:jonathanstowe","authors":["Jonathan Stowe <jns+gh@gellyfish.co.uk>"],"build-depends":[],"depends":{"build":{"requires":[]},"runtime":{"requires":["Archive::Libarchive","CPAN::Uploader::Tiny","META6","Oyatul","XDG::BaseDirectory"]}},"description":"Expedient CPAN distribution packager and uploader","dist":"Igo:ver<0.0.8>:auth<zef:jonathanstowe>","license":"Artistic-2.0","meta-version":"1","name":"Igo","path":"I/GO/IGO/33f3bead817cfe110dac5a1da791b8b316811710.tar.gz","provides":{"Igo":"lib/Igo.rakumod"},"raku":"6.*","resources":[],"source-url":"git://github.com/jonathanstowe/Igo.git","support":{"bugtracker":"https://github.com/jonathanstowe/Igo/issues","email":"jns+gh@gellyfish.co.uk","source":"git://github.com/jonathanstowe/Igo.git"},"tags":["cpan6","packager","uploader"],"test-depends":[],"version":"0.0.8"},"files":[{"file":"work_mods/zef/Igo/Igo-0.0.8/README.md","publishUrl":"/mods/zef/Igo/Igo-0.0.8/README.md"}],"src":"zef","url":"/mods/zef/Igo"}}}
=end data


React

    =begin React :component<RenderItem>
    =begin data
    {"type":"page","file":"work_mods/zef/Igo/Igo-0.0.8/README.md","sources":[],"node":{"type":"block","id":"lHzRTXA55AZNTzqAMKjFK","margin":"","name":"root","content":[{"type":"block","id":"JvSaItX1KatFJ6yLPYOjh","margin":"","level":1,"name":"head","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":6,"offset":5}},"content":["Igo"]},{"type":"para","id":"8xHkqJulYGj8_SMR3OXqu","margin":"","location":{"start":{"line":3,"column":1,"offset":7},"end":{"line":3,"column":36,"offset":42}},"text":"text","content":["An expedient CPAN uploader for Raku"]},{"type":"para","id":"dS4Z-NbURjgwJ1fcqrEDS","margin":"","location":{"start":{"line":5,"column":1,"offset":44},"end":{"line":5,"column":77,"offset":120}},"text":"text","content":[{"type":"block","id":"aYyK462BjDCHXq7GNLMZm","margin":"","name":"Image","config":[],"location":{"start":{"line":5,"column":1,"offset":44},"end":{"line":5,"column":77,"offset":120}},"content":[{"type":"image","src":"https://github.com/jonathanstowe/Igo/workflows/CI/badge.svg","alt":"Build Status"}]}]},{"type":"block","id":"AFKpC9eAeI8RKISBmgsm7","margin":"","level":2,"name":"head","location":{"start":{"line":7,"column":1,"offset":122},"end":{"line":7,"column":12,"offset":133}},"content":["Synopsis"]},{"type":"block","id":"wFpw9Du7eI-0faKc6xoJ_","margin":"","name":"code","config":[],"location":{"start":{"line":9,"column":1,"offset":135},"end":{"line":11,"column":68,"offset":280}},"content":[{"type":"verbatim","value":"igo create-layout [--directory=.]\nigo create-archive  [--directory=.]\nigo upload --user=<user> --password=<password>  [--directory=.]"}]},{"type":"block","id":"wbMYtPzZKqF3FvdnYEaM-","margin":"","level":2,"name":"head","location":{"start":{"line":13,"column":1,"offset":282},"end":{"line":13,"column":15,"offset":296}},"content":["Description"]},{"type":"para","id":"NbdyJkFGCspnrUSW63P-B","margin":"","location":{"start":{"line":15,"column":1,"offset":298},"end":{"line":15,"column":59,"offset":356}},"text":"text","content":["This provides a simple way to upload Raku modules to CPAN."]},{"type":"para","id":"lquaqSJM34jptYfis2pgF","margin":"","location":{"start":{"line":17,"column":1,"offset":358},"end":{"line":18,"column":31,"offset":459}},"text":"text","content":["I made it because I found that other things either took over the whole\nworkflow, or didn't do enough."]},{"type":"para","id":"mZmE6szIETll0CNAKatRf","margin":"","location":{"start":{"line":20,"column":1,"offset":461},"end":{"line":22,"column":44,"offset":647}},"text":"text","content":["So all this does is create a tarball of the files in the distribution,\nusing the name and version specified in the META6 file and then uploads\nit to PAUSE with the credentials specified."]},{"type":"para","id":"QuFJSV3_JhXxFtLBjJ7pK","margin":"","location":{"start":{"line":24,"column":1,"offset":649},"end":{"line":30,"column":61,"offset":1129}},"text":"text","content":["The way this works is that the first time it runs it creates an\n",{"meta":"https://github.com/jonathanstowe/Oyatul","type":"fcode","name":"L","content":["Oyatul"]}," layout specification\nin your distribution's directory as ",{"type":"fcode","name":"C","content":[".layout"]}," this will contain all\nof the files found in the directory which don't begin with a '.', now\nif you're anything like me you may have your working directory littered\nwith test files and backups and so forth so you may want to edit this file\nbefore creating the archive, this can be achieved by running"]},{"type":"block","id":"kcR8hxyKjN60ZomPdZoMX","margin":"","name":"code","config":[],"location":{"start":{"line":32,"column":1,"offset":1131},"end":{"line":34,"column":4,"offset":1156}},"content":[{"type":"verbatim","value":"igo create-layout"}]},{"type":"para","id":"OPK15VsV3HVzRG9nalxXx","margin":"","location":{"start":{"line":36,"column":1,"offset":1158},"end":{"line":39,"column":30,"offset":1395}},"text":"text","content":["When you have all the files that you want to release and then edit\nthe ",{"type":"fcode","name":"C","content":[".layout"]}," as required (it's JSON and quite obvious,) to remove\nextraneous files (or, if you want to distribute dot files that didn't get\nadded for instance add them.)"]},{"type":"para","id":"d7i6prWBec0QkIbBybAiv","margin":"","location":{"start":{"line":41,"column":1,"offset":1397},"end":{"line":42,"column":48,"offset":1516}},"text":"text","content":["If you want to check that you really have all the files you need in the\narchive that would be uploaded then you can run"]},{"type":"block","id":"TPau9Y51jwSZfIWogzu0C","margin":"","name":"code","config":[],"location":{"start":{"line":44,"column":1,"offset":1518},"end":{"line":46,"column":4,"offset":1544}},"content":[{"type":"verbatim","value":"igo create-archive"}]},{"type":"para","id":"3rsrWlILXjW6HNMlDdKoM","margin":"","location":{"start":{"line":48,"column":1,"offset":1546},"end":{"line":48,"column":37,"offset":1582}},"text":"text","content":["and inspect and test as you see fit."]},{"type":"para","id":"VoVWlwHUva_F4T-og2l_c","margin":"","location":{"start":{"line":50,"column":1,"offset":1584},"end":{"line":51,"column":3,"offset":1657}},"text":"text","content":["When you are all happy with what you are going to upload then you just\ndo"]},{"type":"block","id":"m6CRX5638YFXKQsTrfgyO","margin":"","name":"code","config":[],"location":{"start":{"line":53,"column":1,"offset":1659},"end":{"line":55,"column":4,"offset":1733}},"content":[{"type":"verbatim","value":"igo upload --username=<PAUSE username> --password=<PAUSE password>"}]},{"type":"para","id":"R5ryzkoBRKQsLyxBwggA5","margin":"","location":{"start":{"line":57,"column":1,"offset":1735},"end":{"line":57,"column":75,"offset":1809}},"text":"text","content":["Which will create the archive and upload it with the credentials supplied."]},{"type":"para","id":"G_rJBiJ5pjNCJu3oROT0v","margin":"","location":{"start":{"line":59,"column":1,"offset":1811},"end":{"line":60,"column":61,"offset":1946}},"text":"text","content":["If you don't want to continuously type the credentials at the command line\nyou can create the file ",{"type":"fcode","name":"C","content":["$HOME/.config/igo/pause.ini"]}," with :"]},{"type":"block","id":"nzrZOLMQsQCf6EXje-Ppq","margin":"","name":"code","config":[],"location":{"start":{"line":62,"column":1,"offset":1948},"end":{"line":65,"column":4,"offset":1991}},"content":[{"type":"verbatim","value":"user <username>\npassword <password>"}]},{"type":"para","id":"E7EpcgUyKvlace8-sRTbN","margin":"","location":{"start":{"line":67,"column":1,"offset":1993},"end":{"line":69,"column":65,"offset":2191}},"text":"text","content":["If you are unhappy with having your password in plaintext then\n",{"meta":"https://github.com/Leont/cpan-upload-tiny","type":"fcode","name":"L","content":["CPAN::Uploader::Tiny"]}," does\nsupport encrypted files, but you can work that our for yourself."]},{"type":"para","id":"1F_xSSF2x0HlWjqUCBST0","margin":"","location":{"start":{"line":71,"column":1,"offset":2193},"end":{"line":72,"column":45,"offset":2300}},"text":"text","content":["Please feel free to use the ",{"type":"fcode","name":"C","content":["Igo"]}," module in your own code, but\nit isn't well documented for the time being."]},{"type":"block","id":"Ab6PcGqfrOrF6uhpgh59B","margin":"","level":2,"name":"head","location":{"start":{"line":74,"column":1,"offset":2302},"end":{"line":74,"column":16,"offset":2317}},"content":["Installation"]},{"type":"para","id":"0jAkn23Zh7GF6gI5q2WOh","margin":"","location":{"start":{"line":76,"column":1,"offset":2319},"end":{"line":76,"column":286,"offset":2604}},"text":"text","content":["This uses ",{"meta":"https://modules.raku.org/dist/Archive::Libarchive:cpan:FRITH","type":"fcode","name":"L","content":["Archive::LibArchive"]}," to make the tarball to upload, so you will need to have ",{"type":"fcode","name":"C","content":["libarchive"]}," installed, either via your platform's package manager or by some other means. I don't know if it is available for Windows."]},{"type":"para","id":"7tmq6OFyhZgPRrQJOmwEp","margin":"","location":{"start":{"line":78,"column":1,"offset":2606},"end":{"line":78,"column":96,"offset":2701}},"text":"text","content":["Assuming you have a working Rakudo installation you should be able to install this with ",{"type":"fcode","name":"I","content":["zef"]}," :"]},{"type":"block","id":"k3iCxnrdklzDJxlPurqGp","margin":"","name":"code","config":[],"location":{"start":{"line":80,"column":1,"offset":2703},"end":{"line":86,"column":20,"offset":2801}},"content":[{"type":"verbatim","value":"# From the source directory\n\nzef install .\n\n# Remote installation\n\nzef install Igo"}]},{"type":"block","id":"yFkiKUUjsV4LhLGuIKDrr","margin":"","level":2,"name":"head","location":{"start":{"line":88,"column":1,"offset":2803},"end":{"line":88,"column":11,"offset":2813}},"content":["Support"]},{"type":"para","id":"4PrBS4zqgbG82fGtHDG-a","margin":"","location":{"start":{"line":90,"column":1,"offset":2815},"end":{"line":90,"column":99,"offset":2913}},"text":"text","content":["Suggestions and patches that may make this more useful in your software are welcomed via github at"]},{"type":"para","id":"WHcQQD8POLeRSgBSLlADW","margin":"","location":{"start":{"line":92,"column":1,"offset":2915},"end":{"line":92,"column":44,"offset":2958}},"text":"text","content":[{"meta":"https://github.com/jonathanstowe/Igo/issues","type":"fcode","name":"L","content":["https://github.com/jonathanstowe/Igo/issues"]}]},{"type":"block","id":"Gu04syqfi2PbqlOB6-qIf","margin":"","level":2,"name":"head","location":{"start":{"line":94,"column":1,"offset":2960},"end":{"line":94,"column":11,"offset":2970}},"content":["Licence"]},{"type":"para","id":"PR0oDmyOjvHioCac-8h53","margin":"","location":{"start":{"line":96,"column":1,"offset":2972},"end":{"line":96,"column":23,"offset":2994}},"text":"text","content":["This is free software."]},{"type":"para","id":"D22VNmWIyWTdXmE_arCcS","margin":"","location":{"start":{"line":98,"column":1,"offset":2996},"end":{"line":98,"column":60,"offset":3055}},"text":"text","content":["Please see the ",{"meta":"LICENCE","type":"fcode","name":"L","content":["LICENCE"]}," file in the distribution."]},{"type":"para","id":"RG6iuNAcHgKjnquDMhEB5","margin":"","location":{"start":{"line":100,"column":1,"offset":3057},"end":{"line":100,"column":29,"offset":3085}},"text":"text","content":["© Jonathan Stowe 2019 - 2021"]}]},"publishUrl":"/mods/zef/Igo/Igo-0.0.8/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"1.0","auth":"zef:jonathanstowe","authors":["Jonathan Stowe <jns+gh@gellyfish.co.uk>"],"build-depends":[],"depends":{"build":{"requires":[]},"runtime":{"requires":["Archive::Libarchive","CPAN::Uploader::Tiny","META6","Oyatul","XDG::BaseDirectory"]}},"description":"Expedient CPAN distribution packager and uploader","dist":"Igo:ver<0.0.8>:auth<zef:jonathanstowe>","license":"Artistic-2.0","meta-version":"1","name":"Igo","path":"I/GO/IGO/33f3bead817cfe110dac5a1da791b8b316811710.tar.gz","provides":{"Igo":"lib/Igo.rakumod"},"raku":"6.*","resources":[],"source-url":"git://github.com/jonathanstowe/Igo.git","support":{"bugtracker":"https://github.com/jonathanstowe/Igo/issues","email":"jns+gh@gellyfish.co.uk","source":"git://github.com/jonathanstowe/Igo.git"},"tags":["cpan6","packager","uploader"],"test-depends":[],"version":"0.0.8"},"files":[{"file":"work_mods/zef/Igo/Igo-0.0.8/README.md","publishUrl":"/mods/zef/Igo/Igo-0.0.8/README.md"}],"src":"zef","url":"/mods/zef/Igo"}}}
    =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

Igo


=begin data
{"type":"page","file":"work_mods/zef/Ikoko/Ikoko-0.0.3/README.md","sources":[],"node":{"type":"block","id":"jHsgMIXGC0yPWz1PoMIku","margin":"","name":"root","content":[{"type":"block","id":"_OA5xLybVUbNsFcAka5r1","margin":"","level":1,"name":"head","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":8,"offset":7}},"content":["Ikoko"]},{"type":"para","id":"4bBdEdAyf-WbBZC1eGFvU","margin":"","location":{"start":{"line":3,"column":1,"offset":9},"end":{"line":3,"column":54,"offset":62}},"text":"text","content":["Simple Read-Only interface to the AWS Secrets Manager"]},{"type":"para","id":"8bu_z7IgJS1Y84SA0e363","margin":"","location":{"start":{"line":5,"column":1,"offset":64},"end":{"line":5,"column":152,"offset":215}},"text":"text","content":[{"meta":"https://github.com/jonathanstowe/Ikoko/actions/workflows/main.yml","type":"fcode","name":"L","content":[{"type":"block","id":"FaxMBQIRvAhxXQDQ_7wJ7","margin":"","name":"Image","config":[],"location":{"start":{"line":5,"column":2,"offset":65},"end":{"line":5,"column":84,"offset":147}},"content":[{"type":"image","src":"https://github.com/jonathanstowe/Ikoko/actions/workflows/main.yml/badge.svg","alt":"CI"}]}]}]},{"type":"block","id":"KLe5uLraogXfgsU26z2-S","margin":"","level":2,"name":"head","location":{"start":{"line":7,"column":1,"offset":217},"end":{"line":7,"column":12,"offset":228}},"content":["Synopsis"]},{"type":"block","id":"Ypzg7kQRQJU5P-8r-DK6e","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":9,"column":1,"offset":230},"end":{"line":20,"column":4,"offset":617}},"content":[{"type":"verbatim","value":"use Ikoko;\nuse Kivuli;\n\n# Using Kivuli to get session credentials for a role in EC2\n# The access-key-id and secret-access-key could come from configuration\nmy $k = Kivuli.new;\n\nmy $ikoko = Ikoko.new(region => 'eu-west-2', access-key-id => $k.access-key-id, secret-access-key => $k.secret-access-key, token => $k.token );\n\nsay $ikoko.get-secret-value(\"db-user\").secret-string;"}]},{"type":"block","id":"CwrsDr2x5V8c8_oQjjEmM","margin":"","level":2,"name":"head","location":{"start":{"line":22,"column":1,"offset":619},"end":{"line":22,"column":15,"offset":633}},"content":["Description"]},{"type":"para","id":"jMqRb_VOYXt7ju3q0ZFdP","margin":"","location":{"start":{"line":24,"column":1,"offset":635},"end":{"line":24,"column":295,"offset":929}},"text":"text","content":["This provides a simple interface to the ",{"meta":"https://docs.aws.amazon.com/secretsmanager/index.html","type":"fcode","name":"L","content":["AWS Secrets Manager"]},". The secrets manager enables an application to retrieve a secret credential (for, say, an RDS database ) at run time without having to save it in your application configuration."]},{"type":"para","id":"0SQJ2qRCim7NVWTDM-Y2t","margin":"","location":{"start":{"line":26,"column":1,"offset":931},"end":{"line":27,"column":41,"offset":1303}},"text":"text","content":["If used with ",{"meta":"https://docs.aws.amazon.com/secretsmanager/index.html","type":"fcode","name":"L","content":["Kivuli"]}," in an EC2 or Elasticbeanstalk instance you can avoid having all credentials in the configuration or application code. When used with the temporary credentials as supplied by Kivuli the ",{"type":"fcode","name":"C","content":["token"]}," must be provided. If you are using a permanent access key for\nan account then the ",{"type":"fcode","name":"C","content":["token"]}," is optional."]},{"type":"para","id":"6OsSNgHt15zXxP75zxgsO","margin":"","location":{"start":{"line":29,"column":1,"offset":1305},"end":{"line":29,"column":196,"offset":1500}},"text":"text","content":["For this to work the account or IAM role must have permission to retrieve the secrets, which is described ",{"meta":"https://docs.aws.amazon.com/secretsmanager/latest/userguide/auth-and-access.html","type":"fcode","name":"L","content":["here"]},"."]},{"type":"para","id":"IEitwoIaqU8f_B8IDg7d-","margin":"","location":{"start":{"line":31,"column":1,"offset":1502},"end":{"line":31,"column":91,"offset":1592}},"text":"text","content":["Currently this only implements ",{"type":"fcode","name":"C","content":["GetSecretValue"]}," as this is most useful for an application."]},{"type":"block","id":"E-TQXHyzh69bgW-bwGeAo","margin":"","level":2,"name":"head","location":{"start":{"line":33,"column":1,"offset":1594},"end":{"line":33,"column":16,"offset":1609}},"content":["Installation"]},{"type":"para","id":"L9s3CtaFnbLzf3LoELAjR","margin":"","location":{"start":{"line":35,"column":1,"offset":1611},"end":{"line":35,"column":99,"offset":1709}},"text":"text","content":["Assuming you have a working installation of rakudo you should be able to install this with ",{"type":"fcode","name":"I","content":["zef"]}," :"]},{"type":"block","id":"BcVYs7GsRO3KVJ4RT7tll","margin":"","name":"code","config":[],"location":{"start":{"line":37,"column":1,"offset":1711},"end":{"line":37,"column":23,"offset":1733}},"content":[{"type":"verbatim","value":" zef install Ikoko"}]},{"type":"block","id":"z9dXwcOhuXbKt0Qb-DWR-","margin":"","level":2,"name":"head","location":{"start":{"line":39,"column":1,"offset":1735},"end":{"line":39,"column":11,"offset":1745}},"content":["Support"]},{"type":"para","id":"raU686OVJgXM8JjALys8x","margin":"","location":{"start":{"line":41,"column":1,"offset":1747},"end":{"line":41,"column":243,"offset":1989}},"text":"text","content":["This currently only implements the bare essentials for my needs, if you need some other features or have other suggestions or patches please raise an issue on ",{"meta":"https://github.com/jonathanstowe/Ikoko/issues","type":"fcode","name":"L","content":["Github"]}," and I'll see what I can do."]},{"type":"para","id":"XVoIfXT1Zuc6l4UdwCmk2","margin":"","location":{"start":{"line":43,"column":1,"offset":1991},"end":{"line":43,"column":136,"offset":2126}},"text":"text","content":["Although the unit tests are rather thin, rest assured that I have tested this manually and is being used in the project I wrote it for."]},{"type":"block","id":"g4qloYJOaG4YKNjPHSzNd","margin":"","level":2,"name":"head","location":{"start":{"line":45,"column":1,"offset":2128},"end":{"line":45,"column":24,"offset":2151}},"content":["Licence & Copyright."]},{"type":"para","id":"hIfCtieCcLsHoSl77TSJF","margin":"","location":{"start":{"line":47,"column":1,"offset":2153},"end":{"line":47,"column":90,"offset":2242}},"text":"text","content":["This is free software. Please see the ",{"meta":"LICENCE","type":"fcode","name":"L","content":["LICENCE"]}," in the distribution for details."]},{"type":"para","id":"SHTh--iR-uotFYYurq4nL","margin":"","location":{"start":{"line":49,"column":1,"offset":2244},"end":{"line":49,"column":22,"offset":2265}},"text":"text","content":["© Jonathan Stowe 2021"]}]},"publishUrl":"/mods/zef/Ikoko/Ikoko-0.0.3/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"","auth":"zef:jonathanstowe","authors":["Jonathan Stowe <jns+gh@gellyfish.co.uk>"],"build-depends":[],"depends":{"runtime":{"requires":["Cro::HTTP::Client","WebService::AWS::Auth::V4","JSON::Class","Cro::HTTP::BodySerializers","Cro::BodyParser","JSON::Name"]}},"description":"Simple interface to AWS Secrets Manager","dist":"Ikoko:ver<0.0.3>:auth<zef:jonathanstowe>","license":"Artistic-2.0","meta-version":"2","name":"Ikoko","path":"I/KO/IKOKO/ac3cf0222a165b987c1ebbb2acf9f254e61a8b9e.tar.gz","provides":{"Ikoko":"lib/Ikoko.rakumod"},"raku":"6.d","resources":[],"source-url":"https://github.com/jonathanstowe/Ikoko.git","support":{"email":"jns+gh@gellyfish.co.uk","source":"https://github.com/jonathanstowe/Ikoko.git"},"tags":["AWS","secretsmanager","credentials"],"test-depends":[],"version":"0.0.3"},"files":[{"file":"work_mods/zef/Ikoko/Ikoko-0.0.3/README.md","publishUrl":"/mods/zef/Ikoko/Ikoko-0.0.3/README.md"}],"src":"zef","url":"/mods/zef/Ikoko"}}}
=end data


    =begin React :component<RenderItem>
    =begin data
    {"type":"page","file":"work_mods/zef/Ikoko/Ikoko-0.0.3/README.md","sources":[],"node":{"type":"block","id":"jHsgMIXGC0yPWz1PoMIku","margin":"","name":"root","content":[{"type":"block","id":"_OA5xLybVUbNsFcAka5r1","margin":"","level":1,"name":"head","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":8,"offset":7}},"content":["Ikoko"]},{"type":"para","id":"4bBdEdAyf-WbBZC1eGFvU","margin":"","location":{"start":{"line":3,"column":1,"offset":9},"end":{"line":3,"column":54,"offset":62}},"text":"text","content":["Simple Read-Only interface to the AWS Secrets Manager"]},{"type":"para","id":"8bu_z7IgJS1Y84SA0e363","margin":"","location":{"start":{"line":5,"column":1,"offset":64},"end":{"line":5,"column":152,"offset":215}},"text":"text","content":[{"meta":"https://github.com/jonathanstowe/Ikoko/actions/workflows/main.yml","type":"fcode","name":"L","content":[{"type":"block","id":"FaxMBQIRvAhxXQDQ_7wJ7","margin":"","name":"Image","config":[],"location":{"start":{"line":5,"column":2,"offset":65},"end":{"line":5,"column":84,"offset":147}},"content":[{"type":"image","src":"https://github.com/jonathanstowe/Ikoko/actions/workflows/main.yml/badge.svg","alt":"CI"}]}]}]},{"type":"block","id":"KLe5uLraogXfgsU26z2-S","margin":"","level":2,"name":"head","location":{"start":{"line":7,"column":1,"offset":217},"end":{"line":7,"column":12,"offset":228}},"content":["Synopsis"]},{"type":"block","id":"Ypzg7kQRQJU5P-8r-DK6e","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":9,"column":1,"offset":230},"end":{"line":20,"column":4,"offset":617}},"content":[{"type":"verbatim","value":"use Ikoko;\nuse Kivuli;\n\n# Using Kivuli to get session credentials for a role in EC2\n# The access-key-id and secret-access-key could come from configuration\nmy $k = Kivuli.new;\n\nmy $ikoko = Ikoko.new(region => 'eu-west-2', access-key-id => $k.access-key-id, secret-access-key => $k.secret-access-key, token => $k.token );\n\nsay $ikoko.get-secret-value(\"db-user\").secret-string;"}]},{"type":"block","id":"CwrsDr2x5V8c8_oQjjEmM","margin":"","level":2,"name":"head","location":{"start":{"line":22,"column":1,"offset":619},"end":{"line":22,"column":15,"offset":633}},"content":["Description"]},{"type":"para","id":"jMqRb_VOYXt7ju3q0ZFdP","margin":"","location":{"start":{"line":24,"column":1,"offset":635},"end":{"line":24,"column":295,"offset":929}},"text":"text","content":["This provides a simple interface to the ",{"meta":"https://docs.aws.amazon.com/secretsmanager/index.html","type":"fcode","name":"L","content":["AWS Secrets Manager"]},". The secrets manager enables an application to retrieve a secret credential (for, say, an RDS database ) at run time without having to save it in your application configuration."]},{"type":"para","id":"0SQJ2qRCim7NVWTDM-Y2t","margin":"","location":{"start":{"line":26,"column":1,"offset":931},"end":{"line":27,"column":41,"offset":1303}},"text":"text","content":["If used with ",{"meta":"https://docs.aws.amazon.com/secretsmanager/index.html","type":"fcode","name":"L","content":["Kivuli"]}," in an EC2 or Elasticbeanstalk instance you can avoid having all credentials in the configuration or application code. When used with the temporary credentials as supplied by Kivuli the ",{"type":"fcode","name":"C","content":["token"]}," must be provided. If you are using a permanent access key for\nan account then the ",{"type":"fcode","name":"C","content":["token"]}," is optional."]},{"type":"para","id":"6OsSNgHt15zXxP75zxgsO","margin":"","location":{"start":{"line":29,"column":1,"offset":1305},"end":{"line":29,"column":196,"offset":1500}},"text":"text","content":["For this to work the account or IAM role must have permission to retrieve the secrets, which is described ",{"meta":"https://docs.aws.amazon.com/secretsmanager/latest/userguide/auth-and-access.html","type":"fcode","name":"L","content":["here"]},"."]},{"type":"para","id":"IEitwoIaqU8f_B8IDg7d-","margin":"","location":{"start":{"line":31,"column":1,"offset":1502},"end":{"line":31,"column":91,"offset":1592}},"text":"text","content":["Currently this only implements ",{"type":"fcode","name":"C","content":["GetSecretValue"]}," as this is most useful for an application."]},{"type":"block","id":"E-TQXHyzh69bgW-bwGeAo","margin":"","level":2,"name":"head","location":{"start":{"line":33,"column":1,"offset":1594},"end":{"line":33,"column":16,"offset":1609}},"content":["Installation"]},{"type":"para","id":"L9s3CtaFnbLzf3LoELAjR","margin":"","location":{"start":{"line":35,"column":1,"offset":1611},"end":{"line":35,"column":99,"offset":1709}},"text":"text","content":["Assuming you have a working installation of rakudo you should be able to install this with ",{"type":"fcode","name":"I","content":["zef"]}," :"]},{"type":"block","id":"BcVYs7GsRO3KVJ4RT7tll","margin":"","name":"code","config":[],"location":{"start":{"line":37,"column":1,"offset":1711},"end":{"line":37,"column":23,"offset":1733}},"content":[{"type":"verbatim","value":" zef install Ikoko"}]},{"type":"block","id":"z9dXwcOhuXbKt0Qb-DWR-","margin":"","level":2,"name":"head","location":{"start":{"line":39,"column":1,"offset":1735},"end":{"line":39,"column":11,"offset":1745}},"content":["Support"]},{"type":"para","id":"raU686OVJgXM8JjALys8x","margin":"","location":{"start":{"line":41,"column":1,"offset":1747},"end":{"line":41,"column":243,"offset":1989}},"text":"text","content":["This currently only implements the bare essentials for my needs, if you need some other features or have other suggestions or patches please raise an issue on ",{"meta":"https://github.com/jonathanstowe/Ikoko/issues","type":"fcode","name":"L","content":["Github"]}," and I'll see what I can do."]},{"type":"para","id":"XVoIfXT1Zuc6l4UdwCmk2","margin":"","location":{"start":{"line":43,"column":1,"offset":1991},"end":{"line":43,"column":136,"offset":2126}},"text":"text","content":["Although the unit tests are rather thin, rest assured that I have tested this manually and is being used in the project I wrote it for."]},{"type":"block","id":"g4qloYJOaG4YKNjPHSzNd","margin":"","level":2,"name":"head","location":{"start":{"line":45,"column":1,"offset":2128},"end":{"line":45,"column":24,"offset":2151}},"content":["Licence & Copyright."]},{"type":"para","id":"hIfCtieCcLsHoSl77TSJF","margin":"","location":{"start":{"line":47,"column":1,"offset":2153},"end":{"line":47,"column":90,"offset":2242}},"text":"text","content":["This is free software. Please see the ",{"meta":"LICENCE","type":"fcode","name":"L","content":["LICENCE"]}," in the distribution for details."]},{"type":"para","id":"SHTh--iR-uotFYYurq4nL","margin":"","location":{"start":{"line":49,"column":1,"offset":2244},"end":{"line":49,"column":22,"offset":2265}},"text":"text","content":["© Jonathan Stowe 2021"]}]},"publishUrl":"/mods/zef/Ikoko/Ikoko-0.0.3/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"","auth":"zef:jonathanstowe","authors":["Jonathan Stowe <jns+gh@gellyfish.co.uk>"],"build-depends":[],"depends":{"runtime":{"requires":["Cro::HTTP::Client","WebService::AWS::Auth::V4","JSON::Class","Cro::HTTP::BodySerializers","Cro::BodyParser","JSON::Name"]}},"description":"Simple interface to AWS Secrets Manager","dist":"Ikoko:ver<0.0.3>:auth<zef:jonathanstowe>","license":"Artistic-2.0","meta-version":"2","name":"Ikoko","path":"I/KO/IKOKO/ac3cf0222a165b987c1ebbb2acf9f254e61a8b9e.tar.gz","provides":{"Ikoko":"lib/Ikoko.rakumod"},"raku":"6.d","resources":[],"source-url":"https://github.com/jonathanstowe/Ikoko.git","support":{"email":"jns+gh@gellyfish.co.uk","source":"https://github.com/jonathanstowe/Ikoko.git"},"tags":["AWS","secretsmanager","credentials"],"test-depends":[],"version":"0.0.3"},"files":[{"file":"work_mods/zef/Ikoko/Ikoko-0.0.3/README.md","publishUrl":"/mods/zef/Ikoko/Ikoko-0.0.3/README.md"}],"src":"zef","url":"/mods/zef/Ikoko"}}}
    =end data
    =end React


Simple interface to AWS Secrets Manager


Ikoko


=begin data
{"type":"page","file":"work_mods/zef/if/if-0.1.2/README.md","sources":[],"node":{"type":"block","id":"fGW89l6tlkA5s2xYuWNFY","margin":"","name":"root","content":[{"type":"para","id":"BJKrxHZ0k86IeWs-Zx3jm","margin":"","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":157,"offset":156}},"text":"text","content":[{"meta":"https://github.com/raku-community-modules/if/actions","type":"fcode","name":"L","content":[{"type":"block","id":"XM2fgxFnBLhjTg8Dv9kPV","margin":"","name":"Image","config":[],"location":{"start":{"line":1,"column":2,"offset":1},"end":{"line":1,"column":102,"offset":101}},"content":[{"type":"image","src":"https://github.com/raku-community-modules/if/actions/workflows/test.yml/badge.svg","alt":"Actions Status"}]}]}]},{"type":"block","id":"NI4Jb7UC88NPtIOWnhk54","margin":"","level":1,"name":"head","location":{"start":{"line":3,"column":1,"offset":158},"end":{"line":3,"column":7,"offset":164}},"content":["NAME"]},{"type":"para","id":"UlAYr806HOm3-XCPNCHde","margin":"","location":{"start":{"line":5,"column":1,"offset":166},"end":{"line":5,"column":39,"offset":204}},"text":"text","content":["if - Conditionally load a distribution"]},{"type":"block","id":"uU9xDKoKqd6ctIpAm8jYx","margin":"","level":1,"name":"head","location":{"start":{"line":7,"column":1,"offset":206},"end":{"line":7,"column":11,"offset":216}},"content":["SYNOPSIS"]},{"type":"block","id":"jdm8ITmyYKLYYDv2Ni7QR","margin":"","name":"code","config":[],"location":{"start":{"line":9,"column":1,"offset":218},"end":{"line":14,"column":48,"offset":440}},"content":[{"type":"verbatim","value":"use if; # activate the :if adverb on use statements\n\nuse My::Linux::Backend:if($*KERNEL.name eq 'linux');\nuse My::Fallback::Backend:if($*KERNEL.name ne 'linux');\n\n# ... do something with the backend you got"}]},{"type":"block","id":"M2EF6ncW7mqbZiMTorphW","margin":"","level":1,"name":"head","location":{"start":{"line":16,"column":1,"offset":442},"end":{"line":16,"column":14,"offset":455}},"content":["DESCRIPTION"]},{"type":"para","id":"ZALd6MH3VLVTdTJA5HF--","margin":"","location":{"start":{"line":18,"column":1,"offset":457},"end":{"line":18,"column":235,"offset":691}},"text":"text","content":["The ",{"type":"fcode","name":"C","content":["if"]}," distribution will let you conditionally load a distribution. Use cases (no pun intended) are about loading different implementations of a functionality for different operating systems, compiler backends, or compiler versions."]},{"type":"para","id":"KCle8USxRhOrf9K-dVaFM","margin":"","location":{"start":{"line":20,"column":1,"offset":693},"end":{"line":20,"column":305,"offset":997}},"text":"text","content":["This means that these switches for different implementations do not happen at runtime, but cheaply at compile time. This also means that a custom build and install hook is not needed because all implementations are installed. Then depending on the conditions only the desired implementation will be used."]},{"type":"para","id":"kKg1D4--i4L390EoelDW-","margin":"","location":{"start":{"line":22,"column":1,"offset":999},"end":{"line":22,"column":107,"offset":1105}},"text":"text","content":["Even if the switch is by backends you can share one installation by several backends using this technique."]},{"type":"block","id":"05x_6TFRdf-Rm88HgziEY","margin":"","level":1,"name":"head","location":{"start":{"line":24,"column":1,"offset":1107},"end":{"line":24,"column":9,"offset":1115}},"content":["AUTHOR"]},{"type":"para","id":"U1OZx24sn8nvRhpRtYEhJ","margin":"","location":{"start":{"line":26,"column":1,"offset":1117},"end":{"line":26,"column":22,"offset":1138}},"text":"text","content":["Tobias \"FROGGS\" Leich"]},{"type":"block","id":"_Kob2zDIbQmYLiWQF2ec-","margin":"","level":1,"name":"head","location":{"start":{"line":28,"column":1,"offset":1140},"end":{"line":28,"column":24,"offset":1163}},"content":["COPYRIGHT AND LICENSE"]},{"type":"para","id":"IHAxFOetBierkazd408df","margin":"","location":{"start":{"line":30,"column":1,"offset":1165},"end":{"line":30,"column":63,"offset":1227}},"text":"text","content":["Copyright 2016-2020 Tobias Leich Copyright 2023 Raku Community"]},{"type":"para","id":"_g6CGHNL6YRoWnMCSnyZ1","margin":"","location":{"start":{"line":32,"column":1,"offset":1229},"end":{"line":32,"column":104,"offset":1332}},"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/if/if-0.1.2/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"","auth":"zef:raku-community-modules","author":"Tobias Leich","build-depends":[],"depends":[],"description":"Conditionally load a distribution","dist":"if:ver<0.1.2>:auth<zef:raku-community-modules>","license":"Artistic-2.0","name":"if","path":"I/IF/a60bd539fefa5ae682f362c58633ea7579d9a7e6.tar.gz","perl":"6.*","provides":{"if":"lib/if.rakumod"},"resources":[],"source-url":"git://github.com/raku-community-modules/if.git","tags":[],"test-depends":[],"version":"0.1.2"},"files":[{"file":"work_mods/zef/if/if-0.1.2/README.md","publishUrl":"/mods/zef/if/if-0.1.2/README.md"},{"file":"work_mods/zef/if/if-0.1.2/lib/if.rakumod","publishUrl":"/mods/zef/if/if-0.1.2/lib/if.rakumod"}],"src":"zef","url":"/mods/zef/if"}}}
=end data


    =begin React :component<RenderItem>
    =begin data
    {"type":"page","file":"work_mods/zef/if/if-0.1.2/README.md","sources":[],"node":{"type":"block","id":"fGW89l6tlkA5s2xYuWNFY","margin":"","name":"root","content":[{"type":"para","id":"BJKrxHZ0k86IeWs-Zx3jm","margin":"","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":157,"offset":156}},"text":"text","content":[{"meta":"https://github.com/raku-community-modules/if/actions","type":"fcode","name":"L","content":[{"type":"block","id":"XM2fgxFnBLhjTg8Dv9kPV","margin":"","name":"Image","config":[],"location":{"start":{"line":1,"column":2,"offset":1},"end":{"line":1,"column":102,"offset":101}},"content":[{"type":"image","src":"https://github.com/raku-community-modules/if/actions/workflows/test.yml/badge.svg","alt":"Actions Status"}]}]}]},{"type":"block","id":"NI4Jb7UC88NPtIOWnhk54","margin":"","level":1,"name":"head","location":{"start":{"line":3,"column":1,"offset":158},"end":{"line":3,"column":7,"offset":164}},"content":["NAME"]},{"type":"para","id":"UlAYr806HOm3-XCPNCHde","margin":"","location":{"start":{"line":5,"column":1,"offset":166},"end":{"line":5,"column":39,"offset":204}},"text":"text","content":["if - Conditionally load a distribution"]},{"type":"block","id":"uU9xDKoKqd6ctIpAm8jYx","margin":"","level":1,"name":"head","location":{"start":{"line":7,"column":1,"offset":206},"end":{"line":7,"column":11,"offset":216}},"content":["SYNOPSIS"]},{"type":"block","id":"jdm8ITmyYKLYYDv2Ni7QR","margin":"","name":"code","config":[],"location":{"start":{"line":9,"column":1,"offset":218},"end":{"line":14,"column":48,"offset":440}},"content":[{"type":"verbatim","value":"use if; # activate the :if adverb on use statements\n\nuse My::Linux::Backend:if($*KERNEL.name eq 'linux');\nuse My::Fallback::Backend:if($*KERNEL.name ne 'linux');\n\n# ... do something with the backend you got"}]},{"type":"block","id":"M2EF6ncW7mqbZiMTorphW","margin":"","level":1,"name":"head","location":{"start":{"line":16,"column":1,"offset":442},"end":{"line":16,"column":14,"offset":455}},"content":["DESCRIPTION"]},{"type":"para","id":"ZALd6MH3VLVTdTJA5HF--","margin":"","location":{"start":{"line":18,"column":1,"offset":457},"end":{"line":18,"column":235,"offset":691}},"text":"text","content":["The ",{"type":"fcode","name":"C","content":["if"]}," distribution will let you conditionally load a distribution. Use cases (no pun intended) are about loading different implementations of a functionality for different operating systems, compiler backends, or compiler versions."]},{"type":"para","id":"KCle8USxRhOrf9K-dVaFM","margin":"","location":{"start":{"line":20,"column":1,"offset":693},"end":{"line":20,"column":305,"offset":997}},"text":"text","content":["This means that these switches for different implementations do not happen at runtime, but cheaply at compile time. This also means that a custom build and install hook is not needed because all implementations are installed. Then depending on the conditions only the desired implementation will be used."]},{"type":"para","id":"kKg1D4--i4L390EoelDW-","margin":"","location":{"start":{"line":22,"column":1,"offset":999},"end":{"line":22,"column":107,"offset":1105}},"text":"text","content":["Even if the switch is by backends you can share one installation by several backends using this technique."]},{"type":"block","id":"05x_6TFRdf-Rm88HgziEY","margin":"","level":1,"name":"head","location":{"start":{"line":24,"column":1,"offset":1107},"end":{"line":24,"column":9,"offset":1115}},"content":["AUTHOR"]},{"type":"para","id":"U1OZx24sn8nvRhpRtYEhJ","margin":"","location":{"start":{"line":26,"column":1,"offset":1117},"end":{"line":26,"column":22,"offset":1138}},"text":"text","content":["Tobias \"FROGGS\" Leich"]},{"type":"block","id":"_Kob2zDIbQmYLiWQF2ec-","margin":"","level":1,"name":"head","location":{"start":{"line":28,"column":1,"offset":1140},"end":{"line":28,"column":24,"offset":1163}},"content":["COPYRIGHT AND LICENSE"]},{"type":"para","id":"IHAxFOetBierkazd408df","margin":"","location":{"start":{"line":30,"column":1,"offset":1165},"end":{"line":30,"column":63,"offset":1227}},"text":"text","content":["Copyright 2016-2020 Tobias Leich Copyright 2023 Raku Community"]},{"type":"para","id":"_g6CGHNL6YRoWnMCSnyZ1","margin":"","location":{"start":{"line":32,"column":1,"offset":1229},"end":{"line":32,"column":104,"offset":1332}},"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/if/if-0.1.2/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"","auth":"zef:raku-community-modules","author":"Tobias Leich","build-depends":[],"depends":[],"description":"Conditionally load a distribution","dist":"if:ver<0.1.2>:auth<zef:raku-community-modules>","license":"Artistic-2.0","name":"if","path":"I/IF/a60bd539fefa5ae682f362c58633ea7579d9a7e6.tar.gz","perl":"6.*","provides":{"if":"lib/if.rakumod"},"resources":[],"source-url":"git://github.com/raku-community-modules/if.git","tags":[],"test-depends":[],"version":"0.1.2"},"files":[{"file":"work_mods/zef/if/if-0.1.2/README.md","publishUrl":"/mods/zef/if/if-0.1.2/README.md"},{"file":"work_mods/zef/if/if-0.1.2/lib/if.rakumod","publishUrl":"/mods/zef/if/if-0.1.2/lib/if.rakumod"}],"src":"zef","url":"/mods/zef/if"}}}
    =end data
    =end React


Conditionally load a distribution


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


Igo

Igo

image https://github.com/jonathanstowe/Igo/workflows/CI/badge.svg not found

Synopsis

Description

Installation

Support

Licence

Igo v0.0.8

Authors

License

Dependencies

Test Dependencies

Provides

Documentation