TITLE

Provides a trait to store an alternative JSON Name


SUBTITLE

data

=begin data
{"type":"page","file":"work_mods/zef/JSON::Name/JSON-Name-0.0.7/README.md","sources":[],"node":{"type":"block","id":"tVEd15OEgSXEg72ClTeHm","margin":"","name":"root","content":[{"type":"block","id":"BO-TZPbuwxInFMd5pxvZ5","margin":"","level":1,"name":"head","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":13,"offset":12}},"content":["JSON::Name"]},{"type":"para","id":"uavHbv4TdmE7-TeGGf8MS","margin":"","location":{"start":{"line":3,"column":1,"offset":14},"end":{"line":3,"column":110,"offset":123}},"text":"text","content":["Provide a trait (and Attribute role) for JSON Marshal/Unmarshal where the JSON names aren't Raku identifiers."]},{"type":"para","id":"QP54oQRQ_Lki30PyXY1xk","margin":"","location":{"start":{"line":5,"column":1,"offset":125},"end":{"line":5,"column":83,"offset":207}},"text":"text","content":[{"type":"block","id":"wFDpXKGst78XICuBYmXD8","margin":"","name":"Image","config":[],"location":{"start":{"line":5,"column":1,"offset":125},"end":{"line":5,"column":83,"offset":207}},"content":[{"type":"image","src":"https://github.com/jonathanstowe/JSON-Name/workflows/CI/badge.svg","alt":"Build Status"}]}]},{"type":"block","id":"HHA3k4kqCybRe7Va42psl","margin":"","level":2,"name":"head","location":{"start":{"line":7,"column":1,"offset":209},"end":{"line":7,"column":12,"offset":220}},"content":["Synopsis"]},{"type":"block","id":"a0ITfYbVtcTrtd2Iq5-Tt","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":9,"column":1,"offset":222},"end":{"line":19,"column":4,"offset":471}},"content":[{"type":"verbatim","value":"use JSON::Name;\n\nclass MyClass {\n\t# The attribute meta object will have the role JSON::Name::NamedAttribute\n   # applied and \"666.evil.name\" will be stored in it's json-name attribute\n   has $.nice-name is json-name('666.evil.name');\n\n}\n"}]},{"type":"block","id":"cBgk4QNyPtPZnevLnTpa5","margin":"","level":2,"name":"head","location":{"start":{"line":21,"column":1,"offset":473},"end":{"line":21,"column":15,"offset":487}},"content":["Description"]},{"type":"para","id":"KR3LEmU9oeT5IGnWdk0Df","margin":"","location":{"start":{"line":23,"column":1,"offset":489},"end":{"line":30,"column":55,"offset":1006}},"text":"text","content":["This is released as a dependency of\n",{"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"]}," in order to\nsave duplication, it is intended to store a separate JSON name for an\nattribute where the name of the JSON attribute might be changed, either\nfor aesthetic reasons or the name is not a valid Raku identifier. It will\nof course also be needed in classes thar are going to use JSON::Marshal\nor JSON::Unmarshal for serialisation/de-serialisation."]},{"type":"para","id":"20zMTEjN7OvMf7NzEy1eL","margin":"","location":{"start":{"line":32,"column":1,"offset":1008},"end":{"line":32,"column":67,"offset":1074}},"text":"text","content":["Of course it could be used in other modules for a similar purpose."]},{"type":"block","id":"M6SxEV5nAP1qBA48R0q0C","margin":"","level":2,"name":"head","location":{"start":{"line":34,"column":1,"offset":1076},"end":{"line":34,"column":16,"offset":1091}},"content":["Installation"]},{"type":"para","id":"oOQpM-jyDO-8Mw2YikoKs","margin":"","location":{"start":{"line":36,"column":1,"offset":1093},"end":{"line":36,"column":96,"offset":1188}},"text":"text","content":["Assuming you have a working Rakudo installation you should be able to install this with ",{"type":"fcode","name":"I","content":["zef"]}," :"]},{"type":"block","id":"vTWN0YbpT5aHtQVowBEmI","margin":"","name":"code","config":[],"location":{"start":{"line":38,"column":1,"offset":1190},"end":{"line":44,"column":27,"offset":1295}},"content":[{"type":"verbatim","value":"# From the source directory\n\nzef install .\n\n# Remote installation\n\nzef install JSON::Name"}]},{"type":"block","id":"fZOX6BG3N-gpzzYrYsLOn","margin":"","level":2,"name":"head","location":{"start":{"line":46,"column":1,"offset":1297},"end":{"line":46,"column":11,"offset":1307}},"content":["Support"]},{"type":"para","id":"GCHuv0BhyJmDdlK23xwWz","margin":"","location":{"start":{"line":48,"column":1,"offset":1309},"end":{"line":48,"column":90,"offset":1398}},"text":"text","content":["Suggestions/patches are welcomed via github at ",{"meta":"https://github.com/jonathanstowe/JSON-Name","type":"fcode","name":"L","content":["https://github.com/jonathanstowe/JSON-Name"]}]},{"type":"block","id":"t9FnX9ancfe12Kx-_HFZz","margin":"","level":2,"name":"head","location":{"start":{"line":50,"column":1,"offset":1400},"end":{"line":50,"column":11,"offset":1410}},"content":["Licence"]},{"type":"para","id":"f7FyOUlrqa8EspHmk8ooQ","margin":"","location":{"start":{"line":52,"column":1,"offset":1412},"end":{"line":52,"column":23,"offset":1434}},"text":"text","content":["This is free software."]},{"type":"para","id":"W79FqxbaKMQu12aNyYuzd","margin":"","location":{"start":{"line":54,"column":1,"offset":1436},"end":{"line":54,"column":59,"offset":1494}},"text":"text","content":["Please see the ",{"meta":"LICENCE","type":"fcode","name":"L","content":["LICENCE"]}," file in the distribution"]},{"type":"para","id":"m8eg8EQ30Ahh_Okqjbqb7","margin":"","location":{"start":{"line":56,"column":1,"offset":1496},"end":{"line":56,"column":29,"offset":1524}},"text":"text","content":["© Jonathan Stowe 2015 - 2021"]}]},"publishUrl":"/mods/zef/JSON::Name/JSON-Name-0.0.7/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"1.0","auth":"zef:jonathanstowe","author":"Jonathan Stowe <jns+git@gellyfish.co.uk>","authors":["Jonathan Stowe <jns+git@gellyfish.co.uk>"],"build-depends":[],"depends":["JSON::OptIn"],"description":"Provides a trait to store an alternative JSON Name","dist":"JSON::Name:ver<0.0.7>:auth<zef:jonathanstowe>","license":"Artistic-2.0","meta-version":"1","name":"JSON::Name","path":"J/SO/JSON_NAME/d7486670f476871c83d6dbc2c87f665b69d484ab.tar.gz","provides":{"JSON::Name":"lib/JSON/Name.rakumod"},"raku":"6.*","resources":[],"source-url":"git://github.com/jonathanstowe/JSON-Name.git","support":{"bugtracker":"https://github.com/jonathanstowe/JSON-Name/issues","source":"git://github.com/jonathanstowe/JSON-Name.git"},"tags":["object","serialisation","JSON"],"test-depends":["Test"],"version":"0.0.7"},"files":[{"file":"work_mods/zef/JSON::Name/JSON-Name-0.0.7/README.md","publishUrl":"/mods/zef/JSON::Name/JSON-Name-0.0.7/README.md"},{"file":"work_mods/zef/JSON::Name/JSON-Name-0.0.7/lib/JSON/Name.rakumod","publishUrl":"/mods/zef/JSON::Name/JSON-Name-0.0.7/lib/JSON/Name.rakumod"}],"src":"zef","url":"/mods/zef/JSON::Name"}}}
=end data


React

    =begin React :component<RenderItem>
    =begin data
    {"type":"page","file":"work_mods/zef/JSON::Name/JSON-Name-0.0.7/README.md","sources":[],"node":{"type":"block","id":"tVEd15OEgSXEg72ClTeHm","margin":"","name":"root","content":[{"type":"block","id":"BO-TZPbuwxInFMd5pxvZ5","margin":"","level":1,"name":"head","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":13,"offset":12}},"content":["JSON::Name"]},{"type":"para","id":"uavHbv4TdmE7-TeGGf8MS","margin":"","location":{"start":{"line":3,"column":1,"offset":14},"end":{"line":3,"column":110,"offset":123}},"text":"text","content":["Provide a trait (and Attribute role) for JSON Marshal/Unmarshal where the JSON names aren't Raku identifiers."]},{"type":"para","id":"QP54oQRQ_Lki30PyXY1xk","margin":"","location":{"start":{"line":5,"column":1,"offset":125},"end":{"line":5,"column":83,"offset":207}},"text":"text","content":[{"type":"block","id":"wFDpXKGst78XICuBYmXD8","margin":"","name":"Image","config":[],"location":{"start":{"line":5,"column":1,"offset":125},"end":{"line":5,"column":83,"offset":207}},"content":[{"type":"image","src":"https://github.com/jonathanstowe/JSON-Name/workflows/CI/badge.svg","alt":"Build Status"}]}]},{"type":"block","id":"HHA3k4kqCybRe7Va42psl","margin":"","level":2,"name":"head","location":{"start":{"line":7,"column":1,"offset":209},"end":{"line":7,"column":12,"offset":220}},"content":["Synopsis"]},{"type":"block","id":"a0ITfYbVtcTrtd2Iq5-Tt","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":9,"column":1,"offset":222},"end":{"line":19,"column":4,"offset":471}},"content":[{"type":"verbatim","value":"use JSON::Name;\n\nclass MyClass {\n\t# The attribute meta object will have the role JSON::Name::NamedAttribute\n   # applied and \"666.evil.name\" will be stored in it's json-name attribute\n   has $.nice-name is json-name('666.evil.name');\n\n}\n"}]},{"type":"block","id":"cBgk4QNyPtPZnevLnTpa5","margin":"","level":2,"name":"head","location":{"start":{"line":21,"column":1,"offset":473},"end":{"line":21,"column":15,"offset":487}},"content":["Description"]},{"type":"para","id":"KR3LEmU9oeT5IGnWdk0Df","margin":"","location":{"start":{"line":23,"column":1,"offset":489},"end":{"line":30,"column":55,"offset":1006}},"text":"text","content":["This is released as a dependency of\n",{"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"]}," in order to\nsave duplication, it is intended to store a separate JSON name for an\nattribute where the name of the JSON attribute might be changed, either\nfor aesthetic reasons or the name is not a valid Raku identifier. It will\nof course also be needed in classes thar are going to use JSON::Marshal\nor JSON::Unmarshal for serialisation/de-serialisation."]},{"type":"para","id":"20zMTEjN7OvMf7NzEy1eL","margin":"","location":{"start":{"line":32,"column":1,"offset":1008},"end":{"line":32,"column":67,"offset":1074}},"text":"text","content":["Of course it could be used in other modules for a similar purpose."]},{"type":"block","id":"M6SxEV5nAP1qBA48R0q0C","margin":"","level":2,"name":"head","location":{"start":{"line":34,"column":1,"offset":1076},"end":{"line":34,"column":16,"offset":1091}},"content":["Installation"]},{"type":"para","id":"oOQpM-jyDO-8Mw2YikoKs","margin":"","location":{"start":{"line":36,"column":1,"offset":1093},"end":{"line":36,"column":96,"offset":1188}},"text":"text","content":["Assuming you have a working Rakudo installation you should be able to install this with ",{"type":"fcode","name":"I","content":["zef"]}," :"]},{"type":"block","id":"vTWN0YbpT5aHtQVowBEmI","margin":"","name":"code","config":[],"location":{"start":{"line":38,"column":1,"offset":1190},"end":{"line":44,"column":27,"offset":1295}},"content":[{"type":"verbatim","value":"# From the source directory\n\nzef install .\n\n# Remote installation\n\nzef install JSON::Name"}]},{"type":"block","id":"fZOX6BG3N-gpzzYrYsLOn","margin":"","level":2,"name":"head","location":{"start":{"line":46,"column":1,"offset":1297},"end":{"line":46,"column":11,"offset":1307}},"content":["Support"]},{"type":"para","id":"GCHuv0BhyJmDdlK23xwWz","margin":"","location":{"start":{"line":48,"column":1,"offset":1309},"end":{"line":48,"column":90,"offset":1398}},"text":"text","content":["Suggestions/patches are welcomed via github at ",{"meta":"https://github.com/jonathanstowe/JSON-Name","type":"fcode","name":"L","content":["https://github.com/jonathanstowe/JSON-Name"]}]},{"type":"block","id":"t9FnX9ancfe12Kx-_HFZz","margin":"","level":2,"name":"head","location":{"start":{"line":50,"column":1,"offset":1400},"end":{"line":50,"column":11,"offset":1410}},"content":["Licence"]},{"type":"para","id":"f7FyOUlrqa8EspHmk8ooQ","margin":"","location":{"start":{"line":52,"column":1,"offset":1412},"end":{"line":52,"column":23,"offset":1434}},"text":"text","content":["This is free software."]},{"type":"para","id":"W79FqxbaKMQu12aNyYuzd","margin":"","location":{"start":{"line":54,"column":1,"offset":1436},"end":{"line":54,"column":59,"offset":1494}},"text":"text","content":["Please see the ",{"meta":"LICENCE","type":"fcode","name":"L","content":["LICENCE"]}," file in the distribution"]},{"type":"para","id":"m8eg8EQ30Ahh_Okqjbqb7","margin":"","location":{"start":{"line":56,"column":1,"offset":1496},"end":{"line":56,"column":29,"offset":1524}},"text":"text","content":["© Jonathan Stowe 2015 - 2021"]}]},"publishUrl":"/mods/zef/JSON::Name/JSON-Name-0.0.7/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"1.0","auth":"zef:jonathanstowe","author":"Jonathan Stowe <jns+git@gellyfish.co.uk>","authors":["Jonathan Stowe <jns+git@gellyfish.co.uk>"],"build-depends":[],"depends":["JSON::OptIn"],"description":"Provides a trait to store an alternative JSON Name","dist":"JSON::Name:ver<0.0.7>:auth<zef:jonathanstowe>","license":"Artistic-2.0","meta-version":"1","name":"JSON::Name","path":"J/SO/JSON_NAME/d7486670f476871c83d6dbc2c87f665b69d484ab.tar.gz","provides":{"JSON::Name":"lib/JSON/Name.rakumod"},"raku":"6.*","resources":[],"source-url":"git://github.com/jonathanstowe/JSON-Name.git","support":{"bugtracker":"https://github.com/jonathanstowe/JSON-Name/issues","source":"git://github.com/jonathanstowe/JSON-Name.git"},"tags":["object","serialisation","JSON"],"test-depends":["Test"],"version":"0.0.7"},"files":[{"file":"work_mods/zef/JSON::Name/JSON-Name-0.0.7/README.md","publishUrl":"/mods/zef/JSON::Name/JSON-Name-0.0.7/README.md"},{"file":"work_mods/zef/JSON::Name/JSON-Name-0.0.7/lib/JSON/Name.rakumod","publishUrl":"/mods/zef/JSON::Name/JSON-Name-0.0.7/lib/JSON/Name.rakumod"}],"src":"zef","url":"/mods/zef/JSON::Name"}}}
    =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

JSON::Name


Provide a trait and role to identify opt-in JSON serialization


=begin data
{"type":"page","file":"work_mods/zef/JSON::OptIn/JSON-OptIn-0.0.2/README.md","sources":[],"node":{"type":"block","id":"GKGhx97psjYs7MCD-KzWM","margin":"","name":"root","content":[{"type":"block","id":"wWTq0jWHZoOt5QGMVud3j","margin":"","level":1,"name":"head","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":13,"offset":12}},"content":["JSON-OptIn"]},{"type":"para","id":"93fz7wiv3K_6kE6VVHC5u","margin":"","location":{"start":{"line":3,"column":1,"offset":14},"end":{"line":3,"column":63,"offset":76}},"text":"text","content":["Provide a trait and role to identify opt-in JSON serialization"]},{"type":"para","id":"tBk27VVJQNP8vau9uYhha","margin":"","location":{"start":{"line":5,"column":1,"offset":78},"end":{"line":5,"column":162,"offset":239}},"text":"text","content":[{"meta":"https://github.com/jonathanstowe/JSON-OptIn/actions/workflows/main.yml","type":"fcode","name":"L","content":[{"type":"block","id":"3ELKLfdBAwGLUwQ0IvHLH","margin":"","name":"Image","config":[],"location":{"start":{"line":5,"column":2,"offset":79},"end":{"line":5,"column":89,"offset":166}},"content":[{"type":"image","src":"https://github.com/jonathanstowe/JSON-OptIn/actions/workflows/main.yml/badge.svg","alt":"CI"}]}]}]},{"type":"block","id":"pBd9cGIrHhqzSiak1nU8m","margin":"","level":2,"name":"head","location":{"start":{"line":7,"column":1,"offset":241},"end":{"line":7,"column":12,"offset":252}},"content":["Synopsis"]},{"type":"block","id":"nVrSGAwAyDunOLPZ5eWBI","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":9,"column":1,"offset":254},"end":{"line":19,"column":4,"offset":392}},"content":[{"type":"verbatim","value":"\nuse JSON::OptIn;\n\nclass Foo {\n   # The attribute will be serialized if opt-in has been selected\n   has Str $.bar is json;\n\n\n}"}]},{"type":"block","id":"-wfusjj-FM47VQRYIxoBq","margin":"","level":2,"name":"head","location":{"start":{"line":21,"column":1,"offset":394},"end":{"line":21,"column":15,"offset":408}},"content":["Description"]},{"type":"para","id":"IA6iV5MAkfNCtJnrPAgr9","margin":"","location":{"start":{"line":23,"column":1,"offset":410},"end":{"line":26,"column":56,"offset":776}},"text":"text","content":["This provides a trait and a role for the identification of 'opt in' serialisiable attributes in,\nfor example, ",{"meta":"https://github.com/jonathanstowe/JSON-Marshal","type":"fcode","name":"L","content":["JSON::Marshal"]},". It's probably\nnot necessary to use this directly as it will be required by e.g. ",{"meta":"https://github.com/jonathanstowe/JSON-Name","type":"fcode","name":"L","content":["JSON::Name"]},"\nbut it's just more convenient to package it separately."]},{"type":"block","id":"e16S4Eijs40vwoPccwm_9","margin":"","level":2,"name":"head","location":{"start":{"line":28,"column":1,"offset":778},"end":{"line":28,"column":16,"offset":793}},"content":["Installation"]},{"type":"para","id":"MgoA4im00FVjxbsqWWQ9O","margin":"","location":{"start":{"line":30,"column":1,"offset":795},"end":{"line":31,"column":130,"offset":1042}},"text":"text","content":["You probably don't need to install this separately unless you are creating a new module that might use it, as it will\nbe pulled in as a dependency where it is needed, however if you have a working rakudo installation you can install it with ",{"type":"fcode","name":"I","content":["zef"]},":"]},{"type":"block","id":"0TBrXQMc2OkEYxTJA5sI9","margin":"","name":"code","config":[],"location":{"start":{"line":33,"column":1,"offset":1044},"end":{"line":33,"column":29,"offset":1072}},"content":[{"type":"verbatim","value":"zef install JSON::OptIn;"}]},{"type":"block","id":"rpnIpqUxisNwlZ0ufvkuB","margin":"","level":2,"name":"head","location":{"start":{"line":35,"column":1,"offset":1074},"end":{"line":35,"column":11,"offset":1084}},"content":["Support"]},{"type":"para","id":"dBjcj7bg5_b55kHMysTvy","margin":"","location":{"start":{"line":37,"column":1,"offset":1086},"end":{"line":38,"column":124,"offset":1331}},"text":"text","content":["This doesn't provide any user facing functionality, it is likely that if you are experiencing problems then it is in some\nmodule that depends on this. However you can report issues at ",{"meta":"https://github.com/jonathanstowe/JSON-OptIn/issues","type":"fcode","name":"L","content":["GitHub"]},"."]},{"type":"block","id":"4GJoFJXW_QJe7HHy6dF2t","margin":"","level":2,"name":"head","location":{"start":{"line":40,"column":1,"offset":1333},"end":{"line":40,"column":24,"offset":1356}},"content":["Licence && Copyright"]},{"type":"para","id":"k93hMUjTdsUgayqOu3_tz","margin":"","location":{"start":{"line":42,"column":1,"offset":1358},"end":{"line":42,"column":94,"offset":1451}},"text":"text","content":["This is free software please see the ",{"meta":"LICENCE","type":"fcode","name":"L","content":["LICENCE"]}," file in the distribution for details."]},{"type":"para","id":"eu67nnLh4AXvoynzsKH-5","margin":"","location":{"start":{"line":44,"column":1,"offset":1453},"end":{"line":44,"column":22,"offset":1474}},"text":"text","content":["© Jonathan Stowe 2021"]}]},"publishUrl":"/mods/zef/JSON::OptIn/JSON-OptIn-0.0.2/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"","auth":"zef:jonathanstowe","authors":["Jonathan Stowe <jns+gh@gellyfish.co.uk>"],"build-depends":[],"depends":[],"description":"Provide a trait and role to identify opt-in JSON serialization","dist":"JSON::OptIn:ver<0.0.2>:auth<zef:jonathanstowe>","license":"Artistic-2.0","meta-version":"1","name":"JSON::OptIn","path":"J/SO/JSON_OPTIN/7ada0a9b952ab007f75f64afbf576183e4030264.tar.gz","provides":{"JSON::OptIn":"lib/JSON/OptIn.rakumod"},"raku":"6.d","resources":[],"source-url":"https://github.com/jonathanstowe/JSON-OptIn.git","support":{"bugtracker":"https://github.com/jonathanstowe/JSON-OptIn/issues","email":"jns+gh@gellyfish.co.uk","source":"https://github.com/jonathanstowe/JSON-OptIn.git"},"tags":["json","serialization","opt-in"],"test-depends":[],"version":"0.0.2"},"files":[{"file":"work_mods/zef/JSON::OptIn/JSON-OptIn-0.0.2/README.md","publishUrl":"/mods/zef/JSON::OptIn/JSON-OptIn-0.0.2/README.md"}],"src":"zef","url":"/mods/zef/JSON::OptIn"}}}
=end data


    =begin React :component<RenderItem>
    =begin data
    {"type":"page","file":"work_mods/zef/JSON::OptIn/JSON-OptIn-0.0.2/README.md","sources":[],"node":{"type":"block","id":"GKGhx97psjYs7MCD-KzWM","margin":"","name":"root","content":[{"type":"block","id":"wWTq0jWHZoOt5QGMVud3j","margin":"","level":1,"name":"head","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":13,"offset":12}},"content":["JSON-OptIn"]},{"type":"para","id":"93fz7wiv3K_6kE6VVHC5u","margin":"","location":{"start":{"line":3,"column":1,"offset":14},"end":{"line":3,"column":63,"offset":76}},"text":"text","content":["Provide a trait and role to identify opt-in JSON serialization"]},{"type":"para","id":"tBk27VVJQNP8vau9uYhha","margin":"","location":{"start":{"line":5,"column":1,"offset":78},"end":{"line":5,"column":162,"offset":239}},"text":"text","content":[{"meta":"https://github.com/jonathanstowe/JSON-OptIn/actions/workflows/main.yml","type":"fcode","name":"L","content":[{"type":"block","id":"3ELKLfdBAwGLUwQ0IvHLH","margin":"","name":"Image","config":[],"location":{"start":{"line":5,"column":2,"offset":79},"end":{"line":5,"column":89,"offset":166}},"content":[{"type":"image","src":"https://github.com/jonathanstowe/JSON-OptIn/actions/workflows/main.yml/badge.svg","alt":"CI"}]}]}]},{"type":"block","id":"pBd9cGIrHhqzSiak1nU8m","margin":"","level":2,"name":"head","location":{"start":{"line":7,"column":1,"offset":241},"end":{"line":7,"column":12,"offset":252}},"content":["Synopsis"]},{"type":"block","id":"nVrSGAwAyDunOLPZ5eWBI","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":9,"column":1,"offset":254},"end":{"line":19,"column":4,"offset":392}},"content":[{"type":"verbatim","value":"\nuse JSON::OptIn;\n\nclass Foo {\n   # The attribute will be serialized if opt-in has been selected\n   has Str $.bar is json;\n\n\n}"}]},{"type":"block","id":"-wfusjj-FM47VQRYIxoBq","margin":"","level":2,"name":"head","location":{"start":{"line":21,"column":1,"offset":394},"end":{"line":21,"column":15,"offset":408}},"content":["Description"]},{"type":"para","id":"IA6iV5MAkfNCtJnrPAgr9","margin":"","location":{"start":{"line":23,"column":1,"offset":410},"end":{"line":26,"column":56,"offset":776}},"text":"text","content":["This provides a trait and a role for the identification of 'opt in' serialisiable attributes in,\nfor example, ",{"meta":"https://github.com/jonathanstowe/JSON-Marshal","type":"fcode","name":"L","content":["JSON::Marshal"]},". It's probably\nnot necessary to use this directly as it will be required by e.g. ",{"meta":"https://github.com/jonathanstowe/JSON-Name","type":"fcode","name":"L","content":["JSON::Name"]},"\nbut it's just more convenient to package it separately."]},{"type":"block","id":"e16S4Eijs40vwoPccwm_9","margin":"","level":2,"name":"head","location":{"start":{"line":28,"column":1,"offset":778},"end":{"line":28,"column":16,"offset":793}},"content":["Installation"]},{"type":"para","id":"MgoA4im00FVjxbsqWWQ9O","margin":"","location":{"start":{"line":30,"column":1,"offset":795},"end":{"line":31,"column":130,"offset":1042}},"text":"text","content":["You probably don't need to install this separately unless you are creating a new module that might use it, as it will\nbe pulled in as a dependency where it is needed, however if you have a working rakudo installation you can install it with ",{"type":"fcode","name":"I","content":["zef"]},":"]},{"type":"block","id":"0TBrXQMc2OkEYxTJA5sI9","margin":"","name":"code","config":[],"location":{"start":{"line":33,"column":1,"offset":1044},"end":{"line":33,"column":29,"offset":1072}},"content":[{"type":"verbatim","value":"zef install JSON::OptIn;"}]},{"type":"block","id":"rpnIpqUxisNwlZ0ufvkuB","margin":"","level":2,"name":"head","location":{"start":{"line":35,"column":1,"offset":1074},"end":{"line":35,"column":11,"offset":1084}},"content":["Support"]},{"type":"para","id":"dBjcj7bg5_b55kHMysTvy","margin":"","location":{"start":{"line":37,"column":1,"offset":1086},"end":{"line":38,"column":124,"offset":1331}},"text":"text","content":["This doesn't provide any user facing functionality, it is likely that if you are experiencing problems then it is in some\nmodule that depends on this. However you can report issues at ",{"meta":"https://github.com/jonathanstowe/JSON-OptIn/issues","type":"fcode","name":"L","content":["GitHub"]},"."]},{"type":"block","id":"4GJoFJXW_QJe7HHy6dF2t","margin":"","level":2,"name":"head","location":{"start":{"line":40,"column":1,"offset":1333},"end":{"line":40,"column":24,"offset":1356}},"content":["Licence && Copyright"]},{"type":"para","id":"k93hMUjTdsUgayqOu3_tz","margin":"","location":{"start":{"line":42,"column":1,"offset":1358},"end":{"line":42,"column":94,"offset":1451}},"text":"text","content":["This is free software please see the ",{"meta":"LICENCE","type":"fcode","name":"L","content":["LICENCE"]}," file in the distribution for details."]},{"type":"para","id":"eu67nnLh4AXvoynzsKH-5","margin":"","location":{"start":{"line":44,"column":1,"offset":1453},"end":{"line":44,"column":22,"offset":1474}},"text":"text","content":["© Jonathan Stowe 2021"]}]},"publishUrl":"/mods/zef/JSON::OptIn/JSON-OptIn-0.0.2/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"","auth":"zef:jonathanstowe","authors":["Jonathan Stowe <jns+gh@gellyfish.co.uk>"],"build-depends":[],"depends":[],"description":"Provide a trait and role to identify opt-in JSON serialization","dist":"JSON::OptIn:ver<0.0.2>:auth<zef:jonathanstowe>","license":"Artistic-2.0","meta-version":"1","name":"JSON::OptIn","path":"J/SO/JSON_OPTIN/7ada0a9b952ab007f75f64afbf576183e4030264.tar.gz","provides":{"JSON::OptIn":"lib/JSON/OptIn.rakumod"},"raku":"6.d","resources":[],"source-url":"https://github.com/jonathanstowe/JSON-OptIn.git","support":{"bugtracker":"https://github.com/jonathanstowe/JSON-OptIn/issues","email":"jns+gh@gellyfish.co.uk","source":"https://github.com/jonathanstowe/JSON-OptIn.git"},"tags":["json","serialization","opt-in"],"test-depends":[],"version":"0.0.2"},"files":[{"file":"work_mods/zef/JSON::OptIn/JSON-OptIn-0.0.2/README.md","publishUrl":"/mods/zef/JSON::OptIn/JSON-OptIn-0.0.2/README.md"}],"src":"zef","url":"/mods/zef/JSON::OptIn"}}}
    =end data
    =end React


JSON::OptIn


=begin data
{"type":"page","file":"work_mods/zef/JSON::Marshal/JSON-Marshal-0.0.24/README.md","sources":[],"node":{"type":"block","id":"ZxTBiTEM8Xy4z2HI10KKD","margin":"","name":"root","content":[{"type":"block","id":"t4HAKNzVADvLvQchTf2Jr","margin":"","level":1,"name":"head","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":16,"offset":15}},"content":["JSON::Marshal"]},{"type":"para","id":"OTstYaXGjT7M1xyprVz9T","margin":"","location":{"start":{"line":3,"column":1,"offset":17},"end":{"line":3,"column":59,"offset":75}},"text":"text","content":["Make JSON from an Object (the opposite of JSON::Unmarshal)"]},{"type":"para","id":"dc3Pg2r6iB2OAxdXsaLX_","margin":"","location":{"start":{"line":5,"column":1,"offset":77},"end":{"line":5,"column":86,"offset":162}},"text":"text","content":[{"type":"block","id":"RX0owEcQKWuFVeSlECahd","margin":"","name":"Image","config":[],"location":{"start":{"line":5,"column":1,"offset":77},"end":{"line":5,"column":86,"offset":162}},"content":[{"type":"image","src":"https://github.com/jonathanstowe/JSON-Marshal/workflows/CI/badge.svg","alt":"Build Status"}]}]},{"type":"block","id":"boHpbfbOnOsIkJj_bURjm","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":"CJi1BsXFt8Ok6rEqK2IUU","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":9,"column":1,"offset":177},"end":{"line":25,"column":4,"offset":540}},"content":[{"type":"verbatim","value":"\n   use JSON::Marshal;\n\n    class SomeClass {\n      has Str $.string;\n      has Int $.int;\n      has Version $.version is marshalled-by('Str');\n    }\n\n    my $object = SomeClass.new(string => \"string\", int => 42, version => Version.new(\"0.0.1\"));\n\n\n    my Str $json = marshal($object); # -> \"{ \"string\" : \"string\", \"int\" : 42, \"version\" : \"0.0.1\" }'\n\n"}]},{"type":"para","id":"sb9geZU-JZMwfDmvRNBF4","margin":"","location":{"start":{"line":27,"column":1,"offset":542},"end":{"line":27,"column":30,"offset":571}},"text":"text","content":["Or with ",{"type":"fcode","name":"I","content":["opt-in"]}," marshalling:"]},{"type":"block","id":"f6dQD_zy8Z3Mj2YSevkm-","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":29,"column":1,"offset":573},"end":{"line":45,"column":4,"offset":1028}},"content":[{"type":"verbatim","value":"    use JSON::Marshal;\n    use JSON::OptIn;\n\n    class SomeClass {\n      has Str $.string is json;\n      has Int $.int    is json;\n      has Str $.secret;\n      has Version $.version is marshalled-by('Str');\n    }\n\n    my $object = SomeClass.new(secret => \"secret\", string => \"string\", int => 42, version => Version.new(\"0.0.1\"));\n\n\n    my Str $json = marshal($object, :opt-in); # -> \"{ \"string\" : \"string\", \"int\" : 42, \"version\" : \"0.0.1\" }'\n"}]},{"type":"block","id":"e1JaYdZN1VZ627l3cNTx3","margin":"","level":2,"name":"head","location":{"start":{"line":47,"column":1,"offset":1030},"end":{"line":47,"column":15,"offset":1044}},"content":["Description"]},{"type":"para","id":"LEMpK1uz2YTW4w4r2tTPC","margin":"","location":{"start":{"line":49,"column":1,"offset":1046},"end":{"line":51,"column":67,"offset":1260}},"text":"text","content":["This provides a single exported subroutine to create a JSON representation\nof an object. It should round trip back into an object of the same class\nusing ",{"meta":"https://github.com/tadzik/JSON-Unmarshal","type":"fcode","name":"L","content":["JSON::Unmarshal"]},"."]},{"type":"para","id":"37-LIbPlrSIoZ8Fwr9eKi","margin":"","location":{"start":{"line":53,"column":1,"offset":1262},"end":{"line":55,"column":13,"offset":1421}},"text":"text","content":["It only outputs the \"public\" attributes (that is those with accessors\ncreated by declaring them with the '.' twigil. Attributes without acccessors\nare ignored."]},{"type":"para","id":"df6uyYQ4DeofpJN55d2TC","margin":"","location":{"start":{"line":57,"column":1,"offset":1423},"end":{"line":65,"column":13,"offset":1972}},"text":"text","content":["If you want to ignore any attributes without a value you can use the\n",{"type":"fcode","name":"C","content":[":skip-null"]}," adverb to ",{"type":"fcode","name":"C","content":["marshal"]},", which will supress the\nmarshalling of any undefined attributes. Additionally if you want a\nfiner-grained control over this behaviour there is a 'json-skip-null'\nattribute trait which will cause the specific attribute to be skipped\nif it isn't defined irrespective of the ",{"type":"fcode","name":"C","content":["skip-null"]},". If\nyou want to always explicitly suppress the marshalling of an attribute then\nthe the trait ",{"type":"fcode","name":"C","content":["json-skip"]}," on an attribute will prevent it being output\nin the JSON."]},{"type":"para","id":"W1jtaqFGh_bLm0wZ7nmFG","margin":"","location":{"start":{"line":67,"column":1,"offset":1974},"end":{"line":75,"column":31,"offset":2616}},"text":"text","content":["By default ",{"type":"fcode","name":"I","content":["all"]}," public attributes will be candidates to be marshalled to JSON,\nwhich may not be convenient for all applications (for example only a small\nnumber of attributes should be marshalled in a large class,) so the ",{"type":"fcode","name":"C","content":["marshal"]},"\nprovides an ",{"type":"fcode","name":"C","content":[":opt-in"]}," adverb that inverts the behaviour so that only those\nattributes which have one of the traits that control marshalling\n(with the exception of ",{"type":"fcode","name":"C","content":["json-skip"]},",) will be candidates. The ",{"type":"fcode","name":"C","content":["is json"]}," trait\nfrom ",{"meta":"https://github.com/jonathanstowe/JSON-OptIn","type":"fcode","name":"L","content":["JSON::OptIn"]}," can be supplied to\nan attribute to mark it for marshalling explicitly, (it is implicit in all the\nother traits bar ",{"type":"fcode","name":"C","content":["json-skip"]},".)"]},{"type":"para","id":"oVJpgAidhI3WbxqEnyA1M","margin":"","location":{"start":{"line":77,"column":1,"offset":2618},"end":{"line":84,"column":7,"offset":3136}},"text":"text","content":["To allow a finer degree of control of how an attribute is marshalled an\nattribute trait ",{"type":"fcode","name":"C","content":["is marshalled-by"]}," is provided, this can take either\na Code object (an anonymous subroutine,) which should take as an argument\nthe value to be marshalled and should return a value that can be completely\nrepresented as JSON, that is to say a string, number or boolean or a Hash\nor Array who's values are those things. Alternatively the name of a method\nthat will be called on the value, the return value being constrained as\nabove."]},{"type":"para","id":"ssdmGqGtF5ov3z7q7bNRd","margin":"","location":{"start":{"line":86,"column":1,"offset":3138},"end":{"line":88,"column":63,"offset":3353}},"text":"text","content":["By default the JSON produced is ",{"type":"fcode","name":"I","content":["pretty"]}," (that is newlines and indentation,)\nwhich is nice for humans to read but has a lot of superfluous characters in\nit, this can be controlled by passing ",{"type":"fcode","name":"C","content":[":!pretty"]}," to ",{"type":"fcode","name":"C","content":["marshal"]},"."]},{"type":"block","id":"_z6-VZ9pcootKVOy1oN1Z","margin":"","level":2,"name":"head","location":{"start":{"line":90,"column":1,"offset":3355},"end":{"line":90,"column":16,"offset":3370}},"content":["Installation"]},{"type":"para","id":"g3eCY-4mX1NPgx_hAnnCu","margin":"","location":{"start":{"line":92,"column":1,"offset":3372},"end":{"line":92,"column":83,"offset":3454}},"text":"text","content":["Assuming you have a working Rakudo installation, you can install this with ",{"type":"fcode","name":"C","content":["zef"]}," :"]},{"type":"block","id":"3FMt0l7pvVvy1gtyKRDRq","margin":"","name":"code","config":[],"location":{"start":{"line":94,"column":1,"offset":3456},"end":{"line":100,"column":30,"offset":3564}},"content":[{"type":"verbatim","value":"# From the source directory\n\nzef install .\n\n# Remote installation\n\nzef install JSON::Marshal"}]},{"type":"block","id":"gjBC-D5xL8FkuGpaDSdLe","margin":"","level":2,"name":"head","location":{"start":{"line":102,"column":1,"offset":3566},"end":{"line":102,"column":11,"offset":3576}},"content":["Support"]},{"type":"para","id":"lXWpcL2HXdS99SmA6zzHE","margin":"","location":{"start":{"line":104,"column":1,"offset":3578},"end":{"line":104,"column":47,"offset":3624}},"text":"text","content":["Suggestions/patches are welcomed via github at"]},{"type":"para","id":"TnJpVbxwJ6lQiwDfWu3uC","margin":"","location":{"start":{"line":106,"column":1,"offset":3626},"end":{"line":106,"column":53,"offset":3678}},"text":"text","content":[{"meta":"https://github.com/jonathanstowe/JSON-Marshal/issues","type":"fcode","name":"L","content":["https://github.com/jonathanstowe/JSON-Marshal/issues"]}]},{"type":"block","id":"RzpNVsS4wGqVe7cFpfVdZ","margin":"","level":2,"name":"head","location":{"start":{"line":108,"column":1,"offset":3680},"end":{"line":108,"column":11,"offset":3690}},"content":["Licence"]},{"type":"para","id":"-Mes2o5LskxO6gGQFJTqa","margin":"","location":{"start":{"line":110,"column":1,"offset":3692},"end":{"line":110,"column":59,"offset":3750}},"text":"text","content":["Please see the ",{"meta":"LICENCE","type":"fcode","name":"L","content":["LICENCE"]}," file in the distribution"]},{"type":"para","id":"rlMCcEddUToPmUlssWstk","margin":"","location":{"start":{"line":112,"column":1,"offset":3752},"end":{"line":112,"column":58,"offset":3809}},"text":"text","content":["© Jonathan Stowe 2015, 2016, 2017, 2018, 2019, 2020, 2021"]}]},"publishUrl":"/mods/zef/JSON::Marshal/JSON-Marshal-0.0.24/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"1.0","auth":"zef:jonathanstowe","author":"Jonathan Stowe <jns+git@gellyfish.co.uk>","authors":["Jonathan Stowe <jns+git@gellyfish.co.uk>"],"build-depends":[],"depends":["JSON::Fast:ver<0.16+>","JSON::Name:ver<0.0.6+>","JSON::OptIn"],"description":"Simple serialisation of objects to JSON","dist":"JSON::Marshal:ver<0.0.24>:auth<zef:jonathanstowe>","license":"Artistic-2.0","meta-version":"1","name":"JSON::Marshal","path":"J/SO/JSON_MARSHAL/bd503b57c9cff4706f3a3e18390157a2a353536e.tar.gz","provides":{"JSON::Marshal":"lib/JSON/Marshal.rakumod"},"raku":"6.*","resources":[],"source-url":"https://github.com/jonathanstowe/JSON-Marshal.git","support":{"bugtracker":"https://github.com/jonathanstowe/JSON-Marshal/issues","email":"jns+git@gellyfish.co.uk","source":"https://github.com/jonathanstowe/JSON-Marshal.git"},"tags":["object","serialisation","JSON"],"test-depends":["Test","JSON::Fast:ver<0.16+>"],"version":"0.0.24"},"files":[{"file":"work_mods/zef/JSON::Marshal/JSON-Marshal-0.0.24/README.md","publishUrl":"/mods/zef/JSON::Marshal/JSON-Marshal-0.0.24/README.md"},{"file":"work_mods/zef/JSON::Marshal/JSON-Marshal-0.0.24/lib/JSON/Marshal.rakumod","publishUrl":"/mods/zef/JSON::Marshal/JSON-Marshal-0.0.24/lib/JSON/Marshal.rakumod"}],"src":"zef","url":"/mods/zef/JSON::Marshal"}}}
=end data


    =begin React :component<RenderItem>
    =begin data
    {"type":"page","file":"work_mods/zef/JSON::Marshal/JSON-Marshal-0.0.24/README.md","sources":[],"node":{"type":"block","id":"ZxTBiTEM8Xy4z2HI10KKD","margin":"","name":"root","content":[{"type":"block","id":"t4HAKNzVADvLvQchTf2Jr","margin":"","level":1,"name":"head","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":16,"offset":15}},"content":["JSON::Marshal"]},{"type":"para","id":"OTstYaXGjT7M1xyprVz9T","margin":"","location":{"start":{"line":3,"column":1,"offset":17},"end":{"line":3,"column":59,"offset":75}},"text":"text","content":["Make JSON from an Object (the opposite of JSON::Unmarshal)"]},{"type":"para","id":"dc3Pg2r6iB2OAxdXsaLX_","margin":"","location":{"start":{"line":5,"column":1,"offset":77},"end":{"line":5,"column":86,"offset":162}},"text":"text","content":[{"type":"block","id":"RX0owEcQKWuFVeSlECahd","margin":"","name":"Image","config":[],"location":{"start":{"line":5,"column":1,"offset":77},"end":{"line":5,"column":86,"offset":162}},"content":[{"type":"image","src":"https://github.com/jonathanstowe/JSON-Marshal/workflows/CI/badge.svg","alt":"Build Status"}]}]},{"type":"block","id":"boHpbfbOnOsIkJj_bURjm","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":"CJi1BsXFt8Ok6rEqK2IUU","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":9,"column":1,"offset":177},"end":{"line":25,"column":4,"offset":540}},"content":[{"type":"verbatim","value":"\n   use JSON::Marshal;\n\n    class SomeClass {\n      has Str $.string;\n      has Int $.int;\n      has Version $.version is marshalled-by('Str');\n    }\n\n    my $object = SomeClass.new(string => \"string\", int => 42, version => Version.new(\"0.0.1\"));\n\n\n    my Str $json = marshal($object); # -> \"{ \"string\" : \"string\", \"int\" : 42, \"version\" : \"0.0.1\" }'\n\n"}]},{"type":"para","id":"sb9geZU-JZMwfDmvRNBF4","margin":"","location":{"start":{"line":27,"column":1,"offset":542},"end":{"line":27,"column":30,"offset":571}},"text":"text","content":["Or with ",{"type":"fcode","name":"I","content":["opt-in"]}," marshalling:"]},{"type":"block","id":"f6dQD_zy8Z3Mj2YSevkm-","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":29,"column":1,"offset":573},"end":{"line":45,"column":4,"offset":1028}},"content":[{"type":"verbatim","value":"    use JSON::Marshal;\n    use JSON::OptIn;\n\n    class SomeClass {\n      has Str $.string is json;\n      has Int $.int    is json;\n      has Str $.secret;\n      has Version $.version is marshalled-by('Str');\n    }\n\n    my $object = SomeClass.new(secret => \"secret\", string => \"string\", int => 42, version => Version.new(\"0.0.1\"));\n\n\n    my Str $json = marshal($object, :opt-in); # -> \"{ \"string\" : \"string\", \"int\" : 42, \"version\" : \"0.0.1\" }'\n"}]},{"type":"block","id":"e1JaYdZN1VZ627l3cNTx3","margin":"","level":2,"name":"head","location":{"start":{"line":47,"column":1,"offset":1030},"end":{"line":47,"column":15,"offset":1044}},"content":["Description"]},{"type":"para","id":"LEMpK1uz2YTW4w4r2tTPC","margin":"","location":{"start":{"line":49,"column":1,"offset":1046},"end":{"line":51,"column":67,"offset":1260}},"text":"text","content":["This provides a single exported subroutine to create a JSON representation\nof an object. It should round trip back into an object of the same class\nusing ",{"meta":"https://github.com/tadzik/JSON-Unmarshal","type":"fcode","name":"L","content":["JSON::Unmarshal"]},"."]},{"type":"para","id":"37-LIbPlrSIoZ8Fwr9eKi","margin":"","location":{"start":{"line":53,"column":1,"offset":1262},"end":{"line":55,"column":13,"offset":1421}},"text":"text","content":["It only outputs the \"public\" attributes (that is those with accessors\ncreated by declaring them with the '.' twigil. Attributes without acccessors\nare ignored."]},{"type":"para","id":"df6uyYQ4DeofpJN55d2TC","margin":"","location":{"start":{"line":57,"column":1,"offset":1423},"end":{"line":65,"column":13,"offset":1972}},"text":"text","content":["If you want to ignore any attributes without a value you can use the\n",{"type":"fcode","name":"C","content":[":skip-null"]}," adverb to ",{"type":"fcode","name":"C","content":["marshal"]},", which will supress the\nmarshalling of any undefined attributes. Additionally if you want a\nfiner-grained control over this behaviour there is a 'json-skip-null'\nattribute trait which will cause the specific attribute to be skipped\nif it isn't defined irrespective of the ",{"type":"fcode","name":"C","content":["skip-null"]},". If\nyou want to always explicitly suppress the marshalling of an attribute then\nthe the trait ",{"type":"fcode","name":"C","content":["json-skip"]}," on an attribute will prevent it being output\nin the JSON."]},{"type":"para","id":"W1jtaqFGh_bLm0wZ7nmFG","margin":"","location":{"start":{"line":67,"column":1,"offset":1974},"end":{"line":75,"column":31,"offset":2616}},"text":"text","content":["By default ",{"type":"fcode","name":"I","content":["all"]}," public attributes will be candidates to be marshalled to JSON,\nwhich may not be convenient for all applications (for example only a small\nnumber of attributes should be marshalled in a large class,) so the ",{"type":"fcode","name":"C","content":["marshal"]},"\nprovides an ",{"type":"fcode","name":"C","content":[":opt-in"]}," adverb that inverts the behaviour so that only those\nattributes which have one of the traits that control marshalling\n(with the exception of ",{"type":"fcode","name":"C","content":["json-skip"]},",) will be candidates. The ",{"type":"fcode","name":"C","content":["is json"]}," trait\nfrom ",{"meta":"https://github.com/jonathanstowe/JSON-OptIn","type":"fcode","name":"L","content":["JSON::OptIn"]}," can be supplied to\nan attribute to mark it for marshalling explicitly, (it is implicit in all the\nother traits bar ",{"type":"fcode","name":"C","content":["json-skip"]},".)"]},{"type":"para","id":"oVJpgAidhI3WbxqEnyA1M","margin":"","location":{"start":{"line":77,"column":1,"offset":2618},"end":{"line":84,"column":7,"offset":3136}},"text":"text","content":["To allow a finer degree of control of how an attribute is marshalled an\nattribute trait ",{"type":"fcode","name":"C","content":["is marshalled-by"]}," is provided, this can take either\na Code object (an anonymous subroutine,) which should take as an argument\nthe value to be marshalled and should return a value that can be completely\nrepresented as JSON, that is to say a string, number or boolean or a Hash\nor Array who's values are those things. Alternatively the name of a method\nthat will be called on the value, the return value being constrained as\nabove."]},{"type":"para","id":"ssdmGqGtF5ov3z7q7bNRd","margin":"","location":{"start":{"line":86,"column":1,"offset":3138},"end":{"line":88,"column":63,"offset":3353}},"text":"text","content":["By default the JSON produced is ",{"type":"fcode","name":"I","content":["pretty"]}," (that is newlines and indentation,)\nwhich is nice for humans to read but has a lot of superfluous characters in\nit, this can be controlled by passing ",{"type":"fcode","name":"C","content":[":!pretty"]}," to ",{"type":"fcode","name":"C","content":["marshal"]},"."]},{"type":"block","id":"_z6-VZ9pcootKVOy1oN1Z","margin":"","level":2,"name":"head","location":{"start":{"line":90,"column":1,"offset":3355},"end":{"line":90,"column":16,"offset":3370}},"content":["Installation"]},{"type":"para","id":"g3eCY-4mX1NPgx_hAnnCu","margin":"","location":{"start":{"line":92,"column":1,"offset":3372},"end":{"line":92,"column":83,"offset":3454}},"text":"text","content":["Assuming you have a working Rakudo installation, you can install this with ",{"type":"fcode","name":"C","content":["zef"]}," :"]},{"type":"block","id":"3FMt0l7pvVvy1gtyKRDRq","margin":"","name":"code","config":[],"location":{"start":{"line":94,"column":1,"offset":3456},"end":{"line":100,"column":30,"offset":3564}},"content":[{"type":"verbatim","value":"# From the source directory\n\nzef install .\n\n# Remote installation\n\nzef install JSON::Marshal"}]},{"type":"block","id":"gjBC-D5xL8FkuGpaDSdLe","margin":"","level":2,"name":"head","location":{"start":{"line":102,"column":1,"offset":3566},"end":{"line":102,"column":11,"offset":3576}},"content":["Support"]},{"type":"para","id":"lXWpcL2HXdS99SmA6zzHE","margin":"","location":{"start":{"line":104,"column":1,"offset":3578},"end":{"line":104,"column":47,"offset":3624}},"text":"text","content":["Suggestions/patches are welcomed via github at"]},{"type":"para","id":"TnJpVbxwJ6lQiwDfWu3uC","margin":"","location":{"start":{"line":106,"column":1,"offset":3626},"end":{"line":106,"column":53,"offset":3678}},"text":"text","content":[{"meta":"https://github.com/jonathanstowe/JSON-Marshal/issues","type":"fcode","name":"L","content":["https://github.com/jonathanstowe/JSON-Marshal/issues"]}]},{"type":"block","id":"RzpNVsS4wGqVe7cFpfVdZ","margin":"","level":2,"name":"head","location":{"start":{"line":108,"column":1,"offset":3680},"end":{"line":108,"column":11,"offset":3690}},"content":["Licence"]},{"type":"para","id":"-Mes2o5LskxO6gGQFJTqa","margin":"","location":{"start":{"line":110,"column":1,"offset":3692},"end":{"line":110,"column":59,"offset":3750}},"text":"text","content":["Please see the ",{"meta":"LICENCE","type":"fcode","name":"L","content":["LICENCE"]}," file in the distribution"]},{"type":"para","id":"rlMCcEddUToPmUlssWstk","margin":"","location":{"start":{"line":112,"column":1,"offset":3752},"end":{"line":112,"column":58,"offset":3809}},"text":"text","content":["© Jonathan Stowe 2015, 2016, 2017, 2018, 2019, 2020, 2021"]}]},"publishUrl":"/mods/zef/JSON::Marshal/JSON-Marshal-0.0.24/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"1.0","auth":"zef:jonathanstowe","author":"Jonathan Stowe <jns+git@gellyfish.co.uk>","authors":["Jonathan Stowe <jns+git@gellyfish.co.uk>"],"build-depends":[],"depends":["JSON::Fast:ver<0.16+>","JSON::Name:ver<0.0.6+>","JSON::OptIn"],"description":"Simple serialisation of objects to JSON","dist":"JSON::Marshal:ver<0.0.24>:auth<zef:jonathanstowe>","license":"Artistic-2.0","meta-version":"1","name":"JSON::Marshal","path":"J/SO/JSON_MARSHAL/bd503b57c9cff4706f3a3e18390157a2a353536e.tar.gz","provides":{"JSON::Marshal":"lib/JSON/Marshal.rakumod"},"raku":"6.*","resources":[],"source-url":"https://github.com/jonathanstowe/JSON-Marshal.git","support":{"bugtracker":"https://github.com/jonathanstowe/JSON-Marshal/issues","email":"jns+git@gellyfish.co.uk","source":"https://github.com/jonathanstowe/JSON-Marshal.git"},"tags":["object","serialisation","JSON"],"test-depends":["Test","JSON::Fast:ver<0.16+>"],"version":"0.0.24"},"files":[{"file":"work_mods/zef/JSON::Marshal/JSON-Marshal-0.0.24/README.md","publishUrl":"/mods/zef/JSON::Marshal/JSON-Marshal-0.0.24/README.md"},{"file":"work_mods/zef/JSON::Marshal/JSON-Marshal-0.0.24/lib/JSON/Marshal.rakumod","publishUrl":"/mods/zef/JSON::Marshal/JSON-Marshal-0.0.24/lib/JSON/Marshal.rakumod"}],"src":"zef","url":"/mods/zef/JSON::Marshal"}}}
    =end data
    =end React


Simple serialisation of objects to JSON


JSON::Marshal


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


JSON::Name

JSON::Name

image https://github.com/jonathanstowe/JSON-Name/workflows/CI/badge.svg not found

Synopsis

Description

Installation

Support

Licence

JSON::Name v0.0.7

Authors

License

Dependencies

Test Dependencies

Provides

Documentation