TITLE

Fast JSON parsing using bindings to C++ and simdjson


SUBTITLE

data

=begin data
{"type":"page","file":"work_mods/zef/JSON-Simd/JSON-Simd/README.md","sources":[],"node":{"type":"block","id":"ohGjnQxEON6vYgARw7wfB","margin":"","name":"root","content":[{"type":"block","id":"M5lEZ9YD-RIhROaldGkHw","margin":"","level":1,"name":"head","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":13,"offset":12}},"content":["JSON::Simd"]},{"type":"para","id":"P1QZHNXrokL00vaposesx","margin":"","location":{"start":{"line":3,"column":1,"offset":14},"end":{"line":6,"column":95,"offset":366}},"text":"text","content":["Parsing JSON as fast as possible in Raku using ",{"meta":"https://github.com/simdjson/simdjson","type":"fcode","name":"L","content":["simdjson"]},".\nThis library is around 3.3x faster than ",{"meta":"https://github.com/moritz/json","type":"fcode","name":"L","content":["JSON::Tiny"]}," and\nabout on par with ",{"meta":"https://github.com/timo/json_fast","type":"fcode","name":"L","content":["JSON::Fast"]},", but,\nas time goes on I think this dist should perform better (once I get around to using more nqp)."]},{"type":"block","id":"qeOBz2yo9O_ZuLgxbGa18","margin":"","level":2,"name":"head","location":{"start":{"line":8,"column":1,"offset":368},"end":{"line":8,"column":18,"offset":385}},"content":["How to install"]},{"type":"block","id":"GlzSVRzPPpipuariYS-Ka","margin":"","level":4,"name":"head","location":{"start":{"line":10,"column":1,"offset":387},"end":{"line":10,"column":20,"offset":406}},"content":["Latest nightly"]},{"type":"block","id":"dHA_fCVBVnKZMMG9Lcsj6","margin":"","name":"code","config":[{"name":"lang","value":"bash","type":"string"}],"location":{"start":{"line":12,"column":1,"offset":408},"end":{"line":14,"column":4,"offset":480}},"content":[{"type":"verbatim","value":"zef install -v https://github.com/rawleyfowler/JSON-Simd.git"}]},{"type":"block","id":"VanjqsCmCNR4fglvMwY2O","margin":"","level":4,"name":"head","location":{"start":{"line":16,"column":1,"offset":482},"end":{"line":16,"column":19,"offset":500}},"content":["Latest stable"]},{"type":"block","id":"3U2hITYgVr4a15lKQ6WwM","margin":"","name":"code","config":[{"name":"lang","value":"bash","type":"string"}],"location":{"start":{"line":18,"column":1,"offset":502},"end":{"line":20,"column":4,"offset":535}},"content":[{"type":"verbatim","value":"zef install JSON-Simd"}]},{"type":"block","id":"pQurjQIjs4_N2FmdzTdok","margin":"","level":2,"name":"head","location":{"start":{"line":22,"column":1,"offset":537},"end":{"line":22,"column":14,"offset":550}},"content":["How to use"]},{"type":"para","id":"H9cvbViInThNPr8QL5A6A","margin":"","location":{"start":{"line":24,"column":1,"offset":552},"end":{"line":24,"column":31,"offset":582}},"text":"text","content":["Simply provide any JSON string"]},{"type":"block","id":"UExeLLtktZOBZiR0--IHj","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":26,"column":1,"offset":584},"end":{"line":31,"column":4,"offset":722}},"content":[{"type":"verbatim","value":"use JSON::Simd;\n\nmy @users = JSON::Simd::parse('[ { \"name\": \"bob\" }, { \"name\": \"kenny\" } ]');\n@users[0].say; # { name => bob }"}]},{"type":"block","id":"ZPjcHJLWPbczWYIy1utJw","margin":"","level":2,"name":"head","location":{"start":{"line":33,"column":1,"offset":724},"end":{"line":33,"column":11,"offset":734}},"content":["License"]},{"type":"para","id":"yNYNoV4m0Dp9Dv0qoaOUG","margin":"","location":{"start":{"line":35,"column":1,"offset":736},"end":{"line":36,"column":188,"offset":1013}},"text":"text","content":["This project is bundled along-side ",{"meta":"https://github.com/simdjson/simdjson","type":"fcode","name":"L","content":["simdjson"]}," which\nis provided under the Apache-2.0 License. That includes all directories under ",{"type":"fcode","name":"C","content":["cc/lib/simdjson"]},". The rest of the code is provided under the Artistic-2.0 License, the same license as Raku."]}]},"publishUrl":"/mods/zef/JSON-Simd/JSON-Simd/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"","auth":"zef:rawleyfowler","authors":["Rawley Fowler"],"build":{"lib":"simd-json","src-dir":"cc"},"build-depends":["Distribution::Builder::Cmake"],"builder":"Distribution::Builder::Cmake","depends":[],"description":"Fast JSON parsing using bindings to C++ and simdjson","dist":"JSON-Simd:ver<0.0.1>:auth<zef:rawleyfowler>","license":"Artistic-2.0","name":"JSON-Simd","path":"J/SO/JSONSIMD/9226782470981ad3b84cef670b6a393765dbb8c7.tar.gz","perl":"6.d","provides":{"JSON::Simd":"lib/Json/Simd.rakumod"},"resources":["libraries/simd-json"],"source-url":"https://github.com/rawleyfowler/JSON-Simd","tags":["JSON","simdjson"],"test-depends":["Test"],"version":"0.0.1"},"files":[{"file":"work_mods/zef/JSON-Simd/JSON-Simd/README.md","publishUrl":"/mods/zef/JSON-Simd/JSON-Simd/README.md"}],"src":"zef","url":"/mods/zef/JSON-Simd"}}}
=end data


React

    =begin React :component<RenderItem>
    =begin data
    {"type":"page","file":"work_mods/zef/JSON-Simd/JSON-Simd/README.md","sources":[],"node":{"type":"block","id":"ohGjnQxEON6vYgARw7wfB","margin":"","name":"root","content":[{"type":"block","id":"M5lEZ9YD-RIhROaldGkHw","margin":"","level":1,"name":"head","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":13,"offset":12}},"content":["JSON::Simd"]},{"type":"para","id":"P1QZHNXrokL00vaposesx","margin":"","location":{"start":{"line":3,"column":1,"offset":14},"end":{"line":6,"column":95,"offset":366}},"text":"text","content":["Parsing JSON as fast as possible in Raku using ",{"meta":"https://github.com/simdjson/simdjson","type":"fcode","name":"L","content":["simdjson"]},".\nThis library is around 3.3x faster than ",{"meta":"https://github.com/moritz/json","type":"fcode","name":"L","content":["JSON::Tiny"]}," and\nabout on par with ",{"meta":"https://github.com/timo/json_fast","type":"fcode","name":"L","content":["JSON::Fast"]},", but,\nas time goes on I think this dist should perform better (once I get around to using more nqp)."]},{"type":"block","id":"qeOBz2yo9O_ZuLgxbGa18","margin":"","level":2,"name":"head","location":{"start":{"line":8,"column":1,"offset":368},"end":{"line":8,"column":18,"offset":385}},"content":["How to install"]},{"type":"block","id":"GlzSVRzPPpipuariYS-Ka","margin":"","level":4,"name":"head","location":{"start":{"line":10,"column":1,"offset":387},"end":{"line":10,"column":20,"offset":406}},"content":["Latest nightly"]},{"type":"block","id":"dHA_fCVBVnKZMMG9Lcsj6","margin":"","name":"code","config":[{"name":"lang","value":"bash","type":"string"}],"location":{"start":{"line":12,"column":1,"offset":408},"end":{"line":14,"column":4,"offset":480}},"content":[{"type":"verbatim","value":"zef install -v https://github.com/rawleyfowler/JSON-Simd.git"}]},{"type":"block","id":"VanjqsCmCNR4fglvMwY2O","margin":"","level":4,"name":"head","location":{"start":{"line":16,"column":1,"offset":482},"end":{"line":16,"column":19,"offset":500}},"content":["Latest stable"]},{"type":"block","id":"3U2hITYgVr4a15lKQ6WwM","margin":"","name":"code","config":[{"name":"lang","value":"bash","type":"string"}],"location":{"start":{"line":18,"column":1,"offset":502},"end":{"line":20,"column":4,"offset":535}},"content":[{"type":"verbatim","value":"zef install JSON-Simd"}]},{"type":"block","id":"pQurjQIjs4_N2FmdzTdok","margin":"","level":2,"name":"head","location":{"start":{"line":22,"column":1,"offset":537},"end":{"line":22,"column":14,"offset":550}},"content":["How to use"]},{"type":"para","id":"H9cvbViInThNPr8QL5A6A","margin":"","location":{"start":{"line":24,"column":1,"offset":552},"end":{"line":24,"column":31,"offset":582}},"text":"text","content":["Simply provide any JSON string"]},{"type":"block","id":"UExeLLtktZOBZiR0--IHj","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":26,"column":1,"offset":584},"end":{"line":31,"column":4,"offset":722}},"content":[{"type":"verbatim","value":"use JSON::Simd;\n\nmy @users = JSON::Simd::parse('[ { \"name\": \"bob\" }, { \"name\": \"kenny\" } ]');\n@users[0].say; # { name => bob }"}]},{"type":"block","id":"ZPjcHJLWPbczWYIy1utJw","margin":"","level":2,"name":"head","location":{"start":{"line":33,"column":1,"offset":724},"end":{"line":33,"column":11,"offset":734}},"content":["License"]},{"type":"para","id":"yNYNoV4m0Dp9Dv0qoaOUG","margin":"","location":{"start":{"line":35,"column":1,"offset":736},"end":{"line":36,"column":188,"offset":1013}},"text":"text","content":["This project is bundled along-side ",{"meta":"https://github.com/simdjson/simdjson","type":"fcode","name":"L","content":["simdjson"]}," which\nis provided under the Apache-2.0 License. That includes all directories under ",{"type":"fcode","name":"C","content":["cc/lib/simdjson"]},". The rest of the code is provided under the Artistic-2.0 License, the same license as Raku."]}]},"publishUrl":"/mods/zef/JSON-Simd/JSON-Simd/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"","auth":"zef:rawleyfowler","authors":["Rawley Fowler"],"build":{"lib":"simd-json","src-dir":"cc"},"build-depends":["Distribution::Builder::Cmake"],"builder":"Distribution::Builder::Cmake","depends":[],"description":"Fast JSON parsing using bindings to C++ and simdjson","dist":"JSON-Simd:ver<0.0.1>:auth<zef:rawleyfowler>","license":"Artistic-2.0","name":"JSON-Simd","path":"J/SO/JSONSIMD/9226782470981ad3b84cef670b6a393765dbb8c7.tar.gz","perl":"6.d","provides":{"JSON::Simd":"lib/Json/Simd.rakumod"},"resources":["libraries/simd-json"],"source-url":"https://github.com/rawleyfowler/JSON-Simd","tags":["JSON","simdjson"],"test-depends":["Test"],"version":"0.0.1"},"files":[{"file":"work_mods/zef/JSON-Simd/JSON-Simd/README.md","publishUrl":"/mods/zef/JSON-Simd/JSON-Simd/README.md"}],"src":"zef","url":"/mods/zef/JSON-Simd"}}}
    =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-Simd


role to provide simple serialisation/deserialisation of objects to/from JSON


=begin data
{"type":"page","file":"work_mods/zef/JSON::Class/JSON-Class-0.0.19/README.md","sources":[],"node":{"type":"block","id":"6smtoD3V2fcr3G_trx8WJ","margin":"","name":"root","content":[{"type":"block","id":"UZjPgd9aiVIpHWwehfoFb","margin":"","level":1,"name":"head","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":14,"offset":13}},"content":["JSON::Class"]},{"type":"para","id":"qAYaOEdTZY2eWuewLFWKT","margin":"","location":{"start":{"line":3,"column":1,"offset":15},"end":{"line":3,"column":76,"offset":90}},"text":"text","content":["A Role to allow Raku objects to be constructed and serialised from/to JSON."]},{"type":"para","id":"Om5d9KeDxqTfHv-ofkGgJ","margin":"","location":{"start":{"line":5,"column":1,"offset":92},"end":{"line":5,"column":84,"offset":175}},"text":"text","content":[{"type":"block","id":"jr1YYTB3CIVGzeXKKMMnx","margin":"","name":"Image","config":[],"location":{"start":{"line":5,"column":1,"offset":92},"end":{"line":5,"column":84,"offset":175}},"content":[{"type":"image","src":"https://github.com/jonathanstowe/JSON-Class/workflows/CI/badge.svg","alt":"Build Status"}]}]},{"type":"block","id":"POTlyGY7tBG6DZxfs2BaR","margin":"","level":2,"name":"head","location":{"start":{"line":7,"column":1,"offset":177},"end":{"line":7,"column":12,"offset":188}},"content":["Synopsis"]},{"type":"block","id":"DnlcCXZReoEad0cpavzLQ","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":9,"column":1,"offset":190},"end":{"line":25,"column":4,"offset":448}},"content":[{"type":"verbatim","value":"\n    use JSON::Class;\n\n    class Something does JSON::Class {\n\n        has Str $.foo;\n\n    }\n\n    my Something $something = Something.from-json('{ \"foo\" : \"stuff\" }');\n\n    ...\n\n    my Str $json = $something.to-json(); # -> '{ \"foo\" : \"stuff\" }'\n"}]},{"type":"para","id":"2Ad7XumrzWiwOyTKmQvZL","margin":"","location":{"start":{"line":27,"column":1,"offset":450},"end":{"line":27,"column":32,"offset":481}},"text":"text","content":["or with 'opt-in' serialization:"]},{"type":"block","id":"7l-WbKdGnumnLKY2n0FPU","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":29,"column":1,"offset":483},"end":{"line":47,"column":4,"offset":816}},"content":[{"type":"verbatim","value":"\n    use JSON::Class;\n    use JSON::OptIn;\n\n    class Something does JSON::Class[:opt-in] {\n\n        has Str $.foo is json;\n        has Str $.secret = 'secret';\n\n    }\n\n    my Something $something = Something.from-json('{ \"foo\" : \"stuff\" }');\n\n    ...\n\n    my Str $json = $something.to-json(); # -> '{ \"foo\" : \"stuff\" }'\n"}]},{"type":"block","id":"rBmb2Gt0bQHMwfNC33yWd","margin":"","level":2,"name":"head","location":{"start":{"line":49,"column":1,"offset":818},"end":{"line":49,"column":15,"offset":832}},"content":["Description"]},{"type":"para","id":"gxUgM5iGDcqk-0FXpf1DM","margin":"","location":{"start":{"line":51,"column":1,"offset":834},"end":{"line":58,"column":74,"offset":1426}},"text":"text","content":["This is a simple role that provides methods to instantiate a class from a\nJSON string that (hopefully,) represents it, and to serialise an object of\nthe class to a JSON string. The JSON created from an instance should\nround trip to a new instance with the same values for the \"public attributes\".\n\"Private\" attributes (that is ones without accessors,) will be ignored for\nboth serialisation and de-serialisation. The exact behaviour depends on that\nof ",{"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"]}," respectively."]},{"type":"para","id":"DjaqkIHdhS8cfJnpxXJVj","margin":"","location":{"start":{"line":60,"column":1,"offset":1428},"end":{"line":65,"column":25,"offset":1788}},"text":"text","content":["If the ",{"type":"fcode","name":"C","content":[":skip-null"]}," adverb is provided to ",{"type":"fcode","name":"C","content":["to-json"]}," all attributes\nwithout a defined value will be ignored in serialisation. If you need\nfiner grained control then you should apply the ",{"type":"fcode","name":"C","content":["json-skip-null"]},"\nattribute trait (defined by ",{"type":"fcode","name":"C","content":["JSON::Marshal"]}," ) to the attributes you\nwant to skip if they aren't defined (",{"type":"fcode","name":"C","content":[":skip-null"]}," will still have\nthe same effect though.)"]},{"type":"para","id":"p8DDPJU3Bv00aCMF6dW1i","margin":"","location":{"start":{"line":67,"column":1,"offset":1790},"end":{"line":68,"column":36,"offset":1902}},"text":"text","content":["If you don't need prettified, human readable JSON output then you can supply\nthe ",{"type":"fcode","name":"C","content":[":!pretty"]}," adverb to ",{"type":"fcode","name":"C","content":["to-json"]},"."]},{"type":"para","id":"diSxXY_pXW-nDkYd1iQ4C","margin":"","location":{"start":{"line":70,"column":1,"offset":1904},"end":{"line":73,"column":27,"offset":2155}},"text":"text","content":["The ",{"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"]}," provide traits\nfor controlling the unmarshalling/marshalling of specific attributes which are\nre-exported by the module."]},{"type":"para","id":"Yq-w4lBtDsWvmcRGkUdTz","margin":"","location":{"start":{"line":75,"column":1,"offset":2157},"end":{"line":79,"column":64,"offset":2538}},"text":"text","content":["If your application exposes the marshalled data via, for example, an API, then\nyou may choose to use the ",{"type":"fcode","name":"C","content":[":opt-in"]}," parameter to the role, which will cause only\nthose attributes that are explicitly marked to be marshalled, avoiding the risk\nof inadvertently exposing sensitive data. This is described in more detail in\n",{"meta":"https://github.com/jonathanstowe/JSON-Marshal","type":"fcode","name":"L","content":["JSON::Marshal"]},"."]},{"type":"block","id":"SoOqbFIvA4x4cOEgPHFz0","margin":"","level":2,"name":"head","location":{"start":{"line":81,"column":1,"offset":2540},"end":{"line":81,"column":16,"offset":2555}},"content":["Installation"]},{"type":"para","id":"AZsMlsp-x8ZhvAmAZK8w-","margin":"","location":{"start":{"line":83,"column":1,"offset":2557},"end":{"line":83,"column":96,"offset":2652}},"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":"GDGF26IHvVrz0gPPjSCHr","margin":"","name":"code","config":[],"location":{"start":{"line":85,"column":1,"offset":2654},"end":{"line":91,"column":28,"offset":2760}},"content":[{"type":"verbatim","value":"# From the source directory\n\nzef install .\n\n# Remote installation\n\nzef install JSON::Class"}]},{"type":"block","id":"uMJLyabci0pALD09FrDT0","margin":"","level":2,"name":"head","location":{"start":{"line":93,"column":1,"offset":2762},"end":{"line":93,"column":11,"offset":2772}},"content":["Support"]},{"type":"para","id":"hZF15Yk6DwoCwXBjkiYhe","margin":"","location":{"start":{"line":95,"column":1,"offset":2774},"end":{"line":95,"column":48,"offset":2821}},"text":"text","content":["Suggestions/patches are welcomed via github at:"]},{"type":"para","id":"dc96PdxDhcqe7HRC2-A-r","margin":"","location":{"start":{"line":97,"column":1,"offset":2823},"end":{"line":97,"column":44,"offset":2866}},"text":"text","content":[{"meta":"https://github.com/jonathanstowe/JSON-Class","type":"fcode","name":"L","content":["https://github.com/jonathanstowe/JSON-Class"]}]},{"type":"block","id":"P55SJAKxa2wQQF_R4j690","margin":"","level":2,"name":"head","location":{"start":{"line":99,"column":1,"offset":2868},"end":{"line":99,"column":11,"offset":2878}},"content":["Licence"]},{"type":"para","id":"u-xpZdxxzwbojm7ScWEoX","margin":"","location":{"start":{"line":101,"column":1,"offset":2880},"end":{"line":101,"column":23,"offset":2902}},"text":"text","content":["This is free software."]},{"type":"para","id":"lbKJ8BOWbSUMbOOqUutPr","margin":"","location":{"start":{"line":103,"column":1,"offset":2904},"end":{"line":103,"column":76,"offset":2979}},"text":"text","content":["Please see the (LICENCE)[LICENCE] file in the distribution for the details."]},{"type":"para","id":"TxDQ0D0vcxwZ90R8zZdKJ","margin":"","location":{"start":{"line":105,"column":1,"offset":2981},"end":{"line":105,"column":52,"offset":3032}},"text":"text","content":["© Jonathan Stowe 2015, 2016, 2017, 2019, 2020, 2021"]}]},"publishUrl":"/mods/zef/JSON::Class/JSON-Class-0.0.19/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::Marshal:ver<0.0.23+>","JSON::Unmarshal:ver<0.08+>","JSON::OptIn","JSON::Name:ver<0.0.6+>"],"description":"role to provide simple serialisation/deserialisation of objects to/from JSON","dist":"JSON::Class:ver<0.0.19>:auth<zef:jonathanstowe>","license":"Artistic-2.0","meta-version":"1","name":"JSON::Class","path":"J/SO/JSON_CLASS/c61e50e245193725172081e56bb59a350a8a2b22.tar.gz","provides":{"JSON::Class":"lib/JSON/Class.rakumod"},"raku":"6.*","resources":[],"source-url":"https://github.com/jonathanstowe/JSON-Class.git","support":{"bugtracker":"https://github.com/jonathanstowe/JSON-Class/issues","source":"https://github.com/jonathanstowe/JSON-Class.git"},"tags":["object","serialisation","JSON"],"test-depends":["JSON::Fast","Test"],"version":"0.0.19"},"files":[{"file":"work_mods/zef/JSON::Class/JSON-Class-0.0.19/README.md","publishUrl":"/mods/zef/JSON::Class/JSON-Class-0.0.19/README.md"},{"file":"work_mods/zef/JSON::Class/JSON-Class-0.0.19/lib/JSON/Class.rakumod","publishUrl":"/mods/zef/JSON::Class/JSON-Class-0.0.19/lib/JSON/Class.rakumod"}],"src":"zef","url":"/mods/zef/JSON::Class"}}}
=end data


    =begin React :component<RenderItem>
    =begin data
    {"type":"page","file":"work_mods/zef/JSON::Class/JSON-Class-0.0.19/README.md","sources":[],"node":{"type":"block","id":"6smtoD3V2fcr3G_trx8WJ","margin":"","name":"root","content":[{"type":"block","id":"UZjPgd9aiVIpHWwehfoFb","margin":"","level":1,"name":"head","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":14,"offset":13}},"content":["JSON::Class"]},{"type":"para","id":"qAYaOEdTZY2eWuewLFWKT","margin":"","location":{"start":{"line":3,"column":1,"offset":15},"end":{"line":3,"column":76,"offset":90}},"text":"text","content":["A Role to allow Raku objects to be constructed and serialised from/to JSON."]},{"type":"para","id":"Om5d9KeDxqTfHv-ofkGgJ","margin":"","location":{"start":{"line":5,"column":1,"offset":92},"end":{"line":5,"column":84,"offset":175}},"text":"text","content":[{"type":"block","id":"jr1YYTB3CIVGzeXKKMMnx","margin":"","name":"Image","config":[],"location":{"start":{"line":5,"column":1,"offset":92},"end":{"line":5,"column":84,"offset":175}},"content":[{"type":"image","src":"https://github.com/jonathanstowe/JSON-Class/workflows/CI/badge.svg","alt":"Build Status"}]}]},{"type":"block","id":"POTlyGY7tBG6DZxfs2BaR","margin":"","level":2,"name":"head","location":{"start":{"line":7,"column":1,"offset":177},"end":{"line":7,"column":12,"offset":188}},"content":["Synopsis"]},{"type":"block","id":"DnlcCXZReoEad0cpavzLQ","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":9,"column":1,"offset":190},"end":{"line":25,"column":4,"offset":448}},"content":[{"type":"verbatim","value":"\n    use JSON::Class;\n\n    class Something does JSON::Class {\n\n        has Str $.foo;\n\n    }\n\n    my Something $something = Something.from-json('{ \"foo\" : \"stuff\" }');\n\n    ...\n\n    my Str $json = $something.to-json(); # -> '{ \"foo\" : \"stuff\" }'\n"}]},{"type":"para","id":"2Ad7XumrzWiwOyTKmQvZL","margin":"","location":{"start":{"line":27,"column":1,"offset":450},"end":{"line":27,"column":32,"offset":481}},"text":"text","content":["or with 'opt-in' serialization:"]},{"type":"block","id":"7l-WbKdGnumnLKY2n0FPU","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":29,"column":1,"offset":483},"end":{"line":47,"column":4,"offset":816}},"content":[{"type":"verbatim","value":"\n    use JSON::Class;\n    use JSON::OptIn;\n\n    class Something does JSON::Class[:opt-in] {\n\n        has Str $.foo is json;\n        has Str $.secret = 'secret';\n\n    }\n\n    my Something $something = Something.from-json('{ \"foo\" : \"stuff\" }');\n\n    ...\n\n    my Str $json = $something.to-json(); # -> '{ \"foo\" : \"stuff\" }'\n"}]},{"type":"block","id":"rBmb2Gt0bQHMwfNC33yWd","margin":"","level":2,"name":"head","location":{"start":{"line":49,"column":1,"offset":818},"end":{"line":49,"column":15,"offset":832}},"content":["Description"]},{"type":"para","id":"gxUgM5iGDcqk-0FXpf1DM","margin":"","location":{"start":{"line":51,"column":1,"offset":834},"end":{"line":58,"column":74,"offset":1426}},"text":"text","content":["This is a simple role that provides methods to instantiate a class from a\nJSON string that (hopefully,) represents it, and to serialise an object of\nthe class to a JSON string. The JSON created from an instance should\nround trip to a new instance with the same values for the \"public attributes\".\n\"Private\" attributes (that is ones without accessors,) will be ignored for\nboth serialisation and de-serialisation. The exact behaviour depends on that\nof ",{"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"]}," respectively."]},{"type":"para","id":"DjaqkIHdhS8cfJnpxXJVj","margin":"","location":{"start":{"line":60,"column":1,"offset":1428},"end":{"line":65,"column":25,"offset":1788}},"text":"text","content":["If the ",{"type":"fcode","name":"C","content":[":skip-null"]}," adverb is provided to ",{"type":"fcode","name":"C","content":["to-json"]}," all attributes\nwithout a defined value will be ignored in serialisation. If you need\nfiner grained control then you should apply the ",{"type":"fcode","name":"C","content":["json-skip-null"]},"\nattribute trait (defined by ",{"type":"fcode","name":"C","content":["JSON::Marshal"]}," ) to the attributes you\nwant to skip if they aren't defined (",{"type":"fcode","name":"C","content":[":skip-null"]}," will still have\nthe same effect though.)"]},{"type":"para","id":"p8DDPJU3Bv00aCMF6dW1i","margin":"","location":{"start":{"line":67,"column":1,"offset":1790},"end":{"line":68,"column":36,"offset":1902}},"text":"text","content":["If you don't need prettified, human readable JSON output then you can supply\nthe ",{"type":"fcode","name":"C","content":[":!pretty"]}," adverb to ",{"type":"fcode","name":"C","content":["to-json"]},"."]},{"type":"para","id":"diSxXY_pXW-nDkYd1iQ4C","margin":"","location":{"start":{"line":70,"column":1,"offset":1904},"end":{"line":73,"column":27,"offset":2155}},"text":"text","content":["The ",{"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"]}," provide traits\nfor controlling the unmarshalling/marshalling of specific attributes which are\nre-exported by the module."]},{"type":"para","id":"Yq-w4lBtDsWvmcRGkUdTz","margin":"","location":{"start":{"line":75,"column":1,"offset":2157},"end":{"line":79,"column":64,"offset":2538}},"text":"text","content":["If your application exposes the marshalled data via, for example, an API, then\nyou may choose to use the ",{"type":"fcode","name":"C","content":[":opt-in"]}," parameter to the role, which will cause only\nthose attributes that are explicitly marked to be marshalled, avoiding the risk\nof inadvertently exposing sensitive data. This is described in more detail in\n",{"meta":"https://github.com/jonathanstowe/JSON-Marshal","type":"fcode","name":"L","content":["JSON::Marshal"]},"."]},{"type":"block","id":"SoOqbFIvA4x4cOEgPHFz0","margin":"","level":2,"name":"head","location":{"start":{"line":81,"column":1,"offset":2540},"end":{"line":81,"column":16,"offset":2555}},"content":["Installation"]},{"type":"para","id":"AZsMlsp-x8ZhvAmAZK8w-","margin":"","location":{"start":{"line":83,"column":1,"offset":2557},"end":{"line":83,"column":96,"offset":2652}},"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":"GDGF26IHvVrz0gPPjSCHr","margin":"","name":"code","config":[],"location":{"start":{"line":85,"column":1,"offset":2654},"end":{"line":91,"column":28,"offset":2760}},"content":[{"type":"verbatim","value":"# From the source directory\n\nzef install .\n\n# Remote installation\n\nzef install JSON::Class"}]},{"type":"block","id":"uMJLyabci0pALD09FrDT0","margin":"","level":2,"name":"head","location":{"start":{"line":93,"column":1,"offset":2762},"end":{"line":93,"column":11,"offset":2772}},"content":["Support"]},{"type":"para","id":"hZF15Yk6DwoCwXBjkiYhe","margin":"","location":{"start":{"line":95,"column":1,"offset":2774},"end":{"line":95,"column":48,"offset":2821}},"text":"text","content":["Suggestions/patches are welcomed via github at:"]},{"type":"para","id":"dc96PdxDhcqe7HRC2-A-r","margin":"","location":{"start":{"line":97,"column":1,"offset":2823},"end":{"line":97,"column":44,"offset":2866}},"text":"text","content":[{"meta":"https://github.com/jonathanstowe/JSON-Class","type":"fcode","name":"L","content":["https://github.com/jonathanstowe/JSON-Class"]}]},{"type":"block","id":"P55SJAKxa2wQQF_R4j690","margin":"","level":2,"name":"head","location":{"start":{"line":99,"column":1,"offset":2868},"end":{"line":99,"column":11,"offset":2878}},"content":["Licence"]},{"type":"para","id":"u-xpZdxxzwbojm7ScWEoX","margin":"","location":{"start":{"line":101,"column":1,"offset":2880},"end":{"line":101,"column":23,"offset":2902}},"text":"text","content":["This is free software."]},{"type":"para","id":"lbKJ8BOWbSUMbOOqUutPr","margin":"","location":{"start":{"line":103,"column":1,"offset":2904},"end":{"line":103,"column":76,"offset":2979}},"text":"text","content":["Please see the (LICENCE)[LICENCE] file in the distribution for the details."]},{"type":"para","id":"TxDQ0D0vcxwZ90R8zZdKJ","margin":"","location":{"start":{"line":105,"column":1,"offset":2981},"end":{"line":105,"column":52,"offset":3032}},"text":"text","content":["© Jonathan Stowe 2015, 2016, 2017, 2019, 2020, 2021"]}]},"publishUrl":"/mods/zef/JSON::Class/JSON-Class-0.0.19/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::Marshal:ver<0.0.23+>","JSON::Unmarshal:ver<0.08+>","JSON::OptIn","JSON::Name:ver<0.0.6+>"],"description":"role to provide simple serialisation/deserialisation of objects to/from JSON","dist":"JSON::Class:ver<0.0.19>:auth<zef:jonathanstowe>","license":"Artistic-2.0","meta-version":"1","name":"JSON::Class","path":"J/SO/JSON_CLASS/c61e50e245193725172081e56bb59a350a8a2b22.tar.gz","provides":{"JSON::Class":"lib/JSON/Class.rakumod"},"raku":"6.*","resources":[],"source-url":"https://github.com/jonathanstowe/JSON-Class.git","support":{"bugtracker":"https://github.com/jonathanstowe/JSON-Class/issues","source":"https://github.com/jonathanstowe/JSON-Class.git"},"tags":["object","serialisation","JSON"],"test-depends":["JSON::Fast","Test"],"version":"0.0.19"},"files":[{"file":"work_mods/zef/JSON::Class/JSON-Class-0.0.19/README.md","publishUrl":"/mods/zef/JSON::Class/JSON-Class-0.0.19/README.md"},{"file":"work_mods/zef/JSON::Class/JSON-Class-0.0.19/lib/JSON/Class.rakumod","publishUrl":"/mods/zef/JSON::Class/JSON-Class-0.0.19/lib/JSON/Class.rakumod"}],"src":"zef","url":"/mods/zef/JSON::Class"}}}
    =end data
    =end React


JSON::Class


Provides scripts to convert between CSV and JSON.


=begin data
{"type":"page","file":"work_mods/zef/JSON-CSV/dist/README.md","sources":[],"node":{"type":"block","id":"0hJyeN84Nu9JGjTpu9_gK","margin":"","name":"root","content":[{"type":"para","id":"Y9M8ZVgJYIMEcCOcYx_gQ","margin":"","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":13,"offset":12}},"text":"text","content":[{"type":"fcode","name":"B","content":["JSON-CSV"]}]},{"type":"para","id":"TM02-z2SM8S1ej7YgWb9X","margin":"","location":{"start":{"line":3,"column":1,"offset":14},"end":{"line":4,"column":66,"offset":161}},"text":"text","content":["This repository is for a collection of scripts that convert between JSON and CSV.\nWritten in Raku as a small project to help me learn the language."]},{"type":"list","id":"rK66VqE6i7D32poHC21fO","margin":"","level":1,"list":"itemized","content":[{"type":"block","id":"tPY5FB5qhttWwqFnZA35y","margin":"","name":"item","level":1,"location":{"start":{"line":6,"column":1,"offset":163},"end":{"line":6,"column":15,"offset":177}},"content":[{"type":"para","id":"dK2qqsKzb9vHIlmuNdPhW","margin":"","location":{"start":{"line":6,"column":3,"offset":165},"end":{"line":6,"column":15,"offset":177}},"text":"text","content":["bin/json2csv"]}]},{"type":"block","id":"0e9ZWvIo1qSWxbYS8zTOx","margin":"","name":"item","level":1,"location":{"start":{"line":7,"column":1,"offset":178},"end":{"line":7,"column":15,"offset":192}},"content":[{"type":"para","id":"FfkKFa-ht4rzo7ku6prg2","margin":"","location":{"start":{"line":7,"column":3,"offset":180},"end":{"line":7,"column":15,"offset":192}},"text":"text","content":["bin/csv2json"]}]},{"type":"block","id":"BMnuQxO0slRsBoX6lkd3D","margin":"","name":"item","level":1,"location":{"start":{"line":8,"column":1,"offset":193},"end":{"line":8,"column":21,"offset":213}},"content":[{"type":"para","id":"O9BU584Bi6Yw3yNHLhUot","margin":"","location":{"start":{"line":8,"column":3,"offset":195},"end":{"line":8,"column":21,"offset":213}},"text":"text","content":["bin/jsonStream2csv"]}]}]},{"type":"para","id":"rh8N6OIL7bpMzbaYLFcov","margin":"","location":{"start":{"line":10,"column":1,"offset":215},"end":{"line":10,"column":143,"offset":357}},"text":"text","content":["The scripts depend on Text::CSV, JSON::Fast, and JSON::Stream. NOTE: Please feel free to contact me or suggest changes via the github project."]},{"type":"para","id":"WHOYzsHIpfPywIeiYdyzx","margin":"","location":{"start":{"line":12,"column":1,"offset":359},"end":{"line":12,"column":26,"offset":384}},"text":"text","content":[{"type":"fcode","name":"B","content":["COPYRIGHT and LICENSE"]}]},{"type":"para","id":"qUiAzsd30xhPtdE0nYMVv","margin":"","location":{"start":{"line":14,"column":1,"offset":386},"end":{"line":14,"column":61,"offset":446}},"text":"text","content":["© 2022 Scott Sotka. Licensed under the Artistic License 2.0."]}]},"publishUrl":"/mods/zef/JSON-CSV/dist/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"0","auth":"zef:ssotka","authors":["Scott Sotka"],"build-depends":[],"depends":["Text::CSV","JSON::Fast","JSON::Stream"],"description":"Provides scripts to convert between CSV and JSON.","dist":"JSON-CSV:ver<0.0.1>:auth<zef:ssotka>","license":"Artistic-2.0","name":"JSON-CSV","path":"J/SO/JSONCSV/bf87c09ce90556cd2441dd95881ddf9e803982a1.tar.gz","perl":"6.c","provides":{"csv2json":"bin/csv2json","json2csv":"bin/json2csv","jsonStream2csv":"bin/jsonStream2csv"},"resources":["SampleCSVFile_119kb.csv","SampleCSVFile_converted.json"],"source-url":"git://github.com/ssotka/json-csv.git","tags":["json","csv","conversion"],"test-depends":[],"version":"0.0.1"},"files":[{"file":"work_mods/zef/JSON-CSV/dist/README.md","publishUrl":"/mods/zef/JSON-CSV/dist/README.md"}],"src":"zef","url":"/mods/zef/JSON-CSV"}}}
=end data


    =begin React :component<RenderItem>
    =begin data
    {"type":"page","file":"work_mods/zef/JSON-CSV/dist/README.md","sources":[],"node":{"type":"block","id":"0hJyeN84Nu9JGjTpu9_gK","margin":"","name":"root","content":[{"type":"para","id":"Y9M8ZVgJYIMEcCOcYx_gQ","margin":"","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":13,"offset":12}},"text":"text","content":[{"type":"fcode","name":"B","content":["JSON-CSV"]}]},{"type":"para","id":"TM02-z2SM8S1ej7YgWb9X","margin":"","location":{"start":{"line":3,"column":1,"offset":14},"end":{"line":4,"column":66,"offset":161}},"text":"text","content":["This repository is for a collection of scripts that convert between JSON and CSV.\nWritten in Raku as a small project to help me learn the language."]},{"type":"list","id":"rK66VqE6i7D32poHC21fO","margin":"","level":1,"list":"itemized","content":[{"type":"block","id":"tPY5FB5qhttWwqFnZA35y","margin":"","name":"item","level":1,"location":{"start":{"line":6,"column":1,"offset":163},"end":{"line":6,"column":15,"offset":177}},"content":[{"type":"para","id":"dK2qqsKzb9vHIlmuNdPhW","margin":"","location":{"start":{"line":6,"column":3,"offset":165},"end":{"line":6,"column":15,"offset":177}},"text":"text","content":["bin/json2csv"]}]},{"type":"block","id":"0e9ZWvIo1qSWxbYS8zTOx","margin":"","name":"item","level":1,"location":{"start":{"line":7,"column":1,"offset":178},"end":{"line":7,"column":15,"offset":192}},"content":[{"type":"para","id":"FfkKFa-ht4rzo7ku6prg2","margin":"","location":{"start":{"line":7,"column":3,"offset":180},"end":{"line":7,"column":15,"offset":192}},"text":"text","content":["bin/csv2json"]}]},{"type":"block","id":"BMnuQxO0slRsBoX6lkd3D","margin":"","name":"item","level":1,"location":{"start":{"line":8,"column":1,"offset":193},"end":{"line":8,"column":21,"offset":213}},"content":[{"type":"para","id":"O9BU584Bi6Yw3yNHLhUot","margin":"","location":{"start":{"line":8,"column":3,"offset":195},"end":{"line":8,"column":21,"offset":213}},"text":"text","content":["bin/jsonStream2csv"]}]}]},{"type":"para","id":"rh8N6OIL7bpMzbaYLFcov","margin":"","location":{"start":{"line":10,"column":1,"offset":215},"end":{"line":10,"column":143,"offset":357}},"text":"text","content":["The scripts depend on Text::CSV, JSON::Fast, and JSON::Stream. NOTE: Please feel free to contact me or suggest changes via the github project."]},{"type":"para","id":"WHOYzsHIpfPywIeiYdyzx","margin":"","location":{"start":{"line":12,"column":1,"offset":359},"end":{"line":12,"column":26,"offset":384}},"text":"text","content":[{"type":"fcode","name":"B","content":["COPYRIGHT and LICENSE"]}]},{"type":"para","id":"qUiAzsd30xhPtdE0nYMVv","margin":"","location":{"start":{"line":14,"column":1,"offset":386},"end":{"line":14,"column":61,"offset":446}},"text":"text","content":["© 2022 Scott Sotka. Licensed under the Artistic License 2.0."]}]},"publishUrl":"/mods/zef/JSON-CSV/dist/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"0","auth":"zef:ssotka","authors":["Scott Sotka"],"build-depends":[],"depends":["Text::CSV","JSON::Fast","JSON::Stream"],"description":"Provides scripts to convert between CSV and JSON.","dist":"JSON-CSV:ver<0.0.1>:auth<zef:ssotka>","license":"Artistic-2.0","name":"JSON-CSV","path":"J/SO/JSONCSV/bf87c09ce90556cd2441dd95881ddf9e803982a1.tar.gz","perl":"6.c","provides":{"csv2json":"bin/csv2json","json2csv":"bin/json2csv","jsonStream2csv":"bin/jsonStream2csv"},"resources":["SampleCSVFile_119kb.csv","SampleCSVFile_converted.json"],"source-url":"git://github.com/ssotka/json-csv.git","tags":["json","csv","conversion"],"test-depends":[],"version":"0.0.1"},"files":[{"file":"work_mods/zef/JSON-CSV/dist/README.md","publishUrl":"/mods/zef/JSON-CSV/dist/README.md"}],"src":"zef","url":"/mods/zef/JSON-CSV"}}}
    =end data
    =end React


JSON-CSV


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-Simd

JSON::Simd

How to install

Latest nightly

Latest stable

How to use

License

JSON-Simd v0.0.1

Authors

License

Dependencies

Test Dependencies

Provides

Documentation