TITLE

Access AWS IAM role credentials within EC2


SUBTITLE

data

=begin data
{"type":"page","file":"work_mods/zef/Kivuli/Kivuli-0.0.4/README.md","sources":[],"node":{"type":"block","id":"tm4vu9d7IozLOl-wdmpiv","margin":"","name":"root","content":[{"type":"block","id":"jU7TsJKdzOzps-cEqDHa9","margin":"","level":1,"name":"head","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":9,"offset":8}},"content":["Kivuli"]},{"type":"para","id":"jG5kFiI4cELwlZEXai8Yw","margin":"","location":{"start":{"line":3,"column":1,"offset":10},"end":{"line":3,"column":36,"offset":45}},"text":"text","content":["Get AWS IAM role credentials in EC2"]},{"type":"para","id":"gKZY15DaAsW4cdSSw5-A6","margin":"","location":{"start":{"line":5,"column":1,"offset":47},"end":{"line":5,"column":154,"offset":200}},"text":"text","content":[{"meta":"https://github.com/jonathanstowe/Kivuli/actions/workflows/main.yml","type":"fcode","name":"L","content":[{"type":"block","id":"g2PQZWa4ymd_oACMuLx7u","margin":"","name":"Image","config":[],"location":{"start":{"line":5,"column":2,"offset":48},"end":{"line":5,"column":85,"offset":131}},"content":[{"type":"image","src":"https://github.com/jonathanstowe/Kivuli/actions/workflows/main.yml/badge.svg","alt":"CI"}]}]}]},{"type":"block","id":"_8HDys3M5LOgXP6ePY2Dx","margin":"","level":2,"name":"head","location":{"start":{"line":7,"column":1,"offset":202},"end":{"line":7,"column":12,"offset":213}},"content":["Synopsis"]},{"type":"block","id":"BdVOVzECdw_w7p1RnYf2w","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":9,"column":1,"offset":215},"end":{"line":22,"column":4,"offset":544}},"content":[{"type":"verbatim","value":"\n# In some application running on EC2\n\nuse Kivuli;\nuse WebService::AWS::S3;\n\nmy $k = Kivuli.new(role-name => 'my-iam-role');\nmy $s3 = WebService::AWS::S3.new(secret-access-key => $k.secret-access-key, access-key-id => $k.access-key-id, security-token => $k.token, region => 'eu-west-2');\n\n# Do something with the S3\n\n"}]},{"type":"block","id":"YEfB8Y_gVwMCcBmUfnANy","margin":"","level":2,"name":"head","location":{"start":{"line":24,"column":1,"offset":546},"end":{"line":24,"column":15,"offset":560}},"content":["Description"]},{"type":"para","id":"rZ8TbLHK-eKlmfLnwVB20","margin":"","location":{"start":{"line":26,"column":1,"offset":562},"end":{"line":26,"column":187,"offset":748}},"text":"text","content":["This module enables access to AWS IAM role credentials from within an EC2 instance as ",{"meta":"https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/iam-roles-for-amazon-ec2.html","type":"fcode","name":"L","content":["described here"]},"."]},{"type":"para","id":"QP0_LK8Osh_AiNOFOzYPQ","margin":"","location":{"start":{"line":28,"column":1,"offset":750},"end":{"line":28,"column":188,"offset":937}},"text":"text","content":["The credentials supplied ( ",{"type":"fcode","name":"C","content":["AWS_ACCES_KEY_ID"]},", ",{"type":"fcode","name":"C","content":["AWS_SECRET_ACCESS_KEY"]},", ",{"type":"fcode","name":"C","content":["AWS_SESSION_TOKEN"]},") can be used to authenticate with another AWS service that the role has been granted access to."]},{"type":"para","id":"sJ1NXKH82SOzhY6xfldLN","margin":"","location":{"start":{"line":30,"column":1,"offset":939},"end":{"line":30,"column":197,"offset":1135}},"text":"text","content":["Because the credentials are supplied in a way that is private to the EC2 instance this is a more secure method of obtaining the credentials than, for example, putting them in a configuration file."]},{"type":"para","id":"eTyvP1qkeCzew_Q8-9g9R","margin":"","location":{"start":{"line":32,"column":1,"offset":1137},"end":{"line":33,"column":111,"offset":1432}},"text":"text","content":["The ",{"type":"fcode","name":"C","content":["token"]}," ",{"type":"fcode","name":"B","content":["must"]}," be supplied in the headers (or as a query parameter,) for requests to the service, however some services differ as to whether it should or shouldn't be part of the\nsigned headers in the request - please see the documentation for the service you are implementing for details."]},{"type":"block","id":"SHz5ncWYgDWfTxbldFd1Q","margin":"","level":2,"name":"head","location":{"start":{"line":35,"column":1,"offset":1434},"end":{"line":35,"column":16,"offset":1449}},"content":["Installation"]},{"type":"para","id":"i3-Q5IHQoObiwgHMRw8Ys","margin":"","location":{"start":{"line":37,"column":1,"offset":1451},"end":{"line":37,"column":102,"offset":1552}},"text":"text","content":["Assuming you have a working ",{"type":"fcode","name":"I","content":["rakudo"]}," installation then you should be able to install this with ",{"type":"fcode","name":"I","content":["zef"]},":"]},{"type":"block","id":"wc6uZNZqjaJ-ROhN8Hs1e","margin":"","name":"code","config":[],"location":{"start":{"line":39,"column":1,"offset":1554},"end":{"line":39,"column":24,"offset":1577}},"content":[{"type":"verbatim","value":" zef install Kivuli"}]},{"type":"para","id":"frgDEGHc-Z3sItaZCtram","margin":"","location":{"start":{"line":41,"column":1,"offset":1579},"end":{"line":41,"column":194,"offset":1772}},"text":"text","content":["Bear in mind that this will pass its tests and install outside an EC2 instance, which may be useful for example to build a Docker image to upload to AWS, but it will only work correctly on EC2."]},{"type":"block","id":"ykeqZAv3FyW8xmTnIiSjv","margin":"","level":2,"name":"head","location":{"start":{"line":43,"column":1,"offset":1774},"end":{"line":43,"column":11,"offset":1784}},"content":["Support"]},{"type":"para","id":"VuJ0iCokXs1xEReFcRT3u","margin":"","location":{"start":{"line":45,"column":1,"offset":1786},"end":{"line":45,"column":99,"offset":1884}},"text":"text","content":["This has some fairly specific environmental dependencies, so before raising an issue please check:"]},{"type":"list","id":"XKnEH5qSFIWvBhRLhZbLJ","margin":"","level":1,"list":"itemized","content":[{"type":"block","id":"A5iQHxDO_HZ3F_LAFJXZ1","margin":"","name":"item","level":1,"location":{"start":{"line":47,"column":1,"offset":1886},"end":{"line":47,"column":58,"offset":1943}},"content":[{"type":"para","id":"TqMk5FkP_wF9yO4yx0NLy","margin":"","location":{"start":{"line":47,"column":3,"offset":1888},"end":{"line":47,"column":58,"offset":1943}},"text":"text","content":["You are running your application in an AWS EC2 instance"]}]},{"type":"block","id":"vrUNHVnP-yoMYRGIWW8n-","margin":"","name":"item","level":1,"location":{"start":{"line":48,"column":1,"offset":1944},"end":{"line":48,"column":183,"offset":2126}},"content":[{"type":"para","id":"yLXtWFgtnNIjXX_wfO4KV","margin":"","location":{"start":{"line":48,"column":3,"offset":1946},"end":{"line":48,"column":183,"offset":2126}},"text":"text","content":["That you have created the ",{"meta":"https://docs.aws.amazon.com/IAM/latest/UserGuide/WorkingWithRoles.html","type":"fcode","name":"L","content":["IAM Role"]},", given it the required permissions and associated it your EC2 instance."]}]}]},{"type":"para","id":"9lsft8zngh9AhPVqz7B9E","margin":"","location":{"start":{"line":50,"column":1,"offset":2128},"end":{"line":50,"column":129,"offset":2256}},"text":"text","content":["Any suggestions/issues/etc can be posted to ",{"meta":"https://github.com/jonathanstowe/Kivuli/issues","type":"fcode","name":"L","content":["github"]}," and I'll see what I can do."]},{"type":"block","id":"g6FtgDGU-QwCr3ARtVfCy","margin":"","level":1,"name":"head","location":{"start":{"line":52,"column":1,"offset":2258},"end":{"line":52,"column":24,"offset":2281}},"content":["Licence and Copyright"]},{"type":"para","id":"-PhZ7AkJUNqugWRQABCQZ","margin":"","location":{"start":{"line":54,"column":1,"offset":2283},"end":{"line":54,"column":83,"offset":2365}},"text":"text","content":["This is free software please see the ",{"meta":"LICENCE","type":"fcode","name":"L","content":["LICENCE"]}," in the distribution files."]},{"type":"para","id":"cv0p08EA_IYkw_9fpoXcq","margin":"","location":{"start":{"line":56,"column":1,"offset":2367},"end":{"line":56,"column":22,"offset":2388}},"text":"text","content":["© Jonathan Stowe 2021"]}]},"publishUrl":"/mods/zef/Kivuli/Kivuli-0.0.4/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"1.0","auth":"zef:jonathanstowe","authors":["Jonathan Stowe <jns+gh@gellyfish.co.uk>"],"build-depends":[],"depends":["Cro::HTTP::Client","JSON::Class","Test::Mock"],"description":"Access AWS IAM role credentials within EC2","dist":"Kivuli:ver<0.0.4>:auth<zef:jonathanstowe>","license":"Artistic-2.0","meta-version":"1","name":"Kivuli","path":"K/IV/KIVULI/23e63b053b1b0e7de6eb21e9c542c77d4bce5789.tar.gz","provides":{"Kivuli":"lib/Kivuli.rakumod"},"raku":"6.d","resources":[],"source-url":"https://github.com/jonathanstowe/Kivuli.git","support":{"email":"jns+gh@gellyfish.co.uk","source":"https://github.com/jonathanstowe/Kivuli.git"},"tags":["AWS","IAM","EC2","credentials"],"test-depends":["Test::Mock"],"version":"0.0.4"},"files":[{"file":"work_mods/zef/Kivuli/Kivuli-0.0.4/README.md","publishUrl":"/mods/zef/Kivuli/Kivuli-0.0.4/README.md"},{"file":"work_mods/zef/Kivuli/Kivuli-0.0.4/lib/Kivuli.rakumod","publishUrl":"/mods/zef/Kivuli/Kivuli-0.0.4/lib/Kivuli.rakumod"}],"src":"zef","url":"/mods/zef/Kivuli"}}}
=end data


React

    =begin React :component<RenderItem>
    =begin data
    {"type":"page","file":"work_mods/zef/Kivuli/Kivuli-0.0.4/README.md","sources":[],"node":{"type":"block","id":"tm4vu9d7IozLOl-wdmpiv","margin":"","name":"root","content":[{"type":"block","id":"jU7TsJKdzOzps-cEqDHa9","margin":"","level":1,"name":"head","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":9,"offset":8}},"content":["Kivuli"]},{"type":"para","id":"jG5kFiI4cELwlZEXai8Yw","margin":"","location":{"start":{"line":3,"column":1,"offset":10},"end":{"line":3,"column":36,"offset":45}},"text":"text","content":["Get AWS IAM role credentials in EC2"]},{"type":"para","id":"gKZY15DaAsW4cdSSw5-A6","margin":"","location":{"start":{"line":5,"column":1,"offset":47},"end":{"line":5,"column":154,"offset":200}},"text":"text","content":[{"meta":"https://github.com/jonathanstowe/Kivuli/actions/workflows/main.yml","type":"fcode","name":"L","content":[{"type":"block","id":"g2PQZWa4ymd_oACMuLx7u","margin":"","name":"Image","config":[],"location":{"start":{"line":5,"column":2,"offset":48},"end":{"line":5,"column":85,"offset":131}},"content":[{"type":"image","src":"https://github.com/jonathanstowe/Kivuli/actions/workflows/main.yml/badge.svg","alt":"CI"}]}]}]},{"type":"block","id":"_8HDys3M5LOgXP6ePY2Dx","margin":"","level":2,"name":"head","location":{"start":{"line":7,"column":1,"offset":202},"end":{"line":7,"column":12,"offset":213}},"content":["Synopsis"]},{"type":"block","id":"BdVOVzECdw_w7p1RnYf2w","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":9,"column":1,"offset":215},"end":{"line":22,"column":4,"offset":544}},"content":[{"type":"verbatim","value":"\n# In some application running on EC2\n\nuse Kivuli;\nuse WebService::AWS::S3;\n\nmy $k = Kivuli.new(role-name => 'my-iam-role');\nmy $s3 = WebService::AWS::S3.new(secret-access-key => $k.secret-access-key, access-key-id => $k.access-key-id, security-token => $k.token, region => 'eu-west-2');\n\n# Do something with the S3\n\n"}]},{"type":"block","id":"YEfB8Y_gVwMCcBmUfnANy","margin":"","level":2,"name":"head","location":{"start":{"line":24,"column":1,"offset":546},"end":{"line":24,"column":15,"offset":560}},"content":["Description"]},{"type":"para","id":"rZ8TbLHK-eKlmfLnwVB20","margin":"","location":{"start":{"line":26,"column":1,"offset":562},"end":{"line":26,"column":187,"offset":748}},"text":"text","content":["This module enables access to AWS IAM role credentials from within an EC2 instance as ",{"meta":"https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/iam-roles-for-amazon-ec2.html","type":"fcode","name":"L","content":["described here"]},"."]},{"type":"para","id":"QP0_LK8Osh_AiNOFOzYPQ","margin":"","location":{"start":{"line":28,"column":1,"offset":750},"end":{"line":28,"column":188,"offset":937}},"text":"text","content":["The credentials supplied ( ",{"type":"fcode","name":"C","content":["AWS_ACCES_KEY_ID"]},", ",{"type":"fcode","name":"C","content":["AWS_SECRET_ACCESS_KEY"]},", ",{"type":"fcode","name":"C","content":["AWS_SESSION_TOKEN"]},") can be used to authenticate with another AWS service that the role has been granted access to."]},{"type":"para","id":"sJ1NXKH82SOzhY6xfldLN","margin":"","location":{"start":{"line":30,"column":1,"offset":939},"end":{"line":30,"column":197,"offset":1135}},"text":"text","content":["Because the credentials are supplied in a way that is private to the EC2 instance this is a more secure method of obtaining the credentials than, for example, putting them in a configuration file."]},{"type":"para","id":"eTyvP1qkeCzew_Q8-9g9R","margin":"","location":{"start":{"line":32,"column":1,"offset":1137},"end":{"line":33,"column":111,"offset":1432}},"text":"text","content":["The ",{"type":"fcode","name":"C","content":["token"]}," ",{"type":"fcode","name":"B","content":["must"]}," be supplied in the headers (or as a query parameter,) for requests to the service, however some services differ as to whether it should or shouldn't be part of the\nsigned headers in the request - please see the documentation for the service you are implementing for details."]},{"type":"block","id":"SHz5ncWYgDWfTxbldFd1Q","margin":"","level":2,"name":"head","location":{"start":{"line":35,"column":1,"offset":1434},"end":{"line":35,"column":16,"offset":1449}},"content":["Installation"]},{"type":"para","id":"i3-Q5IHQoObiwgHMRw8Ys","margin":"","location":{"start":{"line":37,"column":1,"offset":1451},"end":{"line":37,"column":102,"offset":1552}},"text":"text","content":["Assuming you have a working ",{"type":"fcode","name":"I","content":["rakudo"]}," installation then you should be able to install this with ",{"type":"fcode","name":"I","content":["zef"]},":"]},{"type":"block","id":"wc6uZNZqjaJ-ROhN8Hs1e","margin":"","name":"code","config":[],"location":{"start":{"line":39,"column":1,"offset":1554},"end":{"line":39,"column":24,"offset":1577}},"content":[{"type":"verbatim","value":" zef install Kivuli"}]},{"type":"para","id":"frgDEGHc-Z3sItaZCtram","margin":"","location":{"start":{"line":41,"column":1,"offset":1579},"end":{"line":41,"column":194,"offset":1772}},"text":"text","content":["Bear in mind that this will pass its tests and install outside an EC2 instance, which may be useful for example to build a Docker image to upload to AWS, but it will only work correctly on EC2."]},{"type":"block","id":"ykeqZAv3FyW8xmTnIiSjv","margin":"","level":2,"name":"head","location":{"start":{"line":43,"column":1,"offset":1774},"end":{"line":43,"column":11,"offset":1784}},"content":["Support"]},{"type":"para","id":"VuJ0iCokXs1xEReFcRT3u","margin":"","location":{"start":{"line":45,"column":1,"offset":1786},"end":{"line":45,"column":99,"offset":1884}},"text":"text","content":["This has some fairly specific environmental dependencies, so before raising an issue please check:"]},{"type":"list","id":"XKnEH5qSFIWvBhRLhZbLJ","margin":"","level":1,"list":"itemized","content":[{"type":"block","id":"A5iQHxDO_HZ3F_LAFJXZ1","margin":"","name":"item","level":1,"location":{"start":{"line":47,"column":1,"offset":1886},"end":{"line":47,"column":58,"offset":1943}},"content":[{"type":"para","id":"TqMk5FkP_wF9yO4yx0NLy","margin":"","location":{"start":{"line":47,"column":3,"offset":1888},"end":{"line":47,"column":58,"offset":1943}},"text":"text","content":["You are running your application in an AWS EC2 instance"]}]},{"type":"block","id":"vrUNHVnP-yoMYRGIWW8n-","margin":"","name":"item","level":1,"location":{"start":{"line":48,"column":1,"offset":1944},"end":{"line":48,"column":183,"offset":2126}},"content":[{"type":"para","id":"yLXtWFgtnNIjXX_wfO4KV","margin":"","location":{"start":{"line":48,"column":3,"offset":1946},"end":{"line":48,"column":183,"offset":2126}},"text":"text","content":["That you have created the ",{"meta":"https://docs.aws.amazon.com/IAM/latest/UserGuide/WorkingWithRoles.html","type":"fcode","name":"L","content":["IAM Role"]},", given it the required permissions and associated it your EC2 instance."]}]}]},{"type":"para","id":"9lsft8zngh9AhPVqz7B9E","margin":"","location":{"start":{"line":50,"column":1,"offset":2128},"end":{"line":50,"column":129,"offset":2256}},"text":"text","content":["Any suggestions/issues/etc can be posted to ",{"meta":"https://github.com/jonathanstowe/Kivuli/issues","type":"fcode","name":"L","content":["github"]}," and I'll see what I can do."]},{"type":"block","id":"g6FtgDGU-QwCr3ARtVfCy","margin":"","level":1,"name":"head","location":{"start":{"line":52,"column":1,"offset":2258},"end":{"line":52,"column":24,"offset":2281}},"content":["Licence and Copyright"]},{"type":"para","id":"-PhZ7AkJUNqugWRQABCQZ","margin":"","location":{"start":{"line":54,"column":1,"offset":2283},"end":{"line":54,"column":83,"offset":2365}},"text":"text","content":["This is free software please see the ",{"meta":"LICENCE","type":"fcode","name":"L","content":["LICENCE"]}," in the distribution files."]},{"type":"para","id":"cv0p08EA_IYkw_9fpoXcq","margin":"","location":{"start":{"line":56,"column":1,"offset":2367},"end":{"line":56,"column":22,"offset":2388}},"text":"text","content":["© Jonathan Stowe 2021"]}]},"publishUrl":"/mods/zef/Kivuli/Kivuli-0.0.4/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"1.0","auth":"zef:jonathanstowe","authors":["Jonathan Stowe <jns+gh@gellyfish.co.uk>"],"build-depends":[],"depends":["Cro::HTTP::Client","JSON::Class","Test::Mock"],"description":"Access AWS IAM role credentials within EC2","dist":"Kivuli:ver<0.0.4>:auth<zef:jonathanstowe>","license":"Artistic-2.0","meta-version":"1","name":"Kivuli","path":"K/IV/KIVULI/23e63b053b1b0e7de6eb21e9c542c77d4bce5789.tar.gz","provides":{"Kivuli":"lib/Kivuli.rakumod"},"raku":"6.d","resources":[],"source-url":"https://github.com/jonathanstowe/Kivuli.git","support":{"email":"jns+gh@gellyfish.co.uk","source":"https://github.com/jonathanstowe/Kivuli.git"},"tags":["AWS","IAM","EC2","credentials"],"test-depends":["Test::Mock"],"version":"0.0.4"},"files":[{"file":"work_mods/zef/Kivuli/Kivuli-0.0.4/README.md","publishUrl":"/mods/zef/Kivuli/Kivuli-0.0.4/README.md"},{"file":"work_mods/zef/Kivuli/Kivuli-0.0.4/lib/Kivuli.rakumod","publishUrl":"/mods/zef/Kivuli/Kivuli-0.0.4/lib/Kivuli.rakumod"}],"src":"zef","url":"/mods/zef/Kivuli"}}}
    =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

Kivuli


=begin data
{"type":"page","file":"work_mods/zef/L10N::CY/dist/README.md","sources":[],"node":{"type":"block","id":"5ylNaZxRIgJPHOymTp1lN","margin":"","name":"root","content":[{"type":"block","id":"i5gQercGmpSmp1-YtOcyh","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":"jAoha2MiA-4DbfdeG9hEj","margin":"","location":{"start":{"line":3,"column":1,"offset":8},"end":{"line":3,"column":38,"offset":45}},"text":"text","content":["L10N::CY - Welsh localization of Raku"]},{"type":"block","id":"aSomNgXFsF2tW-wO3CWrt","margin":"","level":1,"name":"head","location":{"start":{"line":5,"column":1,"offset":47},"end":{"line":5,"column":11,"offset":57}},"content":["SYNOPSIS"]},{"type":"block","id":"P991_vjqcU-C8ZlDVPOdC","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":7,"column":1,"offset":59},"end":{"line":10,"column":4,"offset":106}},"content":[{"type":"verbatim","value":"use L10N::CY;\ndwueda \"Hello World\";"}]},{"type":"block","id":"13Dsw4-VlppB3oCnkI4Kn","margin":"","level":1,"name":"head","location":{"start":{"line":12,"column":1,"offset":108},"end":{"line":12,"column":14,"offset":121}},"content":["DESCRIPTION"]},{"type":"para","id":"t773f7CNvxZh8aDuAmxSt","margin":"","location":{"start":{"line":14,"column":1,"offset":123},"end":{"line":14,"column":94,"offset":216}},"text":"text","content":["L10N::CY contains the logic to provide a Welsh localization of the Raku Programming Language."]},{"type":"para","id":"MyIZ_iygm11a0GI5oe2Fa","margin":"","location":{"start":{"line":16,"column":1,"offset":218},"end":{"line":16,"column":63,"offset":280}},"text":"text","content":["It's based on the Klingon localization by Elizabeth Mattisjen."]},{"type":"block","id":"g0dnx4PX1yOY0xSkVEfLa","margin":"","level":1,"name":"head","location":{"start":{"line":18,"column":1,"offset":282},"end":{"line":18,"column":9,"offset":290}},"content":["AUTHOR"]},{"type":"para","id":"OTVJd43ToerarOq9PjTME","margin":"","location":{"start":{"line":20,"column":1,"offset":292},"end":{"line":21,"column":37,"offset":372}},"text":"text","content":["Richard Hainsworth ",{"meta":"mailto:rnhainsworth@gmail.com","type":"fcode","name":"L","content":["rnhainsworth@gmail.com"]},"\nElizabeth Mattijsen ",{"meta":"mailto:liz@raku.rocks","type":"fcode","name":"L","content":["liz@raku.rocks"]}]},{"type":"para","id":"8jFSnyhY7K3H_b23YbL6J","margin":"","location":{"start":{"line":23,"column":1,"offset":374},"end":{"line":24,"column":71,"offset":559}},"text":"text","content":["Source can be located at: ",{"meta":"https://github.com/finanalyst/rakuast-L10N-CY","type":"fcode","name":"L","content":["https://github.com/finanalyst/rakuast-L10N-CY"]},". Comments and Pull Requests are welcome.","Klingon source can be located at: ",{"meta":"https://github.com/lizmat/L10N-TLH","type":"fcode","name":"L","content":["https://github.com/lizmat/L10N-TLH"]}," ."]},{"type":"block","id":"2T-15P6nac9g2TS_FY0w6","margin":"","level":1,"name":"head","location":{"start":{"line":26,"column":1,"offset":561},"end":{"line":26,"column":24,"offset":584}},"content":["COPYRIGHT AND LICENSE"]},{"type":"para","id":"20HBjWA6bP-j06C8cdUDX","margin":"","location":{"start":{"line":28,"column":1,"offset":586},"end":{"line":28,"column":34,"offset":619}},"text":"text","content":["Copyright 2023 Richard Hainsworth"]},{"type":"para","id":"DlKTi3rtowbGJOhsHg3B3","margin":"","location":{"start":{"line":30,"column":1,"offset":621},"end":{"line":30,"column":104,"offset":724}},"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/L10N::CY/dist/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"","auth":"zef:finanalyst","authors":["Elizabeth Mattijsen","Richard Hainsworth"],"build-depends":[],"depends":[],"description":"Welsh localization of Raku","dist":"L10N::CY:ver<0.0.1>:auth<zef:finanalyst>","license":"Artistic-2.0","name":"L10N::CY","path":"L/10/L10N_CY/f36c8f76ee8b7124979620d579e4608836de5f39.tar.gz","perl":"6.d","provides":{"L10N::CY":"lib/L10N/CY.rakumod","RakuAST::Deparse::L10N::CY":"lib/RakuAST/Deparse/L10N/CY.rakumod"},"resources":["bin/draig","bin/tr2draig"],"source-url":"https://github.com/finanalyst/L10N-CY.git","tags":["LOCALIZATION","WELSH","CY"],"test-depends":[],"version":"0.0.1"},"files":[{"file":"work_mods/zef/L10N::CY/dist/README.md","publishUrl":"/mods/zef/L10N::CY/dist/README.md"},{"file":"work_mods/zef/L10N::CY/dist/How-to-create-a-language.md","publishUrl":"/mods/zef/L10N::CY/dist/How-to-create-a-language.md"},{"file":"work_mods/zef/L10N::CY/dist/docs/How-to-create-a-language.rakudoc","publishUrl":"/mods/zef/L10N::CY/dist/docs/How-to-create-a-language.rakudoc"}],"src":"zef","url":"/mods/zef/L10N::CY"}}}
=end data


    =begin React :component<RenderItem>
    =begin data
    {"type":"page","file":"work_mods/zef/L10N::CY/dist/README.md","sources":[],"node":{"type":"block","id":"5ylNaZxRIgJPHOymTp1lN","margin":"","name":"root","content":[{"type":"block","id":"i5gQercGmpSmp1-YtOcyh","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":"jAoha2MiA-4DbfdeG9hEj","margin":"","location":{"start":{"line":3,"column":1,"offset":8},"end":{"line":3,"column":38,"offset":45}},"text":"text","content":["L10N::CY - Welsh localization of Raku"]},{"type":"block","id":"aSomNgXFsF2tW-wO3CWrt","margin":"","level":1,"name":"head","location":{"start":{"line":5,"column":1,"offset":47},"end":{"line":5,"column":11,"offset":57}},"content":["SYNOPSIS"]},{"type":"block","id":"P991_vjqcU-C8ZlDVPOdC","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":7,"column":1,"offset":59},"end":{"line":10,"column":4,"offset":106}},"content":[{"type":"verbatim","value":"use L10N::CY;\ndwueda \"Hello World\";"}]},{"type":"block","id":"13Dsw4-VlppB3oCnkI4Kn","margin":"","level":1,"name":"head","location":{"start":{"line":12,"column":1,"offset":108},"end":{"line":12,"column":14,"offset":121}},"content":["DESCRIPTION"]},{"type":"para","id":"t773f7CNvxZh8aDuAmxSt","margin":"","location":{"start":{"line":14,"column":1,"offset":123},"end":{"line":14,"column":94,"offset":216}},"text":"text","content":["L10N::CY contains the logic to provide a Welsh localization of the Raku Programming Language."]},{"type":"para","id":"MyIZ_iygm11a0GI5oe2Fa","margin":"","location":{"start":{"line":16,"column":1,"offset":218},"end":{"line":16,"column":63,"offset":280}},"text":"text","content":["It's based on the Klingon localization by Elizabeth Mattisjen."]},{"type":"block","id":"g0dnx4PX1yOY0xSkVEfLa","margin":"","level":1,"name":"head","location":{"start":{"line":18,"column":1,"offset":282},"end":{"line":18,"column":9,"offset":290}},"content":["AUTHOR"]},{"type":"para","id":"OTVJd43ToerarOq9PjTME","margin":"","location":{"start":{"line":20,"column":1,"offset":292},"end":{"line":21,"column":37,"offset":372}},"text":"text","content":["Richard Hainsworth ",{"meta":"mailto:rnhainsworth@gmail.com","type":"fcode","name":"L","content":["rnhainsworth@gmail.com"]},"\nElizabeth Mattijsen ",{"meta":"mailto:liz@raku.rocks","type":"fcode","name":"L","content":["liz@raku.rocks"]}]},{"type":"para","id":"8jFSnyhY7K3H_b23YbL6J","margin":"","location":{"start":{"line":23,"column":1,"offset":374},"end":{"line":24,"column":71,"offset":559}},"text":"text","content":["Source can be located at: ",{"meta":"https://github.com/finanalyst/rakuast-L10N-CY","type":"fcode","name":"L","content":["https://github.com/finanalyst/rakuast-L10N-CY"]},". Comments and Pull Requests are welcome.","Klingon source can be located at: ",{"meta":"https://github.com/lizmat/L10N-TLH","type":"fcode","name":"L","content":["https://github.com/lizmat/L10N-TLH"]}," ."]},{"type":"block","id":"2T-15P6nac9g2TS_FY0w6","margin":"","level":1,"name":"head","location":{"start":{"line":26,"column":1,"offset":561},"end":{"line":26,"column":24,"offset":584}},"content":["COPYRIGHT AND LICENSE"]},{"type":"para","id":"20HBjWA6bP-j06C8cdUDX","margin":"","location":{"start":{"line":28,"column":1,"offset":586},"end":{"line":28,"column":34,"offset":619}},"text":"text","content":["Copyright 2023 Richard Hainsworth"]},{"type":"para","id":"DlKTi3rtowbGJOhsHg3B3","margin":"","location":{"start":{"line":30,"column":1,"offset":621},"end":{"line":30,"column":104,"offset":724}},"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/L10N::CY/dist/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"","auth":"zef:finanalyst","authors":["Elizabeth Mattijsen","Richard Hainsworth"],"build-depends":[],"depends":[],"description":"Welsh localization of Raku","dist":"L10N::CY:ver<0.0.1>:auth<zef:finanalyst>","license":"Artistic-2.0","name":"L10N::CY","path":"L/10/L10N_CY/f36c8f76ee8b7124979620d579e4608836de5f39.tar.gz","perl":"6.d","provides":{"L10N::CY":"lib/L10N/CY.rakumod","RakuAST::Deparse::L10N::CY":"lib/RakuAST/Deparse/L10N/CY.rakumod"},"resources":["bin/draig","bin/tr2draig"],"source-url":"https://github.com/finanalyst/L10N-CY.git","tags":["LOCALIZATION","WELSH","CY"],"test-depends":[],"version":"0.0.1"},"files":[{"file":"work_mods/zef/L10N::CY/dist/README.md","publishUrl":"/mods/zef/L10N::CY/dist/README.md"},{"file":"work_mods/zef/L10N::CY/dist/How-to-create-a-language.md","publishUrl":"/mods/zef/L10N::CY/dist/How-to-create-a-language.md"},{"file":"work_mods/zef/L10N::CY/dist/docs/How-to-create-a-language.rakudoc","publishUrl":"/mods/zef/L10N::CY/dist/docs/How-to-create-a-language.rakudoc"}],"src":"zef","url":"/mods/zef/L10N::CY"}}}
    =end data
    =end React


Welsh localization of Raku


L10N::CY


=begin data
{"type":"page","file":"work_mods/zef/Kind/ra-Kind/README.md","sources":[],"node":{"type":"block","id":"aJVaTGjdvTqdDjKT2i10s","margin":"","name":"root","content":[{"type":"para","id":"3pbtu3gkxZHUNjGng4RWg","margin":"","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":154,"offset":153}},"text":"text","content":[{"meta":"https://github.com/Kaiepi/ra-Kind/actions/workflows/test.yaml","type":"fcode","name":"L","content":[{"type":"block","id":"TV16FH7d4v6T758WEJPrh","margin":"","name":"Image","config":[],"location":{"start":{"line":1,"column":2,"offset":1},"end":{"line":1,"column":90,"offset":89}},"content":[{"type":"image","src":"https://github.com/Kaiepi/ra-Kind/actions/workflows/test.yaml/badge.svg","alt":"Build Status"}]}]}]},{"type":"block","id":"Qkd-_p8V9Y59HkYqW4uZz","margin":"","level":1,"name":"head","location":{"start":{"line":3,"column":1,"offset":155},"end":{"line":3,"column":7,"offset":161}},"content":["NAME"]},{"type":"para","id":"uE5ZscopihtpWvADxaXmm","margin":"","location":{"start":{"line":5,"column":1,"offset":163},"end":{"line":5,"column":35,"offset":197}},"text":"text","content":["Kind - Typechecking based on kinds"]},{"type":"block","id":"TQuqG-7hZqsw6-FhOj2ro","margin":"","level":1,"name":"head","location":{"start":{"line":7,"column":1,"offset":199},"end":{"line":7,"column":11,"offset":209}},"content":["SYNOPSIS"]},{"type":"block","id":"4svbLXfg26uTE233vLEXR","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":9,"column":1,"offset":211},"end":{"line":20,"column":4,"offset":470}},"content":[{"type":"verbatim","value":"use Kind;\n\nmy constant Class = Kind[Metamodel::ClassHOW];\n\nproto sub is-class(Mu --> Bool:D)  {*}\nmulti sub is-class(Class --> True) { }\nmulti sub is-class(Mu --> False)   { }\n\nsay Str.&is-class;  # OUTPUT: True\nsay Blob.&is-class; # OUTPUT: False"}]},{"type":"block","id":"cOkdstrDoeYVnY7-jHuFg","margin":"","level":1,"name":"head","location":{"start":{"line":22,"column":1,"offset":472},"end":{"line":22,"column":14,"offset":485}},"content":["DESCRIPTION"]},{"type":"para","id":"2QJtt0uw1LB6XICxQZXBm","margin":"","location":{"start":{"line":24,"column":1,"offset":487},"end":{"line":24,"column":280,"offset":766}},"text":"text","content":[{"type":"fcode","name":"C","content":["Kind"]}," is an uninstantiable parametric type that can be used to typecheck values based off their kind. A parameterization produces a type object that can process the HOW of a type in a typecheck context with ",{"type":"fcode","name":"C","content":["ACCEPTS"]}," when available, otherwise falling back to the bare typecheck."]},{"type":"para","id":"lK9r4HLjfvGX1_0dwmzT2","margin":"","location":{"start":{"line":26,"column":1,"offset":768},"end":{"line":26,"column":101,"offset":868}},"text":"text","content":[{"type":"fcode","name":"C","content":["Kind"]}," is documented. You can view the documentation for it and its methods at any time using ",{"type":"fcode","name":"C","content":["WHY"]},"."]},{"type":"block","id":"oO-CjXQ5X0pibxNmk91u1","margin":"","level":1,"name":"head","location":{"start":{"line":28,"column":1,"offset":870},"end":{"line":28,"column":14,"offset":883}},"content":["METAMETHODS"]},{"type":"block","id":"3sHlHWRr1v2ymYq2-0f5Y","margin":"","level":2,"name":"head","location":{"start":{"line":30,"column":1,"offset":885},"end":{"line":30,"column":23,"offset":907}},"content":["method parameterize"]},{"type":"block","id":"ajiUVOOyE21UqHMohwTFQ","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":32,"column":1,"offset":909},"end":{"line":34,"column":4,"offset":955}},"content":[{"type":"verbatim","value":"method ^parameterize(|args) is raw"}]},{"type":"para","id":"pxedbLyqa3GPifJUPyr4E","margin":"","location":{"start":{"line":36,"column":1,"offset":957},"end":{"line":36,"column":66,"offset":1022}},"text":"text","content":["Produces a parameterization by delegating to ",{"type":"fcode","name":"C","content":["^kind"]}," with ",{"type":"fcode","name":"C","content":["args"]},"."]},{"type":"block","id":"Phu2DnK_BAmIdn3KbiHaw","margin":"","level":2,"name":"head","location":{"start":{"line":38,"column":1,"offset":1024},"end":{"line":38,"column":15,"offset":1038}},"content":["method kind"]},{"type":"block","id":"30JQNkMrcmF9Y9feGTEvp","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":40,"column":1,"offset":1040},"end":{"line":42,"column":4,"offset":1108}},"content":[{"type":"verbatim","value":"method ^kind(Mu $obj is raw, Mu \\K, Mu:U \\T = Mu) is raw"}]},{"type":"para","id":"eObY16N_VYfCgehdhSGzw","margin":"","location":{"start":{"line":44,"column":1,"offset":1110},"end":{"line":44,"column":277,"offset":1386}},"text":"text","content":["Produces a cached subset with a refinement (",{"type":"fcode","name":"C","content":["where"]},") built from ",{"type":"fcode","name":"C","content":["K"]}," and a refinement (",{"type":"fcode","name":"C","content":["of"]},") from ",{"type":"fcode","name":"C","content":["T"]}," if present. This backs ",{"type":"fcode","name":"C","content":["^parameterize"]}," so as to allow for a different parameterizer in a subtype. This is more or less a wrapper for ",{"type":"fcode","name":"C","content":["Metamodel::Primitives.parameterize_type"]},"."]},{"type":"para","id":"OMiXYEBktttQqg5QySAnG","margin":"","location":{"start":{"line":46,"column":1,"offset":1388},"end":{"line":46,"column":53,"offset":1440}},"text":"text","content":["Some useful values with which to produce a type are:"]},{"type":"list","id":"u7YwfT9JWFb5OorGUsMrE","margin":"","level":1,"list":"itemized","content":[{"type":"block","id":"qOZYNVmvoLZFgZFDO6F4c","margin":"","name":"item","level":1,"location":{"start":{"line":48,"column":1,"offset":1442},"end":{"line":48,"column":26,"offset":1467}},"content":[{"type":"para","id":"lIOJfW30HWNSXuydz2bD8","margin":"","location":{"start":{"line":48,"column":3,"offset":1444},"end":{"line":48,"column":26,"offset":1467}},"text":"text","content":["a metaclass or metarole"]}]}]},{"type":"block","id":"OKD5z_pEYFOC5hVWPYhp-","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":50,"column":1,"offset":1469},"end":{"line":53,"column":4,"offset":1532}},"content":[{"type":"verbatim","value":"# Smartmatches any class.\nKind[Metamodel::ClassHOW]"}]},{"type":"list","id":"p-uPOxm3Ey8yFUudJTvj9","margin":"","level":1,"list":"itemized","content":[{"type":"block","id":"UIXQ1ND3SWCrV8L3Tyjc9","margin":"","name":"item","level":1,"location":{"start":{"line":55,"column":1,"offset":1534},"end":{"line":55,"column":41,"offset":1574}},"content":[{"type":"para","id":"6OMZLoZS3ZVQjXEQMMVQI","margin":"","location":{"start":{"line":55,"column":3,"offset":1536},"end":{"line":55,"column":41,"offset":1574}},"text":"text","content":["a junction of metaclasses or metaroles"]}]}]},{"type":"block","id":"9lbr6a93QGAVCW8ZvzIq4","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":57,"column":1,"offset":1576},"end":{"line":60,"column":4,"offset":1735}},"content":[{"type":"verbatim","value":"# Smartmatches any type that supports naming, versioning, and documenting.\nKind[Metamodel::Naming & Metamodel::Versioning & Metamodel::Documenting]"}]},{"type":"list","id":"cQzVb1FjleSdTbwORw7U5","margin":"","level":1,"list":"itemized","content":[{"type":"block","id":"sxFMLve9RAcBuhhoDuxY4","margin":"","name":"item","level":1,"location":{"start":{"line":62,"column":1,"offset":1737},"end":{"line":62,"column":10,"offset":1746}},"content":[{"type":"para","id":"pYhM5SjI8M6xfO9a0AZz1","margin":"","location":{"start":{"line":62,"column":3,"offset":1739},"end":{"line":62,"column":10,"offset":1746}},"text":"text","content":["a block"]}]}]},{"type":"block","id":"Qp1QSh6gxWSB6wC1_NcBm","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":64,"column":1,"offset":1748},"end":{"line":67,"column":4,"offset":1857}},"content":[{"type":"verbatim","value":"# Smartmatches any parametric type.\nKind[{ use nqp; nqp::hllbool(nqp::can($_, 'parameterize')) }]"}]},{"type":"list","id":"1eRahuKOr5LksM5N9DqLE","margin":"","level":1,"list":"itemized","content":[{"type":"block","id":"4rA0-sNwC-e5U-dAJBudV","margin":"","name":"item","level":1,"location":{"start":{"line":69,"column":1,"offset":1859},"end":{"line":69,"column":15,"offset":1873}},"content":[{"type":"para","id":"qxcTSFbc-pf4SsdeRFjXZ","margin":"","location":{"start":{"line":69,"column":3,"offset":1861},"end":{"line":69,"column":15,"offset":1873}},"text":"text","content":["a metaobject"]}]}]},{"type":"block","id":"CormAhcH6GF2_VuLQJzem","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":71,"column":1,"offset":1875},"end":{"line":86,"column":4,"offset":2301}},"content":[{"type":"verbatim","value":"# This class' metamethods constrain their metaobject to itself or its subtypes.\nclass Configurable {\n    my constant K := Kind[$?CLASS.HOW.WHAT, $?CLASS];\n\n    my constant %configuration := hash;\n\n    method ^configure(K $obj, %config --> Map:D) {\n        %configuration{$obj.WHAT.WHICH} := %config.Map\n    }\n\n    method ^configuration(K $obj --> Map:D) {\n        %configuration{$obj.WHAT.WHICH} // Map.new\n    }\n}"}]},{"type":"para","id":"JDZ0lq98eEUyNrGTN43wE","margin":"","location":{"start":{"line":88,"column":1,"offset":2303},"end":{"line":88,"column":79,"offset":2381}},"text":"text","content":["For more examples of parameterizations of ",{"type":"fcode","name":"C","content":["Kind"]},", refer to ",{"type":"fcode","name":"C","content":["t/01-typecheck.t"]},"."]},{"type":"block","id":"ppqpOhjlWWTDakpyHJOl8","margin":"","level":1,"name":"head","location":{"start":{"line":90,"column":1,"offset":2383},"end":{"line":90,"column":10,"offset":2392}},"content":["SYMBOLS"]},{"type":"block","id":"JKAnvq8ydMbNNpcd0DCMM","margin":"","level":2,"name":"head","location":{"start":{"line":92,"column":1,"offset":2394},"end":{"line":92,"column":22,"offset":2415}},"content":["&set_parameterizer"]},{"type":"block","id":"q_JRvJSfkBCdqaapz3RDZ","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":94,"column":1,"offset":2417},"end":{"line":96,"column":4,"offset":2510}},"content":[{"type":"verbatim","value":"our sub set_parameterizer(Mu $obj is raw, &parameterizer = &parameterize --> Nil)"}]},{"type":"para","id":"a9TySK6Hm8maktyhjaCJh","margin":"","location":{"start":{"line":98,"column":1,"offset":2512},"end":{"line":98,"column":212,"offset":2723}},"text":"text","content":["Applies the parameterizer of ",{"type":"fcode","name":"C","content":["Kind"]}," to a metaobject, providing it with a parameterization cache. A subtype needs to apply this at ",{"type":"fcode","name":"C","content":["BEGIN"]},"-time in order to parameterize with the default metamethods, for instance:"]},{"type":"block","id":"4AT7Fv0Ue_-j4Y5hsSdoO","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":100,"column":1,"offset":2725},"end":{"line":104,"column":4,"offset":2817}},"content":[{"type":"verbatim","value":"class Kind::Instantiable is Kind {\n    BEGIN Kind::set_parameterizer($?CLASS);\n}"}]},{"type":"para","id":"k7BDZSwxtxDDvv3bd0rFp","margin":"","location":{"start":{"line":106,"column":1,"offset":2819},"end":{"line":106,"column":139,"offset":2957}},"text":"text","content":["A ",{"type":"fcode","name":"C","content":["&parameterizer"]}," may be provided, in which case that will be set instead. This should carry a compatible signature with ",{"type":"fcode","name":"C","content":["&parameterize"]},"."]},{"type":"para","id":"4Rmv1HC1jtXfVJBMp6Gvu","margin":"","location":{"start":{"line":108,"column":1,"offset":2959},"end":{"line":108,"column":69,"offset":3027}},"text":"text","content":["For more examples of how to subclass ",{"type":"fcode","name":"C","content":["Kind"]},", refer to ",{"type":"fcode","name":"C","content":["t/02-meta.t"]},"."]},{"type":"block","id":"BQZnXEMz3VJFnsYibD-Ja","margin":"","level":2,"name":"head","location":{"start":{"line":110,"column":1,"offset":3029},"end":{"line":110,"column":17,"offset":3045}},"content":["&parameterize"]},{"type":"block","id":"AU3VKGtVZxZ68ABMX_Zdv","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":112,"column":1,"offset":3047},"end":{"line":114,"column":4,"offset":3114}},"content":[{"type":"verbatim","value":"our sub parameterize(Mu $root is raw, Any $args) is raw"}]},{"type":"para","id":"AcTvREo-eCKLzJNlvzhOt","margin":"","location":{"start":{"line":116,"column":1,"offset":3116},"end":{"line":116,"column":198,"offset":3313}},"text":"text","content":["Given the ",{"type":"fcode","name":"C","content":["$root"]}," metaobject of the parameterization and its ",{"type":"fcode","name":"C","content":["$args"]},", produces a type object minus the caching. ",{"type":"fcode","name":"C","content":["$args"]}," is assumed to carry ",{"type":"fcode","name":"C","content":["K"]}," at position ",{"type":"fcode","name":"C","content":["0"]}," and ",{"type":"fcode","name":"C","content":["T"]},", if present, at position ",{"type":"fcode","name":"C","content":["1"]},"."]},{"type":"block","id":"putejLJuex-wrwIZnbGqE","margin":"","level":1,"name":"head","location":{"start":{"line":118,"column":1,"offset":3315},"end":{"line":118,"column":9,"offset":3323}},"content":["AUTHOR"]},{"type":"para","id":"Ygc3HJCaNwnI2aOP5MWe0","margin":"","location":{"start":{"line":120,"column":1,"offset":3325},"end":{"line":120,"column":20,"offset":3344}},"text":"text","content":["Ben Davies (Kaiepi)"]},{"type":"block","id":"6R1jycY9wefsJ70J2eHvG","margin":"","level":1,"name":"head","location":{"start":{"line":122,"column":1,"offset":3346},"end":{"line":122,"column":24,"offset":3369}},"content":["COPYRIGHT AND LICENSE"]},{"type":"para","id":"SjksYFO0V8tR0Mz2E6DZt","margin":"","location":{"start":{"line":124,"column":1,"offset":3371},"end":{"line":124,"column":26,"offset":3396}},"text":"text","content":["Copyright 2022 Ben Davies"]},{"type":"para","id":"ZHBgtgIMW6GsndDXHVjwA","margin":"","location":{"start":{"line":126,"column":1,"offset":3398},"end":{"line":126,"column":104,"offset":3501}},"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/Kind/ra-Kind/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"2","auth":"zef:Kaiepi","authors":["Ben Davies"],"build-depends":[],"depends":[],"description":"Typechecking based on kinds","dist":"Kind:ver<1.0.0>:auth<zef:Kaiepi>","license":"Artistic-2.0","name":"Kind","path":"K/IN/KIND/4f94f84974aca161b99f2d7db7b7498f35404752.tar.gz","perl":"6","provides":{"Kind":"lib/Kind.pm6"},"resources":[],"source-url":"https://github.com/Kaiepi/ra-Kind.git","tags":["kind","type"],"test-depends":[],"version":"1.0.0"},"files":[{"file":"work_mods/zef/Kind/ra-Kind/README.md","publishUrl":"/mods/zef/Kind/ra-Kind/README.md"},{"file":"work_mods/zef/Kind/ra-Kind/kind.md","publishUrl":"/mods/zef/Kind/ra-Kind/kind.md"},{"file":"work_mods/zef/Kind/ra-Kind/README.pod6","publishUrl":"/mods/zef/Kind/ra-Kind/README.pod6"}],"src":"zef","url":"/mods/zef/Kind"}}}
=end data


    =begin React :component<RenderItem>
    =begin data
    {"type":"page","file":"work_mods/zef/Kind/ra-Kind/README.md","sources":[],"node":{"type":"block","id":"aJVaTGjdvTqdDjKT2i10s","margin":"","name":"root","content":[{"type":"para","id":"3pbtu3gkxZHUNjGng4RWg","margin":"","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":154,"offset":153}},"text":"text","content":[{"meta":"https://github.com/Kaiepi/ra-Kind/actions/workflows/test.yaml","type":"fcode","name":"L","content":[{"type":"block","id":"TV16FH7d4v6T758WEJPrh","margin":"","name":"Image","config":[],"location":{"start":{"line":1,"column":2,"offset":1},"end":{"line":1,"column":90,"offset":89}},"content":[{"type":"image","src":"https://github.com/Kaiepi/ra-Kind/actions/workflows/test.yaml/badge.svg","alt":"Build Status"}]}]}]},{"type":"block","id":"Qkd-_p8V9Y59HkYqW4uZz","margin":"","level":1,"name":"head","location":{"start":{"line":3,"column":1,"offset":155},"end":{"line":3,"column":7,"offset":161}},"content":["NAME"]},{"type":"para","id":"uE5ZscopihtpWvADxaXmm","margin":"","location":{"start":{"line":5,"column":1,"offset":163},"end":{"line":5,"column":35,"offset":197}},"text":"text","content":["Kind - Typechecking based on kinds"]},{"type":"block","id":"TQuqG-7hZqsw6-FhOj2ro","margin":"","level":1,"name":"head","location":{"start":{"line":7,"column":1,"offset":199},"end":{"line":7,"column":11,"offset":209}},"content":["SYNOPSIS"]},{"type":"block","id":"4svbLXfg26uTE233vLEXR","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":9,"column":1,"offset":211},"end":{"line":20,"column":4,"offset":470}},"content":[{"type":"verbatim","value":"use Kind;\n\nmy constant Class = Kind[Metamodel::ClassHOW];\n\nproto sub is-class(Mu --> Bool:D)  {*}\nmulti sub is-class(Class --> True) { }\nmulti sub is-class(Mu --> False)   { }\n\nsay Str.&is-class;  # OUTPUT: True\nsay Blob.&is-class; # OUTPUT: False"}]},{"type":"block","id":"cOkdstrDoeYVnY7-jHuFg","margin":"","level":1,"name":"head","location":{"start":{"line":22,"column":1,"offset":472},"end":{"line":22,"column":14,"offset":485}},"content":["DESCRIPTION"]},{"type":"para","id":"2QJtt0uw1LB6XICxQZXBm","margin":"","location":{"start":{"line":24,"column":1,"offset":487},"end":{"line":24,"column":280,"offset":766}},"text":"text","content":[{"type":"fcode","name":"C","content":["Kind"]}," is an uninstantiable parametric type that can be used to typecheck values based off their kind. A parameterization produces a type object that can process the HOW of a type in a typecheck context with ",{"type":"fcode","name":"C","content":["ACCEPTS"]}," when available, otherwise falling back to the bare typecheck."]},{"type":"para","id":"lK9r4HLjfvGX1_0dwmzT2","margin":"","location":{"start":{"line":26,"column":1,"offset":768},"end":{"line":26,"column":101,"offset":868}},"text":"text","content":[{"type":"fcode","name":"C","content":["Kind"]}," is documented. You can view the documentation for it and its methods at any time using ",{"type":"fcode","name":"C","content":["WHY"]},"."]},{"type":"block","id":"oO-CjXQ5X0pibxNmk91u1","margin":"","level":1,"name":"head","location":{"start":{"line":28,"column":1,"offset":870},"end":{"line":28,"column":14,"offset":883}},"content":["METAMETHODS"]},{"type":"block","id":"3sHlHWRr1v2ymYq2-0f5Y","margin":"","level":2,"name":"head","location":{"start":{"line":30,"column":1,"offset":885},"end":{"line":30,"column":23,"offset":907}},"content":["method parameterize"]},{"type":"block","id":"ajiUVOOyE21UqHMohwTFQ","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":32,"column":1,"offset":909},"end":{"line":34,"column":4,"offset":955}},"content":[{"type":"verbatim","value":"method ^parameterize(|args) is raw"}]},{"type":"para","id":"pxedbLyqa3GPifJUPyr4E","margin":"","location":{"start":{"line":36,"column":1,"offset":957},"end":{"line":36,"column":66,"offset":1022}},"text":"text","content":["Produces a parameterization by delegating to ",{"type":"fcode","name":"C","content":["^kind"]}," with ",{"type":"fcode","name":"C","content":["args"]},"."]},{"type":"block","id":"Phu2DnK_BAmIdn3KbiHaw","margin":"","level":2,"name":"head","location":{"start":{"line":38,"column":1,"offset":1024},"end":{"line":38,"column":15,"offset":1038}},"content":["method kind"]},{"type":"block","id":"30JQNkMrcmF9Y9feGTEvp","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":40,"column":1,"offset":1040},"end":{"line":42,"column":4,"offset":1108}},"content":[{"type":"verbatim","value":"method ^kind(Mu $obj is raw, Mu \\K, Mu:U \\T = Mu) is raw"}]},{"type":"para","id":"eObY16N_VYfCgehdhSGzw","margin":"","location":{"start":{"line":44,"column":1,"offset":1110},"end":{"line":44,"column":277,"offset":1386}},"text":"text","content":["Produces a cached subset with a refinement (",{"type":"fcode","name":"C","content":["where"]},") built from ",{"type":"fcode","name":"C","content":["K"]}," and a refinement (",{"type":"fcode","name":"C","content":["of"]},") from ",{"type":"fcode","name":"C","content":["T"]}," if present. This backs ",{"type":"fcode","name":"C","content":["^parameterize"]}," so as to allow for a different parameterizer in a subtype. This is more or less a wrapper for ",{"type":"fcode","name":"C","content":["Metamodel::Primitives.parameterize_type"]},"."]},{"type":"para","id":"OMiXYEBktttQqg5QySAnG","margin":"","location":{"start":{"line":46,"column":1,"offset":1388},"end":{"line":46,"column":53,"offset":1440}},"text":"text","content":["Some useful values with which to produce a type are:"]},{"type":"list","id":"u7YwfT9JWFb5OorGUsMrE","margin":"","level":1,"list":"itemized","content":[{"type":"block","id":"qOZYNVmvoLZFgZFDO6F4c","margin":"","name":"item","level":1,"location":{"start":{"line":48,"column":1,"offset":1442},"end":{"line":48,"column":26,"offset":1467}},"content":[{"type":"para","id":"lIOJfW30HWNSXuydz2bD8","margin":"","location":{"start":{"line":48,"column":3,"offset":1444},"end":{"line":48,"column":26,"offset":1467}},"text":"text","content":["a metaclass or metarole"]}]}]},{"type":"block","id":"OKD5z_pEYFOC5hVWPYhp-","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":50,"column":1,"offset":1469},"end":{"line":53,"column":4,"offset":1532}},"content":[{"type":"verbatim","value":"# Smartmatches any class.\nKind[Metamodel::ClassHOW]"}]},{"type":"list","id":"p-uPOxm3Ey8yFUudJTvj9","margin":"","level":1,"list":"itemized","content":[{"type":"block","id":"UIXQ1ND3SWCrV8L3Tyjc9","margin":"","name":"item","level":1,"location":{"start":{"line":55,"column":1,"offset":1534},"end":{"line":55,"column":41,"offset":1574}},"content":[{"type":"para","id":"6OMZLoZS3ZVQjXEQMMVQI","margin":"","location":{"start":{"line":55,"column":3,"offset":1536},"end":{"line":55,"column":41,"offset":1574}},"text":"text","content":["a junction of metaclasses or metaroles"]}]}]},{"type":"block","id":"9lbr6a93QGAVCW8ZvzIq4","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":57,"column":1,"offset":1576},"end":{"line":60,"column":4,"offset":1735}},"content":[{"type":"verbatim","value":"# Smartmatches any type that supports naming, versioning, and documenting.\nKind[Metamodel::Naming & Metamodel::Versioning & Metamodel::Documenting]"}]},{"type":"list","id":"cQzVb1FjleSdTbwORw7U5","margin":"","level":1,"list":"itemized","content":[{"type":"block","id":"sxFMLve9RAcBuhhoDuxY4","margin":"","name":"item","level":1,"location":{"start":{"line":62,"column":1,"offset":1737},"end":{"line":62,"column":10,"offset":1746}},"content":[{"type":"para","id":"pYhM5SjI8M6xfO9a0AZz1","margin":"","location":{"start":{"line":62,"column":3,"offset":1739},"end":{"line":62,"column":10,"offset":1746}},"text":"text","content":["a block"]}]}]},{"type":"block","id":"Qp1QSh6gxWSB6wC1_NcBm","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":64,"column":1,"offset":1748},"end":{"line":67,"column":4,"offset":1857}},"content":[{"type":"verbatim","value":"# Smartmatches any parametric type.\nKind[{ use nqp; nqp::hllbool(nqp::can($_, 'parameterize')) }]"}]},{"type":"list","id":"1eRahuKOr5LksM5N9DqLE","margin":"","level":1,"list":"itemized","content":[{"type":"block","id":"4rA0-sNwC-e5U-dAJBudV","margin":"","name":"item","level":1,"location":{"start":{"line":69,"column":1,"offset":1859},"end":{"line":69,"column":15,"offset":1873}},"content":[{"type":"para","id":"qxcTSFbc-pf4SsdeRFjXZ","margin":"","location":{"start":{"line":69,"column":3,"offset":1861},"end":{"line":69,"column":15,"offset":1873}},"text":"text","content":["a metaobject"]}]}]},{"type":"block","id":"CormAhcH6GF2_VuLQJzem","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":71,"column":1,"offset":1875},"end":{"line":86,"column":4,"offset":2301}},"content":[{"type":"verbatim","value":"# This class' metamethods constrain their metaobject to itself or its subtypes.\nclass Configurable {\n    my constant K := Kind[$?CLASS.HOW.WHAT, $?CLASS];\n\n    my constant %configuration := hash;\n\n    method ^configure(K $obj, %config --> Map:D) {\n        %configuration{$obj.WHAT.WHICH} := %config.Map\n    }\n\n    method ^configuration(K $obj --> Map:D) {\n        %configuration{$obj.WHAT.WHICH} // Map.new\n    }\n}"}]},{"type":"para","id":"JDZ0lq98eEUyNrGTN43wE","margin":"","location":{"start":{"line":88,"column":1,"offset":2303},"end":{"line":88,"column":79,"offset":2381}},"text":"text","content":["For more examples of parameterizations of ",{"type":"fcode","name":"C","content":["Kind"]},", refer to ",{"type":"fcode","name":"C","content":["t/01-typecheck.t"]},"."]},{"type":"block","id":"ppqpOhjlWWTDakpyHJOl8","margin":"","level":1,"name":"head","location":{"start":{"line":90,"column":1,"offset":2383},"end":{"line":90,"column":10,"offset":2392}},"content":["SYMBOLS"]},{"type":"block","id":"JKAnvq8ydMbNNpcd0DCMM","margin":"","level":2,"name":"head","location":{"start":{"line":92,"column":1,"offset":2394},"end":{"line":92,"column":22,"offset":2415}},"content":["&set_parameterizer"]},{"type":"block","id":"q_JRvJSfkBCdqaapz3RDZ","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":94,"column":1,"offset":2417},"end":{"line":96,"column":4,"offset":2510}},"content":[{"type":"verbatim","value":"our sub set_parameterizer(Mu $obj is raw, &parameterizer = &parameterize --> Nil)"}]},{"type":"para","id":"a9TySK6Hm8maktyhjaCJh","margin":"","location":{"start":{"line":98,"column":1,"offset":2512},"end":{"line":98,"column":212,"offset":2723}},"text":"text","content":["Applies the parameterizer of ",{"type":"fcode","name":"C","content":["Kind"]}," to a metaobject, providing it with a parameterization cache. A subtype needs to apply this at ",{"type":"fcode","name":"C","content":["BEGIN"]},"-time in order to parameterize with the default metamethods, for instance:"]},{"type":"block","id":"4AT7Fv0Ue_-j4Y5hsSdoO","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":100,"column":1,"offset":2725},"end":{"line":104,"column":4,"offset":2817}},"content":[{"type":"verbatim","value":"class Kind::Instantiable is Kind {\n    BEGIN Kind::set_parameterizer($?CLASS);\n}"}]},{"type":"para","id":"k7BDZSwxtxDDvv3bd0rFp","margin":"","location":{"start":{"line":106,"column":1,"offset":2819},"end":{"line":106,"column":139,"offset":2957}},"text":"text","content":["A ",{"type":"fcode","name":"C","content":["&parameterizer"]}," may be provided, in which case that will be set instead. This should carry a compatible signature with ",{"type":"fcode","name":"C","content":["&parameterize"]},"."]},{"type":"para","id":"4Rmv1HC1jtXfVJBMp6Gvu","margin":"","location":{"start":{"line":108,"column":1,"offset":2959},"end":{"line":108,"column":69,"offset":3027}},"text":"text","content":["For more examples of how to subclass ",{"type":"fcode","name":"C","content":["Kind"]},", refer to ",{"type":"fcode","name":"C","content":["t/02-meta.t"]},"."]},{"type":"block","id":"BQZnXEMz3VJFnsYibD-Ja","margin":"","level":2,"name":"head","location":{"start":{"line":110,"column":1,"offset":3029},"end":{"line":110,"column":17,"offset":3045}},"content":["&parameterize"]},{"type":"block","id":"AU3VKGtVZxZ68ABMX_Zdv","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":112,"column":1,"offset":3047},"end":{"line":114,"column":4,"offset":3114}},"content":[{"type":"verbatim","value":"our sub parameterize(Mu $root is raw, Any $args) is raw"}]},{"type":"para","id":"AcTvREo-eCKLzJNlvzhOt","margin":"","location":{"start":{"line":116,"column":1,"offset":3116},"end":{"line":116,"column":198,"offset":3313}},"text":"text","content":["Given the ",{"type":"fcode","name":"C","content":["$root"]}," metaobject of the parameterization and its ",{"type":"fcode","name":"C","content":["$args"]},", produces a type object minus the caching. ",{"type":"fcode","name":"C","content":["$args"]}," is assumed to carry ",{"type":"fcode","name":"C","content":["K"]}," at position ",{"type":"fcode","name":"C","content":["0"]}," and ",{"type":"fcode","name":"C","content":["T"]},", if present, at position ",{"type":"fcode","name":"C","content":["1"]},"."]},{"type":"block","id":"putejLJuex-wrwIZnbGqE","margin":"","level":1,"name":"head","location":{"start":{"line":118,"column":1,"offset":3315},"end":{"line":118,"column":9,"offset":3323}},"content":["AUTHOR"]},{"type":"para","id":"Ygc3HJCaNwnI2aOP5MWe0","margin":"","location":{"start":{"line":120,"column":1,"offset":3325},"end":{"line":120,"column":20,"offset":3344}},"text":"text","content":["Ben Davies (Kaiepi)"]},{"type":"block","id":"6R1jycY9wefsJ70J2eHvG","margin":"","level":1,"name":"head","location":{"start":{"line":122,"column":1,"offset":3346},"end":{"line":122,"column":24,"offset":3369}},"content":["COPYRIGHT AND LICENSE"]},{"type":"para","id":"SjksYFO0V8tR0Mz2E6DZt","margin":"","location":{"start":{"line":124,"column":1,"offset":3371},"end":{"line":124,"column":26,"offset":3396}},"text":"text","content":["Copyright 2022 Ben Davies"]},{"type":"para","id":"ZHBgtgIMW6GsndDXHVjwA","margin":"","location":{"start":{"line":126,"column":1,"offset":3398},"end":{"line":126,"column":104,"offset":3501}},"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/Kind/ra-Kind/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"2","auth":"zef:Kaiepi","authors":["Ben Davies"],"build-depends":[],"depends":[],"description":"Typechecking based on kinds","dist":"Kind:ver<1.0.0>:auth<zef:Kaiepi>","license":"Artistic-2.0","name":"Kind","path":"K/IN/KIND/4f94f84974aca161b99f2d7db7b7498f35404752.tar.gz","perl":"6","provides":{"Kind":"lib/Kind.pm6"},"resources":[],"source-url":"https://github.com/Kaiepi/ra-Kind.git","tags":["kind","type"],"test-depends":[],"version":"1.0.0"},"files":[{"file":"work_mods/zef/Kind/ra-Kind/README.md","publishUrl":"/mods/zef/Kind/ra-Kind/README.md"},{"file":"work_mods/zef/Kind/ra-Kind/kind.md","publishUrl":"/mods/zef/Kind/ra-Kind/kind.md"},{"file":"work_mods/zef/Kind/ra-Kind/README.pod6","publishUrl":"/mods/zef/Kind/ra-Kind/README.pod6"}],"src":"zef","url":"/mods/zef/Kind"}}}
    =end data
    =end React


Typechecking based on kinds


Kind


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


Kivuli

Kivuli

Synopsis

Description

Installation

Support

Licence and Copyright

Kivuli v0.0.4

Authors

License

Dependencies

Test Dependencies

Provides

Documentation