TITLE

Merge multiple ordered Seqs into a single ordered one.


SUBTITLE

data

=begin data
{"type":"page","file":"work_mods/zef/MergeOrderedSeqs/MergeOrderedSeqs-0.0.1/README.md","sources":[],"node":{"type":"block","id":"BDMRFJuTEvzqqmnSjiQQG","margin":"","name":"root","content":[{"type":"para","id":"KotjbKadTOae1etYs_aIO","margin":"","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":147,"offset":146}},"text":"text","content":[{"meta":"https://github.com/FCO/MergeOrderedSeqs/actions","type":"fcode","name":"L","content":[{"type":"block","id":"6BHX3jEqVLz_TrT2pSdIP","margin":"","name":"Image","config":[],"location":{"start":{"line":1,"column":2,"offset":1},"end":{"line":1,"column":97,"offset":96}},"content":[{"type":"image","src":"https://github.com/FCO/MergeOrderedSeqs/actions/workflows/test.yml/badge.svg","alt":"Actions Status"}]}]}]},{"type":"block","id":"AiPskHZEbVbOE04g37kFh","margin":"","level":1,"name":"head","location":{"start":{"line":3,"column":1,"offset":148},"end":{"line":3,"column":7,"offset":154}},"content":["NAME"]},{"type":"para","id":"fGmCPbw5p1bwdAYqPY591","margin":"","location":{"start":{"line":5,"column":1,"offset":156},"end":{"line":5,"column":74,"offset":229}},"text":"text","content":["MergeOrderedSeqs - Merge multiple ordered Seqs into a single ordered one."]},{"type":"block","id":"M-oOzcfS21GyFMa0HnhMd","margin":"","level":1,"name":"head","location":{"start":{"line":7,"column":1,"offset":231},"end":{"line":7,"column":11,"offset":241}},"content":["SYNOPSIS"]},{"type":"block","id":"mw6KYhf82t3NoVv3HBxvk","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":9,"column":1,"offset":243},"end":{"line":16,"column":4,"offset":581}},"content":[{"type":"verbatim","value":"use MergeOrderedSeqs;\n\nmy @ordered = merge-ordered-seqs                      [1, 3, 5], [2, 4, 6];\nmy @ord2    = merge-ordered-seqs :before(More),       [6, 4, 2], [5, 3, 1];\nmy @ord3    = merge-ordered-seqs :before{(-2) ** $_}, [5, 3, 1], [2, 4, 6];\nmy @ord4    = merge-ordered-seqs :before{$^a < $^b},  [1, 3, 5], [2, 4, 6];"}]},{"type":"block","id":"uKWTuhyxuG_nZMXdqd8Fg","margin":"","level":1,"name":"head","location":{"start":{"line":18,"column":1,"offset":583},"end":{"line":18,"column":14,"offset":596}},"content":["DESCRIPTION"]},{"type":"para","id":"CSBk57TlZ0UclGj-JZzfU","margin":"","location":{"start":{"line":20,"column":1,"offset":598},"end":{"line":20,"column":130,"offset":727}},"text":"text","content":["merge_ordered_seqs() is a function that receives multiple iterables that should be ordered and returns a single Seq also ordered."]},{"type":"block","id":"7vSDM-PnGomRoX3xGkRQP","margin":"","level":1,"name":"head","location":{"start":{"line":22,"column":1,"offset":729},"end":{"line":22,"column":9,"offset":737}},"content":["AUTHOR"]},{"type":"para","id":"ai1NqnwscCCmL7ijvxc2G","margin":"","location":{"start":{"line":24,"column":1,"offset":739},"end":{"line":24,"column":43,"offset":781}},"text":"text","content":["Fernando Corrêa ",{"meta":"mailto:fernandocorrea@gmail.com","type":"fcode","name":"L","content":["fernandocorrea@gmail.com"]}]},{"type":"block","id":"z4HakWuZ3FyMMAUjDdcgH","margin":"","level":1,"name":"head","location":{"start":{"line":26,"column":1,"offset":783},"end":{"line":26,"column":24,"offset":806}},"content":["COPYRIGHT AND LICENSE"]},{"type":"para","id":"ezJOd_HUO1IB9GkMzNOqX","margin":"","location":{"start":{"line":28,"column":1,"offset":808},"end":{"line":28,"column":43,"offset":850}},"text":"text","content":["Copyright 2023 Fernando Corrêa de Oliveira"]},{"type":"para","id":"BrCMrJ9GcYuVRRJkfHopa","margin":"","location":{"start":{"line":30,"column":1,"offset":852},"end":{"line":30,"column":104,"offset":955}},"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/MergeOrderedSeqs/MergeOrderedSeqs-0.0.1/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"","auth":"zef:FCO","authors":["Fernando Corrêa"],"build-depends":[],"depends":[],"description":"Merge multiple ordered Seqs into a single ordered one.","dist":"MergeOrderedSeqs:ver<0.0.1>:auth<zef:FCO>","license":"Artistic-2.0","name":"MergeOrderedSeqs","path":"M/ER/MERGEORDEREDSEQS/18d18c746ef638da40bac9058391dd3fda3b221d.tar.gz","perl":"6.d","provides":{"MergeOrderedSeqs":"lib/MergeOrderedSeqs.rakumod"},"resources":[],"source-url":"https://github.com/FCO/MergeOrderedSeqs.git","tags":[],"test-depends":[],"version":"0.0.1"},"files":[{"file":"work_mods/zef/MergeOrderedSeqs/MergeOrderedSeqs-0.0.1/README.md","publishUrl":"/mods/zef/MergeOrderedSeqs/MergeOrderedSeqs-0.0.1/README.md"},{"file":"work_mods/zef/MergeOrderedSeqs/MergeOrderedSeqs-0.0.1/lib/MergeOrderedSeqs.rakumod","publishUrl":"/mods/zef/MergeOrderedSeqs/MergeOrderedSeqs-0.0.1/lib/MergeOrderedSeqs.rakumod"}],"src":"zef","url":"/mods/zef/MergeOrderedSeqs"}}}
=end data


React

    =begin React :component<RenderItem>
    =begin data
    {"type":"page","file":"work_mods/zef/MergeOrderedSeqs/MergeOrderedSeqs-0.0.1/README.md","sources":[],"node":{"type":"block","id":"BDMRFJuTEvzqqmnSjiQQG","margin":"","name":"root","content":[{"type":"para","id":"KotjbKadTOae1etYs_aIO","margin":"","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":147,"offset":146}},"text":"text","content":[{"meta":"https://github.com/FCO/MergeOrderedSeqs/actions","type":"fcode","name":"L","content":[{"type":"block","id":"6BHX3jEqVLz_TrT2pSdIP","margin":"","name":"Image","config":[],"location":{"start":{"line":1,"column":2,"offset":1},"end":{"line":1,"column":97,"offset":96}},"content":[{"type":"image","src":"https://github.com/FCO/MergeOrderedSeqs/actions/workflows/test.yml/badge.svg","alt":"Actions Status"}]}]}]},{"type":"block","id":"AiPskHZEbVbOE04g37kFh","margin":"","level":1,"name":"head","location":{"start":{"line":3,"column":1,"offset":148},"end":{"line":3,"column":7,"offset":154}},"content":["NAME"]},{"type":"para","id":"fGmCPbw5p1bwdAYqPY591","margin":"","location":{"start":{"line":5,"column":1,"offset":156},"end":{"line":5,"column":74,"offset":229}},"text":"text","content":["MergeOrderedSeqs - Merge multiple ordered Seqs into a single ordered one."]},{"type":"block","id":"M-oOzcfS21GyFMa0HnhMd","margin":"","level":1,"name":"head","location":{"start":{"line":7,"column":1,"offset":231},"end":{"line":7,"column":11,"offset":241}},"content":["SYNOPSIS"]},{"type":"block","id":"mw6KYhf82t3NoVv3HBxvk","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":9,"column":1,"offset":243},"end":{"line":16,"column":4,"offset":581}},"content":[{"type":"verbatim","value":"use MergeOrderedSeqs;\n\nmy @ordered = merge-ordered-seqs                      [1, 3, 5], [2, 4, 6];\nmy @ord2    = merge-ordered-seqs :before(More),       [6, 4, 2], [5, 3, 1];\nmy @ord3    = merge-ordered-seqs :before{(-2) ** $_}, [5, 3, 1], [2, 4, 6];\nmy @ord4    = merge-ordered-seqs :before{$^a < $^b},  [1, 3, 5], [2, 4, 6];"}]},{"type":"block","id":"uKWTuhyxuG_nZMXdqd8Fg","margin":"","level":1,"name":"head","location":{"start":{"line":18,"column":1,"offset":583},"end":{"line":18,"column":14,"offset":596}},"content":["DESCRIPTION"]},{"type":"para","id":"CSBk57TlZ0UclGj-JZzfU","margin":"","location":{"start":{"line":20,"column":1,"offset":598},"end":{"line":20,"column":130,"offset":727}},"text":"text","content":["merge_ordered_seqs() is a function that receives multiple iterables that should be ordered and returns a single Seq also ordered."]},{"type":"block","id":"7vSDM-PnGomRoX3xGkRQP","margin":"","level":1,"name":"head","location":{"start":{"line":22,"column":1,"offset":729},"end":{"line":22,"column":9,"offset":737}},"content":["AUTHOR"]},{"type":"para","id":"ai1NqnwscCCmL7ijvxc2G","margin":"","location":{"start":{"line":24,"column":1,"offset":739},"end":{"line":24,"column":43,"offset":781}},"text":"text","content":["Fernando Corrêa ",{"meta":"mailto:fernandocorrea@gmail.com","type":"fcode","name":"L","content":["fernandocorrea@gmail.com"]}]},{"type":"block","id":"z4HakWuZ3FyMMAUjDdcgH","margin":"","level":1,"name":"head","location":{"start":{"line":26,"column":1,"offset":783},"end":{"line":26,"column":24,"offset":806}},"content":["COPYRIGHT AND LICENSE"]},{"type":"para","id":"ezJOd_HUO1IB9GkMzNOqX","margin":"","location":{"start":{"line":28,"column":1,"offset":808},"end":{"line":28,"column":43,"offset":850}},"text":"text","content":["Copyright 2023 Fernando Corrêa de Oliveira"]},{"type":"para","id":"BrCMrJ9GcYuVRRJkfHopa","margin":"","location":{"start":{"line":30,"column":1,"offset":852},"end":{"line":30,"column":104,"offset":955}},"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/MergeOrderedSeqs/MergeOrderedSeqs-0.0.1/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"","auth":"zef:FCO","authors":["Fernando Corrêa"],"build-depends":[],"depends":[],"description":"Merge multiple ordered Seqs into a single ordered one.","dist":"MergeOrderedSeqs:ver<0.0.1>:auth<zef:FCO>","license":"Artistic-2.0","name":"MergeOrderedSeqs","path":"M/ER/MERGEORDEREDSEQS/18d18c746ef638da40bac9058391dd3fda3b221d.tar.gz","perl":"6.d","provides":{"MergeOrderedSeqs":"lib/MergeOrderedSeqs.rakumod"},"resources":[],"source-url":"https://github.com/FCO/MergeOrderedSeqs.git","tags":[],"test-depends":[],"version":"0.0.1"},"files":[{"file":"work_mods/zef/MergeOrderedSeqs/MergeOrderedSeqs-0.0.1/README.md","publishUrl":"/mods/zef/MergeOrderedSeqs/MergeOrderedSeqs-0.0.1/README.md"},{"file":"work_mods/zef/MergeOrderedSeqs/MergeOrderedSeqs-0.0.1/lib/MergeOrderedSeqs.rakumod","publishUrl":"/mods/zef/MergeOrderedSeqs/MergeOrderedSeqs-0.0.1/lib/MergeOrderedSeqs.rakumod"}],"src":"zef","url":"/mods/zef/MergeOrderedSeqs"}}}
    =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

MergeOrderedSeqs


Serialize/Deserialize Raku classes to/from MessagePack blobs


=begin data
{"type":"page","file":"work_mods/zef/MessagePack::Class/MessagePack-Class-0.0.4/README.md","sources":[],"node":{"type":"block","id":"gT_b1whUKLYDa2bziNZgg","margin":"","name":"root","content":[{"type":"block","id":"286Av5HGHKmOJl17jKuxg","margin":"","level":1,"name":"head","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":21,"offset":20}},"content":["MessagePack::Class"]},{"type":"para","id":"5T0vrE6QCjJJh-HhAqo5H","margin":"","location":{"start":{"line":3,"column":1,"offset":22},"end":{"line":3,"column":61,"offset":82}},"text":"text","content":["Serialize/Deserialize Raku classes to/from MessagePack blobs"]},{"type":"para","id":"E-ZojCZzRYc8XswsbjbiF","margin":"","location":{"start":{"line":5,"column":1,"offset":84},"end":{"line":5,"column":79,"offset":162}},"text":"text","content":[{"type":"block","id":"DSva8lyzuJspXtrYsszC2","margin":"","name":"Image","config":[],"location":{"start":{"line":5,"column":1,"offset":84},"end":{"line":5,"column":79,"offset":162}},"content":[{"type":"image","src":"https://github.com/jonathanstowe/Tinky/workflows/CI/badge.svg","alt":"Build Status"}]}]},{"type":"block","id":"oyBxzv-mOaJbZmpP1DaT2","margin":"","level":2,"name":"head","location":{"start":{"line":7,"column":1,"offset":164},"end":{"line":7,"column":12,"offset":175}},"content":["Synopsis"]},{"type":"block","id":"t0pcXRVjmJqa-vqAxHoIS","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":9,"column":1,"offset":177},"end":{"line":24,"column":4,"offset":471}},"content":[{"type":"verbatim","value":"\nuse MessagePack::Class;\n\nclass MyClass does MessagePack::Class {\n\thas Str $.some-data;\n}\n\nmy Blob $pack = MyClass.new(some-data => \"whatever\").to-messagepack;\n\n# Then send $pack over the network, write it to a file or something\n\nmy MyClass $obj = MyClass.from-messagepack($pack);\n\n"}]},{"type":"block","id":"XX8zyrj_44dhe3KD62hw4","margin":"","level":2,"name":"head","location":{"start":{"line":26,"column":1,"offset":473},"end":{"line":26,"column":15,"offset":487}},"content":["Description"]},{"type":"para","id":"H9kx4y4Qa-mMo8fo1dTTm","margin":"","location":{"start":{"line":28,"column":1,"offset":489},"end":{"line":29,"column":75,"offset":636}},"text":"text","content":[{"meta":"http://msgpack.org/","type":"fcode","name":"L","content":["MessagePack"]}," is a binary serialization format that\nis particularly efficient for transmission over a network or file storage."]},{"type":"para","id":"bvRHuQ3V46inVAT6ute7b","margin":"","location":{"start":{"line":31,"column":1,"offset":638},"end":{"line":34,"column":8,"offset":860}},"text":"text","content":["This module provides a role that allows for the direct serialization of\na Raku object to a MessagePack binary blob and the deserialization of\nthat blob back to a Raku object of the same type with the same attribute\nvalues."]},{"type":"para","id":"CLntrO9fi9wvrB7h74sJv","margin":"","location":{"start":{"line":36,"column":1,"offset":862},"end":{"line":40,"column":79,"offset":1288}},"text":"text","content":["Under the hood it uses ",{"meta":"https://github.com/pierre-vigier/Perl6-Data-MessagePack","type":"fcode","name":"L","content":["Data::MessagePack"]},"\nto serialize and deserialize data structures representing the object in a very\nsimilar manner to ",{"meta":"https://github.com/jonathanstowe/JSON-Marshal","type":"fcode","name":"L","content":["JSON::Marshal"]}," and\n",{"meta":"https://github.com/tadzik/JSON-Unmarshal","type":"fcode","name":"L","content":["JSON::Unmarshal"]}," (infact it borrows some\nof the internal code of both of those to construct a suitable data structure.)"]},{"type":"para","id":"K-VrxMAmAhRyXoxabj5U6","margin":"","location":{"start":{"line":42,"column":1,"offset":1290},"end":{"line":46,"column":68,"offset":1682}},"text":"text","content":["For a simple case this may work with your class unchanged apart from the addition of\nthe role composition, however for types that may not be properly constructed from\ntheir public attributes there are provided the attribute traits ",{"type":"fcode","name":"C","content":["packed-by"]}," and\n",{"type":"fcode","name":"C","content":["unpacked-by"]}," which allow you to provide either a subroutine or a method name\nthat will work with a representation that will round-trip properly."]},{"type":"para","id":"13JCkZBuA7IxkJktK5fMz","margin":"","location":{"start":{"line":48,"column":1,"offset":1684},"end":{"line":51,"column":86,"offset":2024}},"text":"text","content":["A named method supplied to ",{"type":"fcode","name":"C","content":["packed-by"]}," will be called on the object to be serialized\nwithout any arguments and should return a value suitable for serialization, and a method\nsupplied to ",{"type":"fcode","name":"C","content":["unpacked-by"]}," will be called on the type object with the value to be\ndeserialized as a single positional argument and should return an object of the type."]},{"type":"para","id":"xs2XJmkpqIND4OMar0TbL","margin":"","location":{"start":{"line":53,"column":1,"offset":2026},"end":{"line":53,"column":83,"offset":2108}},"text":"text","content":["So for instance if one had a class with an attribute of type Version one might do:"]},{"type":"block","id":"HjFU48Tx6piFqYkl1Ihkd","margin":"","name":"code","config":[],"location":{"start":{"line":55,"column":1,"offset":2110},"end":{"line":59,"column":4,"offset":2230}},"content":[{"type":"verbatim","value":"class TraitTest does MessagePack::Class {\n    has Version $.version is packed-by('Str') is unpacked-by('new');\n}"}]},{"type":"para","id":"xMl5iDE1PebPdLSyzhGAs","margin":"","location":{"start":{"line":61,"column":1,"offset":2232},"end":{"line":62,"column":32,"offset":2342}},"text":"text","content":["Where the ",{"type":"fcode","name":"C","content":["Str"]}," method returns a string that is suitable to be passed to ",{"type":"fcode","name":"C","content":["new"]},"\nto create a new Version object."]},{"type":"para","id":"-1Q0fNTgBeZbQivGuDnqs","margin":"","location":{"start":{"line":64,"column":1,"offset":2344},"end":{"line":67,"column":8,"offset":2604}},"text":"text","content":["If a subroutine (or other Callable object) is passed to the traits then it should take\na single argument and return a value suitable for serialization (for ",{"type":"fcode","name":"C","content":["packed-by"]},") or\nan object of the appropriate type (for ",{"type":"fcode","name":"C","content":["unpacked-by"]},") so the above example might\nbecome:"]},{"type":"block","id":"V3NKJQwNTonmmsvVrVWId","margin":"","name":"code","config":[],"location":{"start":{"line":69,"column":1,"offset":2606},"end":{"line":73,"column":4,"offset":2768}},"content":[{"type":"verbatim","value":"class TraitTest does MessagePack::Class {\n    has Version $.version is packed-by(-> Version $v { $v.Str }) is unpacked-by(-> Str $v { Version.new($v)});\n}"}]},{"type":"para","id":"3CxbdtgPcAJ6-cdyE6tdP","margin":"","location":{"start":{"line":75,"column":1,"offset":2770},"end":{"line":75,"column":81,"offset":2850}},"text":"text","content":["You can of course make the subroutines as complex as is required for your types."]},{"type":"para","id":"v1BYIT6c6B_8FZnieDC-T","margin":"","location":{"start":{"line":77,"column":1,"offset":2852},"end":{"line":79,"column":18,"offset":3035}},"text":"text","content":["If you need your data to be interoperable with software written in another language\nyou may need to adjust the serialization accordingly to match the types available\nin that language."]},{"type":"block","id":"Lnv_A5x2HSmLZC2ISKVeN","margin":"","level":2,"name":"head","location":{"start":{"line":81,"column":1,"offset":3037},"end":{"line":81,"column":16,"offset":3052}},"content":["Installation"]},{"type":"para","id":"2kVowAqUTsgnbWnSUfIMS","margin":"","location":{"start":{"line":83,"column":1,"offset":3054},"end":{"line":83,"column":100,"offset":3153}},"text":"text","content":["Assuming you have a working Rakudo installation the you should be able to install this with ",{"type":"fcode","name":"C","content":["zef"]}," :"]},{"type":"block","id":"a62fVMi8jRIlspbjyiuhE","margin":"","name":"code","config":[],"location":{"start":{"line":85,"column":1,"offset":3155},"end":{"line":89,"column":18,"offset":3242}},"content":[{"type":"verbatim","value":"zef install MessagePack::Class\n\n# or from a local check-out:\n\nzef install ."}]},{"type":"para","id":"YVjNv59nuvJLB-MuGemAB","margin":"","location":{"start":{"line":91,"column":1,"offset":3244},"end":{"line":91,"column":110,"offset":3353}},"text":"text","content":["Though I can't see any reason this shouldn't work with any other installer that may come along in the future."]},{"type":"para","id":"DWavDUaEDr2ssBAOPmLsw","margin":"","location":{"start":{"line":93,"column":1,"offset":3355},"end":{"line":93,"column":76,"offset":3430}},"text":"text","content":["If it reports that is having trouble installing the dependency, you can do:"]},{"type":"block","id":"tguizJU0VzFDVaAo8yQ8a","margin":"","name":"code","config":[],"location":{"start":{"line":95,"column":1,"offset":3432},"end":{"line":95,"column":87,"offset":3518}},"content":[{"type":"verbatim","value":"zef install -v --debug https://github.com/pierre-vigier/Perl6-Data-MessagePack.git"}]},{"type":"block","id":"dMvgxDcmCAQP0jxIrqZLV","margin":"","level":2,"name":"head","location":{"start":{"line":97,"column":1,"offset":3520},"end":{"line":97,"column":11,"offset":3530}},"content":["Support"]},{"type":"para","id":"ahcXqhA3e9x13BjI1KAD8","margin":"","location":{"start":{"line":99,"column":1,"offset":3532},"end":{"line":101,"column":53,"offset":3737}},"text":"text","content":["If you find a problem with this module or have a suggestion please report at\n",{"meta":"https://github.com/jonathanstowe/MessagePack-Class/issues","type":"fcode","name":"L","content":["https://github.com/jonathanstowe/MessagePack-Class/issues"]}," - though I always\nprefer a pull request with tests if you can do that."]},{"type":"block","id":"Ugb0IxXGejVSbkqzFidSE","margin":"","level":2,"name":"head","location":{"start":{"line":103,"column":1,"offset":3739},"end":{"line":103,"column":25,"offset":3763}},"content":["Licence and Copyright"]},{"type":"para","id":"GAQGQT8I18bPhVNN3SM9y","margin":"","location":{"start":{"line":105,"column":1,"offset":3765},"end":{"line":105,"column":82,"offset":3846}},"text":"text","content":["This is free software. Please see the ",{"meta":"LICENCE","type":"fcode","name":"L","content":["LICENCE"]}," file in this repository."]},{"type":"para","id":"KvHzcPAVNn88ZM_FQBrMH","margin":"","location":{"start":{"line":107,"column":1,"offset":3848},"end":{"line":107,"column":29,"offset":3876}},"text":"text","content":["© Jonathan Stowe 2017 - 2021"]}]},"publishUrl":"/mods/zef/MessagePack::Class/MessagePack-Class-0.0.4/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"1.9","auth":"zef:jonathanstowe","authors":["Jonathan Stowe <jns+gh@gellyfish.co.uk>"],"build-depends":[],"depends":["Data::MessagePack"],"description":"Serialize/Deserialize Raku classes to/from MessagePack blobs","dist":"MessagePack::Class:ver<0.0.4>:auth<zef:jonathanstowe>","license":"Artistic-2.0","meta-version":"1","name":"MessagePack::Class","path":"M/ES/MESSAGEPACK_CLASS/6f41d0c6c1b0cf6f4b1ca5e824a34ebe673c0987.tar.gz","provides":{"MessagePack::Class":"lib/MessagePack/Class.pm"},"raku":"6.*","resources":[],"source-url":"https://github.com/jonathanstowe/MessagePack-Class.git","support":{"bugtracker":"https://github.com/jonathanstowe/MessagePack-Class/issues","email":"jns+gh@gellyfish.co.uk","source":"https://github.com/jonathanstowe/MessagePack-Class.git"},"tags":["messagepack","message","serialization","data"],"test-depends":[],"version":"0.0.4"},"files":[{"file":"work_mods/zef/MessagePack::Class/MessagePack-Class-0.0.4/README.md","publishUrl":"/mods/zef/MessagePack::Class/MessagePack-Class-0.0.4/README.md"},{"file":"work_mods/zef/MessagePack::Class/MessagePack-Class-0.0.4/lib/MessagePack/Class.pm","publishUrl":"/mods/zef/MessagePack::Class/MessagePack-Class-0.0.4/lib/MessagePack/Class.pm"}],"src":"zef","url":"/mods/zef/MessagePack::Class"}}}
=end data


    =begin React :component<RenderItem>
    =begin data
    {"type":"page","file":"work_mods/zef/MessagePack::Class/MessagePack-Class-0.0.4/README.md","sources":[],"node":{"type":"block","id":"gT_b1whUKLYDa2bziNZgg","margin":"","name":"root","content":[{"type":"block","id":"286Av5HGHKmOJl17jKuxg","margin":"","level":1,"name":"head","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":21,"offset":20}},"content":["MessagePack::Class"]},{"type":"para","id":"5T0vrE6QCjJJh-HhAqo5H","margin":"","location":{"start":{"line":3,"column":1,"offset":22},"end":{"line":3,"column":61,"offset":82}},"text":"text","content":["Serialize/Deserialize Raku classes to/from MessagePack blobs"]},{"type":"para","id":"E-ZojCZzRYc8XswsbjbiF","margin":"","location":{"start":{"line":5,"column":1,"offset":84},"end":{"line":5,"column":79,"offset":162}},"text":"text","content":[{"type":"block","id":"DSva8lyzuJspXtrYsszC2","margin":"","name":"Image","config":[],"location":{"start":{"line":5,"column":1,"offset":84},"end":{"line":5,"column":79,"offset":162}},"content":[{"type":"image","src":"https://github.com/jonathanstowe/Tinky/workflows/CI/badge.svg","alt":"Build Status"}]}]},{"type":"block","id":"oyBxzv-mOaJbZmpP1DaT2","margin":"","level":2,"name":"head","location":{"start":{"line":7,"column":1,"offset":164},"end":{"line":7,"column":12,"offset":175}},"content":["Synopsis"]},{"type":"block","id":"t0pcXRVjmJqa-vqAxHoIS","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":9,"column":1,"offset":177},"end":{"line":24,"column":4,"offset":471}},"content":[{"type":"verbatim","value":"\nuse MessagePack::Class;\n\nclass MyClass does MessagePack::Class {\n\thas Str $.some-data;\n}\n\nmy Blob $pack = MyClass.new(some-data => \"whatever\").to-messagepack;\n\n# Then send $pack over the network, write it to a file or something\n\nmy MyClass $obj = MyClass.from-messagepack($pack);\n\n"}]},{"type":"block","id":"XX8zyrj_44dhe3KD62hw4","margin":"","level":2,"name":"head","location":{"start":{"line":26,"column":1,"offset":473},"end":{"line":26,"column":15,"offset":487}},"content":["Description"]},{"type":"para","id":"H9kx4y4Qa-mMo8fo1dTTm","margin":"","location":{"start":{"line":28,"column":1,"offset":489},"end":{"line":29,"column":75,"offset":636}},"text":"text","content":[{"meta":"http://msgpack.org/","type":"fcode","name":"L","content":["MessagePack"]}," is a binary serialization format that\nis particularly efficient for transmission over a network or file storage."]},{"type":"para","id":"bvRHuQ3V46inVAT6ute7b","margin":"","location":{"start":{"line":31,"column":1,"offset":638},"end":{"line":34,"column":8,"offset":860}},"text":"text","content":["This module provides a role that allows for the direct serialization of\na Raku object to a MessagePack binary blob and the deserialization of\nthat blob back to a Raku object of the same type with the same attribute\nvalues."]},{"type":"para","id":"CLntrO9fi9wvrB7h74sJv","margin":"","location":{"start":{"line":36,"column":1,"offset":862},"end":{"line":40,"column":79,"offset":1288}},"text":"text","content":["Under the hood it uses ",{"meta":"https://github.com/pierre-vigier/Perl6-Data-MessagePack","type":"fcode","name":"L","content":["Data::MessagePack"]},"\nto serialize and deserialize data structures representing the object in a very\nsimilar manner to ",{"meta":"https://github.com/jonathanstowe/JSON-Marshal","type":"fcode","name":"L","content":["JSON::Marshal"]}," and\n",{"meta":"https://github.com/tadzik/JSON-Unmarshal","type":"fcode","name":"L","content":["JSON::Unmarshal"]}," (infact it borrows some\nof the internal code of both of those to construct a suitable data structure.)"]},{"type":"para","id":"K-VrxMAmAhRyXoxabj5U6","margin":"","location":{"start":{"line":42,"column":1,"offset":1290},"end":{"line":46,"column":68,"offset":1682}},"text":"text","content":["For a simple case this may work with your class unchanged apart from the addition of\nthe role composition, however for types that may not be properly constructed from\ntheir public attributes there are provided the attribute traits ",{"type":"fcode","name":"C","content":["packed-by"]}," and\n",{"type":"fcode","name":"C","content":["unpacked-by"]}," which allow you to provide either a subroutine or a method name\nthat will work with a representation that will round-trip properly."]},{"type":"para","id":"13JCkZBuA7IxkJktK5fMz","margin":"","location":{"start":{"line":48,"column":1,"offset":1684},"end":{"line":51,"column":86,"offset":2024}},"text":"text","content":["A named method supplied to ",{"type":"fcode","name":"C","content":["packed-by"]}," will be called on the object to be serialized\nwithout any arguments and should return a value suitable for serialization, and a method\nsupplied to ",{"type":"fcode","name":"C","content":["unpacked-by"]}," will be called on the type object with the value to be\ndeserialized as a single positional argument and should return an object of the type."]},{"type":"para","id":"xs2XJmkpqIND4OMar0TbL","margin":"","location":{"start":{"line":53,"column":1,"offset":2026},"end":{"line":53,"column":83,"offset":2108}},"text":"text","content":["So for instance if one had a class with an attribute of type Version one might do:"]},{"type":"block","id":"HjFU48Tx6piFqYkl1Ihkd","margin":"","name":"code","config":[],"location":{"start":{"line":55,"column":1,"offset":2110},"end":{"line":59,"column":4,"offset":2230}},"content":[{"type":"verbatim","value":"class TraitTest does MessagePack::Class {\n    has Version $.version is packed-by('Str') is unpacked-by('new');\n}"}]},{"type":"para","id":"xMl5iDE1PebPdLSyzhGAs","margin":"","location":{"start":{"line":61,"column":1,"offset":2232},"end":{"line":62,"column":32,"offset":2342}},"text":"text","content":["Where the ",{"type":"fcode","name":"C","content":["Str"]}," method returns a string that is suitable to be passed to ",{"type":"fcode","name":"C","content":["new"]},"\nto create a new Version object."]},{"type":"para","id":"-1Q0fNTgBeZbQivGuDnqs","margin":"","location":{"start":{"line":64,"column":1,"offset":2344},"end":{"line":67,"column":8,"offset":2604}},"text":"text","content":["If a subroutine (or other Callable object) is passed to the traits then it should take\na single argument and return a value suitable for serialization (for ",{"type":"fcode","name":"C","content":["packed-by"]},") or\nan object of the appropriate type (for ",{"type":"fcode","name":"C","content":["unpacked-by"]},") so the above example might\nbecome:"]},{"type":"block","id":"V3NKJQwNTonmmsvVrVWId","margin":"","name":"code","config":[],"location":{"start":{"line":69,"column":1,"offset":2606},"end":{"line":73,"column":4,"offset":2768}},"content":[{"type":"verbatim","value":"class TraitTest does MessagePack::Class {\n    has Version $.version is packed-by(-> Version $v { $v.Str }) is unpacked-by(-> Str $v { Version.new($v)});\n}"}]},{"type":"para","id":"3CxbdtgPcAJ6-cdyE6tdP","margin":"","location":{"start":{"line":75,"column":1,"offset":2770},"end":{"line":75,"column":81,"offset":2850}},"text":"text","content":["You can of course make the subroutines as complex as is required for your types."]},{"type":"para","id":"v1BYIT6c6B_8FZnieDC-T","margin":"","location":{"start":{"line":77,"column":1,"offset":2852},"end":{"line":79,"column":18,"offset":3035}},"text":"text","content":["If you need your data to be interoperable with software written in another language\nyou may need to adjust the serialization accordingly to match the types available\nin that language."]},{"type":"block","id":"Lnv_A5x2HSmLZC2ISKVeN","margin":"","level":2,"name":"head","location":{"start":{"line":81,"column":1,"offset":3037},"end":{"line":81,"column":16,"offset":3052}},"content":["Installation"]},{"type":"para","id":"2kVowAqUTsgnbWnSUfIMS","margin":"","location":{"start":{"line":83,"column":1,"offset":3054},"end":{"line":83,"column":100,"offset":3153}},"text":"text","content":["Assuming you have a working Rakudo installation the you should be able to install this with ",{"type":"fcode","name":"C","content":["zef"]}," :"]},{"type":"block","id":"a62fVMi8jRIlspbjyiuhE","margin":"","name":"code","config":[],"location":{"start":{"line":85,"column":1,"offset":3155},"end":{"line":89,"column":18,"offset":3242}},"content":[{"type":"verbatim","value":"zef install MessagePack::Class\n\n# or from a local check-out:\n\nzef install ."}]},{"type":"para","id":"YVjNv59nuvJLB-MuGemAB","margin":"","location":{"start":{"line":91,"column":1,"offset":3244},"end":{"line":91,"column":110,"offset":3353}},"text":"text","content":["Though I can't see any reason this shouldn't work with any other installer that may come along in the future."]},{"type":"para","id":"DWavDUaEDr2ssBAOPmLsw","margin":"","location":{"start":{"line":93,"column":1,"offset":3355},"end":{"line":93,"column":76,"offset":3430}},"text":"text","content":["If it reports that is having trouble installing the dependency, you can do:"]},{"type":"block","id":"tguizJU0VzFDVaAo8yQ8a","margin":"","name":"code","config":[],"location":{"start":{"line":95,"column":1,"offset":3432},"end":{"line":95,"column":87,"offset":3518}},"content":[{"type":"verbatim","value":"zef install -v --debug https://github.com/pierre-vigier/Perl6-Data-MessagePack.git"}]},{"type":"block","id":"dMvgxDcmCAQP0jxIrqZLV","margin":"","level":2,"name":"head","location":{"start":{"line":97,"column":1,"offset":3520},"end":{"line":97,"column":11,"offset":3530}},"content":["Support"]},{"type":"para","id":"ahcXqhA3e9x13BjI1KAD8","margin":"","location":{"start":{"line":99,"column":1,"offset":3532},"end":{"line":101,"column":53,"offset":3737}},"text":"text","content":["If you find a problem with this module or have a suggestion please report at\n",{"meta":"https://github.com/jonathanstowe/MessagePack-Class/issues","type":"fcode","name":"L","content":["https://github.com/jonathanstowe/MessagePack-Class/issues"]}," - though I always\nprefer a pull request with tests if you can do that."]},{"type":"block","id":"Ugb0IxXGejVSbkqzFidSE","margin":"","level":2,"name":"head","location":{"start":{"line":103,"column":1,"offset":3739},"end":{"line":103,"column":25,"offset":3763}},"content":["Licence and Copyright"]},{"type":"para","id":"GAQGQT8I18bPhVNN3SM9y","margin":"","location":{"start":{"line":105,"column":1,"offset":3765},"end":{"line":105,"column":82,"offset":3846}},"text":"text","content":["This is free software. Please see the ",{"meta":"LICENCE","type":"fcode","name":"L","content":["LICENCE"]}," file in this repository."]},{"type":"para","id":"KvHzcPAVNn88ZM_FQBrMH","margin":"","location":{"start":{"line":107,"column":1,"offset":3848},"end":{"line":107,"column":29,"offset":3876}},"text":"text","content":["© Jonathan Stowe 2017 - 2021"]}]},"publishUrl":"/mods/zef/MessagePack::Class/MessagePack-Class-0.0.4/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"1.9","auth":"zef:jonathanstowe","authors":["Jonathan Stowe <jns+gh@gellyfish.co.uk>"],"build-depends":[],"depends":["Data::MessagePack"],"description":"Serialize/Deserialize Raku classes to/from MessagePack blobs","dist":"MessagePack::Class:ver<0.0.4>:auth<zef:jonathanstowe>","license":"Artistic-2.0","meta-version":"1","name":"MessagePack::Class","path":"M/ES/MESSAGEPACK_CLASS/6f41d0c6c1b0cf6f4b1ca5e824a34ebe673c0987.tar.gz","provides":{"MessagePack::Class":"lib/MessagePack/Class.pm"},"raku":"6.*","resources":[],"source-url":"https://github.com/jonathanstowe/MessagePack-Class.git","support":{"bugtracker":"https://github.com/jonathanstowe/MessagePack-Class/issues","email":"jns+gh@gellyfish.co.uk","source":"https://github.com/jonathanstowe/MessagePack-Class.git"},"tags":["messagepack","message","serialization","data"],"test-depends":[],"version":"0.0.4"},"files":[{"file":"work_mods/zef/MessagePack::Class/MessagePack-Class-0.0.4/README.md","publishUrl":"/mods/zef/MessagePack::Class/MessagePack-Class-0.0.4/README.md"},{"file":"work_mods/zef/MessagePack::Class/MessagePack-Class-0.0.4/lib/MessagePack/Class.pm","publishUrl":"/mods/zef/MessagePack::Class/MessagePack-Class-0.0.4/lib/MessagePack/Class.pm"}],"src":"zef","url":"/mods/zef/MessagePack::Class"}}}
    =end data
    =end React


MessagePack::Class


Create, display, and execute a simple option menu on the command line


Menu::Simple


The Raku Knowledge Base


=begin React :component<HeaderCol> :id<footer>  
=begin nested :!nested
=item1 B<Language>
    =item2 L<Get started|file:../getting-started/getting-started.podlite>
    =item2 L<Why Raku?|/doc/language/faq#Why-should-I-learn-Raku-What's-so-great-about-it>
    =item2 L<Try Raku|https://glot.io/new/raku>
    =item2 L<Raku cheat sheet|https://github.com/Raku/mu/blob/master/docs/Perl6/Cheatsheet/cheatsheet.txt>
    =item2 L<empty|#>
    =item2 L<empty|#>
    =item2 L<empty|#>
    =item2 L<Raku on Exercism|https://exercism.org/tracks/raku>
    =item2 L<Wikipedia|https://en.wikipedia.org/wiki/Raku_(programming_language)>
    =item2 L<empty|#>
    =item2 L<empty|#>
    =item2 L<empty|#>

=end nested
=begin nested :!nested

=item1 B<L<Documentation|/doc>>
    =item2 L<Getting started, Migration guides from other languages, & Tutorials | file:../doc/introduction.podlite>
    =item2 L<Language References|file:../doc/reference.podlite>
    =item2 L<Type Reference| file:../doc/types.podlite>
    =item2 L<Miscellaneous| file:../doc/miscellaneous.podlite>
    =item2 L<FAQs (Frequently Asked Questions)|/doc/language/faq>
    =item2 L<Community|/doc/language/community>
    =item2 L<The list of all documents|file:../doc/index.podlite>

=item1 B<Resources>
    =item2 L<The Raku Guide|https://raku.guide/>
    =item2 L<Books |https://perl6book.com/>
    =item2 L<Rosetta Code | https://www.raku.org/community/rosettacode>

=end nested
=begin nested :!nested

=item1 B<Resoures>
    =item2 L<Download | file:../download/index.podlite>
    =item2 L<empty|#>
    =item2 L<empty|#>
    =item2 L<empty|#>
    =item2 L<empty|#>
    =item2 L<empty|#>
    =item2 L<empty|#>
    =item2 L<empty|#>

=item1 B<Learning>
    =item2 L<The Raku Guide|https://raku.guide/>
    =item2 L<Wikibook |https://en.wikibooks.org/wiki/Raku_Programming>
    =item2 L<Books |https://perl6book.com/>
    =item2 L<Rosetta Code | https://www.raku.org/community/rosettacode>
    =item2 L<Learn Raku in Y minutes|https://learnxinyminutes.com/docs/raku/>
    =item2 L<Golfing |https://github.com/AlexDaniel/raku-golf-cheatsheet>
=end nested
=begin nested :!nested

=item1 B<Explore>
    =item2 L<Raku Blog Aggregator|https://planet.raku.org/>
    =item2 L<Rakudo Weekly|https://rakudoweekly.blog/>
    =item2 L<The Weekly Challenge |https://perlweeklychallenge.org/>
    =item2 L<Raku Advent Calendar|https://raku-advent.blog/>
    =item2 L<empty|#>
    =item2 L<empty|#>
    =item2 L<empty|#>
    =item2 L<empty|#>
    =item2 L<empty|#>

=end nested
=end React


=begin React :component<CookieConsent> :id<CookieConsent> :buttonCaption("Got it!")
=para
This website uses cookies for analytics.
=end React


MergeOrderedSeqs

NAME

SYNOPSIS

DESCRIPTION

AUTHOR

COPYRIGHT AND LICENSE

MergeOrderedSeqs v0.0.1

Authors

License

Dependencies

Test Dependencies

Provides

Documentation