TITLE

jQuery-like node selecting and traversing for XML


SUBTITLE

data

=begin data
{"type":"page","file":"work_mods/zef/XML::Query/XML-Query-1.0/README.md","sources":[],"node":{"type":"block","id":"cy7lPy7C1T568_wP7xpCp","margin":"","name":"root","content":[{"type":"para","id":"kygii4qr3ShI2VlHXAVH9","margin":"","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":159,"offset":158}},"text":"text","content":[{"meta":"https://github.com/raku-community-modules/XML-Query/actions","type":"fcode","name":"L","content":[{"type":"block","id":"cGHnu7HCHjNQnn2Mq-efl","margin":"","name":"Image","config":[],"location":{"start":{"line":1,"column":2,"offset":1},"end":{"line":1,"column":97,"offset":96}},"content":[{"type":"image","src":"https://github.com/raku-community-modules/XML-Query/workflows/test/badge.svg","alt":"Actions Status"}]}]}]},{"type":"block","id":"lUF-ZpnZgVooZzJrenPub","margin":"","level":1,"name":"head","location":{"start":{"line":3,"column":1,"offset":160},"end":{"line":4,"column":5,"offset":169}},"content":["NAME"]},{"type":"para","id":"tYx_e3g14vpsDTWT7n6f1","margin":"","location":{"start":{"line":6,"column":1,"offset":171},"end":{"line":6,"column":63,"offset":233}},"text":"text","content":["ZML::Query - jQuery-like node selecting and traversing for XML"]},{"type":"block","id":"RgaKZTdJLD-OfU8v0KKJY","margin":"","level":1,"name":"head","location":{"start":{"line":8,"column":1,"offset":235},"end":{"line":9,"column":9,"offset":252}},"content":["SYNOPSIS"]},{"type":"block","id":"hJkt1Ryg9RlQS3-1wULiD","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":11,"column":1,"offset":254},"end":{"line":20,"column":4,"offset":576}},"content":[{"type":"verbatim","value":"use XML::Query;\n\n## Given $xml is an XML::Document or XML::Element object.\nmy $xq = XML::Query.new($xml);\nmy @boxes = $xq('input[type=\"radio\"]').not('[disabled=\"disabled\"]').elements;\nmy $first-link = $xq('a').first.element; \nmy $by-id = $xq('#header').element;\nmy $last-decr-class = $xq('.decr').last.element;"}]},{"type":"block","id":"_7kEeoIcmB_SoelCvRMwk","margin":"","level":1,"name":"head","location":{"start":{"line":22,"column":1,"offset":578},"end":{"line":23,"column":12,"offset":601}},"content":["DESCRIPTION"]},{"type":"para","id":"ZvNBRGq7Fdm-Rk-019AnS","margin":"","location":{"start":{"line":25,"column":1,"offset":603},"end":{"line":25,"column":214,"offset":816}},"text":"text","content":["XML::Query is a jQuery-like XML query engine for Raku. It works with the ",{"meta":"https://github.com/raku-community-modules/XML","type":"fcode","name":"L","content":["XML"]}," library to provide a flexible and easy method of querying for specific XML/XHTML nodes."]},{"type":"para","id":"_2PeG55FZJWxKGNcS1Vdu","margin":"","location":{"start":{"line":27,"column":1,"offset":818},"end":{"line":27,"column":221,"offset":1038}},"text":"text","content":["Unlike jQuery, ",{"type":"fcode","name":"C","content":["XML::Query"]}," is for querying and travsersing XML structures only, and does not support direct manipulation of XML data (however you can use the features inherent to the XML library to manipulate the data.)"]},{"type":"block","id":"iBhOGlEoXk5mdZOOPtvet","margin":"","level":1,"name":"head","location":{"start":{"line":29,"column":1,"offset":1040},"end":{"line":30,"column":7,"offset":1053}},"content":["STATUS"]},{"type":"para","id":"lbSQtMsAiee2xpXKSQRUc","margin":"","location":{"start":{"line":32,"column":1,"offset":1055},"end":{"line":32,"column":181,"offset":1235}},"text":"text","content":["This is a work in progress. It doesn't support many methods or selectors yet, and there is no documentation. See the tests in the \"t/\" folder for examples of what does work so far."]},{"type":"block","id":"VIS6IT_rF9I5MEUU_IRwO","margin":"","level":1,"name":"head","location":{"start":{"line":34,"column":1,"offset":1237},"end":{"line":35,"column":7,"offset":1250}},"content":["AUTHOR"]},{"type":"para","id":"EkD_8gL0mePFOkiU7ZlOd","margin":"","location":{"start":{"line":37,"column":1,"offset":1252},"end":{"line":37,"column":15,"offset":1266}},"text":"text","content":["Timothy Totten"]},{"type":"para","id":"vBLhKyChbNj7T1fIh-3mY","margin":"","location":{"start":{"line":39,"column":1,"offset":1268},"end":{"line":39,"column":120,"offset":1387}},"text":"text","content":["Source can be located at: ",{"meta":"https://github.com/raku-community-modules/XML-Query","type":"fcode","name":"L","content":["https://github.com/raku-community-modules/XML-Query"]}," . Comments and Pull Requests are welcome."]},{"type":"block","id":"ZDeIm_sMWxe4OuKhrpaJ6","margin":"","level":1,"name":"head","location":{"start":{"line":41,"column":1,"offset":1389},"end":{"line":42,"column":22,"offset":1432}},"content":["COPYRIGHT AND LICENSE"]},{"type":"para","id":"_u-s7cmEfVA-gcRkVM_Pu","margin":"","location":{"start":{"line":44,"column":1,"offset":1434},"end":{"line":44,"column":37,"offset":1470}},"text":"text","content":["Copyright 2012 - 2017 Timothy Totten"]},{"type":"para","id":"jmXZaISPeu7LUUoj50YuL","margin":"","location":{"start":{"line":46,"column":1,"offset":1472},"end":{"line":46,"column":37,"offset":1508}},"text":"text","content":["Copyright 2018 - 2022 Raku Community"]},{"type":"para","id":"FJHYaZyg02MwnlkC4YbOY","margin":"","location":{"start":{"line":48,"column":1,"offset":1510},"end":{"line":48,"column":104,"offset":1613}},"text":"text","content":["This library is free software; you can redistribute it and/or modify it under the Artistic License 2.0."]}]},"publishUrl":"/mods/zef/XML::Query/XML-Query-1.0/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"","auth":"zef:raku-community-modules","author":"Timoty Totten","build-depends":[],"depends":["XML"],"description":"jQuery-like node selecting and traversing for XML","dist":"XML::Query:ver<1.0>:auth<zef:raku-community-modules>","license":"Artistic-2.0","name":"XML::Query","path":"X/ML/XML_QUERY/bb62f8ce24f7ef3fa41701d0737f12950f8db120.tar.gz","perl":"6.*","provides":{"XML::Query":"lib/XML/Query.rakumod","XML::Query::Results":"lib/XML/Query/Results.rakumod","XML::Query::Statement":"lib/XML/Query/Statement.rakumod"},"resources":[],"source-url":"git://github.com/raku-community-modules/XML-Query.git","tags":["XML","QUERY"],"test-depends":[],"version":"1.0"},"files":[{"file":"work_mods/zef/XML::Query/XML-Query-1.0/README.md","publishUrl":"/mods/zef/XML::Query/XML-Query-1.0/README.md"},{"file":"work_mods/zef/XML::Query/XML-Query-1.0/lib/XML/Query.rakumod","publishUrl":"/mods/zef/XML::Query/XML-Query-1.0/lib/XML/Query.rakumod"}],"src":"zef","url":"/mods/zef/XML::Query"}}}
=end data


React

    =begin React :component<RenderItem>
    =begin data
    {"type":"page","file":"work_mods/zef/XML::Query/XML-Query-1.0/README.md","sources":[],"node":{"type":"block","id":"cy7lPy7C1T568_wP7xpCp","margin":"","name":"root","content":[{"type":"para","id":"kygii4qr3ShI2VlHXAVH9","margin":"","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":159,"offset":158}},"text":"text","content":[{"meta":"https://github.com/raku-community-modules/XML-Query/actions","type":"fcode","name":"L","content":[{"type":"block","id":"cGHnu7HCHjNQnn2Mq-efl","margin":"","name":"Image","config":[],"location":{"start":{"line":1,"column":2,"offset":1},"end":{"line":1,"column":97,"offset":96}},"content":[{"type":"image","src":"https://github.com/raku-community-modules/XML-Query/workflows/test/badge.svg","alt":"Actions Status"}]}]}]},{"type":"block","id":"lUF-ZpnZgVooZzJrenPub","margin":"","level":1,"name":"head","location":{"start":{"line":3,"column":1,"offset":160},"end":{"line":4,"column":5,"offset":169}},"content":["NAME"]},{"type":"para","id":"tYx_e3g14vpsDTWT7n6f1","margin":"","location":{"start":{"line":6,"column":1,"offset":171},"end":{"line":6,"column":63,"offset":233}},"text":"text","content":["ZML::Query - jQuery-like node selecting and traversing for XML"]},{"type":"block","id":"RgaKZTdJLD-OfU8v0KKJY","margin":"","level":1,"name":"head","location":{"start":{"line":8,"column":1,"offset":235},"end":{"line":9,"column":9,"offset":252}},"content":["SYNOPSIS"]},{"type":"block","id":"hJkt1Ryg9RlQS3-1wULiD","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":11,"column":1,"offset":254},"end":{"line":20,"column":4,"offset":576}},"content":[{"type":"verbatim","value":"use XML::Query;\n\n## Given $xml is an XML::Document or XML::Element object.\nmy $xq = XML::Query.new($xml);\nmy @boxes = $xq('input[type=\"radio\"]').not('[disabled=\"disabled\"]').elements;\nmy $first-link = $xq('a').first.element; \nmy $by-id = $xq('#header').element;\nmy $last-decr-class = $xq('.decr').last.element;"}]},{"type":"block","id":"_7kEeoIcmB_SoelCvRMwk","margin":"","level":1,"name":"head","location":{"start":{"line":22,"column":1,"offset":578},"end":{"line":23,"column":12,"offset":601}},"content":["DESCRIPTION"]},{"type":"para","id":"ZvNBRGq7Fdm-Rk-019AnS","margin":"","location":{"start":{"line":25,"column":1,"offset":603},"end":{"line":25,"column":214,"offset":816}},"text":"text","content":["XML::Query is a jQuery-like XML query engine for Raku. It works with the ",{"meta":"https://github.com/raku-community-modules/XML","type":"fcode","name":"L","content":["XML"]}," library to provide a flexible and easy method of querying for specific XML/XHTML nodes."]},{"type":"para","id":"_2PeG55FZJWxKGNcS1Vdu","margin":"","location":{"start":{"line":27,"column":1,"offset":818},"end":{"line":27,"column":221,"offset":1038}},"text":"text","content":["Unlike jQuery, ",{"type":"fcode","name":"C","content":["XML::Query"]}," is for querying and travsersing XML structures only, and does not support direct manipulation of XML data (however you can use the features inherent to the XML library to manipulate the data.)"]},{"type":"block","id":"iBhOGlEoXk5mdZOOPtvet","margin":"","level":1,"name":"head","location":{"start":{"line":29,"column":1,"offset":1040},"end":{"line":30,"column":7,"offset":1053}},"content":["STATUS"]},{"type":"para","id":"lbSQtMsAiee2xpXKSQRUc","margin":"","location":{"start":{"line":32,"column":1,"offset":1055},"end":{"line":32,"column":181,"offset":1235}},"text":"text","content":["This is a work in progress. It doesn't support many methods or selectors yet, and there is no documentation. See the tests in the \"t/\" folder for examples of what does work so far."]},{"type":"block","id":"VIS6IT_rF9I5MEUU_IRwO","margin":"","level":1,"name":"head","location":{"start":{"line":34,"column":1,"offset":1237},"end":{"line":35,"column":7,"offset":1250}},"content":["AUTHOR"]},{"type":"para","id":"EkD_8gL0mePFOkiU7ZlOd","margin":"","location":{"start":{"line":37,"column":1,"offset":1252},"end":{"line":37,"column":15,"offset":1266}},"text":"text","content":["Timothy Totten"]},{"type":"para","id":"vBLhKyChbNj7T1fIh-3mY","margin":"","location":{"start":{"line":39,"column":1,"offset":1268},"end":{"line":39,"column":120,"offset":1387}},"text":"text","content":["Source can be located at: ",{"meta":"https://github.com/raku-community-modules/XML-Query","type":"fcode","name":"L","content":["https://github.com/raku-community-modules/XML-Query"]}," . Comments and Pull Requests are welcome."]},{"type":"block","id":"ZDeIm_sMWxe4OuKhrpaJ6","margin":"","level":1,"name":"head","location":{"start":{"line":41,"column":1,"offset":1389},"end":{"line":42,"column":22,"offset":1432}},"content":["COPYRIGHT AND LICENSE"]},{"type":"para","id":"_u-s7cmEfVA-gcRkVM_Pu","margin":"","location":{"start":{"line":44,"column":1,"offset":1434},"end":{"line":44,"column":37,"offset":1470}},"text":"text","content":["Copyright 2012 - 2017 Timothy Totten"]},{"type":"para","id":"jmXZaISPeu7LUUoj50YuL","margin":"","location":{"start":{"line":46,"column":1,"offset":1472},"end":{"line":46,"column":37,"offset":1508}},"text":"text","content":["Copyright 2018 - 2022 Raku Community"]},{"type":"para","id":"FJHYaZyg02MwnlkC4YbOY","margin":"","location":{"start":{"line":48,"column":1,"offset":1510},"end":{"line":48,"column":104,"offset":1613}},"text":"text","content":["This library is free software; you can redistribute it and/or modify it under the Artistic License 2.0."]}]},"publishUrl":"/mods/zef/XML::Query/XML-Query-1.0/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"","auth":"zef:raku-community-modules","author":"Timoty Totten","build-depends":[],"depends":["XML"],"description":"jQuery-like node selecting and traversing for XML","dist":"XML::Query:ver<1.0>:auth<zef:raku-community-modules>","license":"Artistic-2.0","name":"XML::Query","path":"X/ML/XML_QUERY/bb62f8ce24f7ef3fa41701d0737f12950f8db120.tar.gz","perl":"6.*","provides":{"XML::Query":"lib/XML/Query.rakumod","XML::Query::Results":"lib/XML/Query/Results.rakumod","XML::Query::Statement":"lib/XML/Query/Statement.rakumod"},"resources":[],"source-url":"git://github.com/raku-community-modules/XML-Query.git","tags":["XML","QUERY"],"test-depends":[],"version":"1.0"},"files":[{"file":"work_mods/zef/XML::Query/XML-Query-1.0/README.md","publishUrl":"/mods/zef/XML::Query/XML-Query-1.0/README.md"},{"file":"work_mods/zef/XML::Query/XML-Query-1.0/lib/XML/Query.rakumod","publishUrl":"/mods/zef/XML::Query/XML-Query-1.0/lib/XML/Query.rakumod"}],"src":"zef","url":"/mods/zef/XML::Query"}}}
    =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

XML::Query


A full-featured, pure-Raku XML library (parsing, manipulation, emitting, queries, etc.)


XML


A Raku module to turn XML into a Hash structure


=begin data
{"type":"page","file":"work_mods/zef/XML::Fast/XML-Fast-0.0.1/README.md","sources":[],"node":{"type":"block","id":"N6tXDgt8ejGbyER62Rmho","margin":"","name":"root","content":[{"type":"block","id":"xESm1oist7sFq3n1UDiO0","margin":"","level":1,"name":"head","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":11,"offset":10}},"content":["XML-Fast"]},{"type":"para","id":"I7lTjOx09kWnWkDhl53wE","margin":"","location":{"start":{"line":3,"column":1,"offset":12},"end":{"line":3,"column":84,"offset":95}},"text":"text","content":["A Raku module to turn XML into a Hash structure, to satisfy the AI that Cursor uses"]},{"type":"para","id":"hM6bgNDe6hJWtuBnRIrDf","margin":"","location":{"start":{"line":5,"column":1,"offset":97},"end":{"line":5,"column":158,"offset":254}},"text":"text","content":[{"meta":"https://github.com/jonathanstowe/XML-Fast/actions/workflows/main.yml","type":"fcode","name":"L","content":[{"type":"block","id":"NkMHgJsv1euh818n2-PT2","margin":"","name":"Image","config":[],"location":{"start":{"line":5,"column":2,"offset":98},"end":{"line":5,"column":87,"offset":183}},"content":[{"type":"image","src":"https://github.com/jonathanstowe/XML-Fast/actions/workflows/main.yml/badge.svg","alt":"CI"}]}]}]},{"type":"block","id":"_yh-XhoKlL71fxamxibxW","margin":"","level":2,"name":"head","location":{"start":{"line":7,"column":1,"offset":256},"end":{"line":7,"column":12,"offset":267}},"content":["Synopsis"]},{"type":"block","id":"QyuJdhLVenEfTgBbyTUXp","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":9,"column":1,"offset":269},"end":{"line":28,"column":4,"offset":536}},"content":[{"type":"verbatim","value":"use JSON::Fast;\nuse XML::Fast;\n￼\nmy $xml = q:to/END_XML/;\n<root>\n  <person>\n    <name>John</name>\n    <age>30</age>\n  </person>\n  <person>\n    <name>Jane</name>\n    <age>25</age>\n  </person>\n</root>\nEND_XML\n￼\nmy $json = to-json(from-xml($xml));\nsay $json;"}]},{"type":"block","id":"i0BrMuM-CajdHutKT8pKF","margin":"","level":2,"name":"head","location":{"start":{"line":30,"column":1,"offset":538},"end":{"line":30,"column":15,"offset":552}},"content":["Description"]},{"type":"para","id":"jXuPyaVOgoITqkzzM6rPe","margin":"","location":{"start":{"line":32,"column":1,"offset":554},"end":{"line":32,"column":87,"offset":640}},"text":"text","content":["This provides a simple and probably very dumb means to turn XML text into a Raku Hash."]},{"type":"para","id":"CdhgpjhGTV3SgC9BsEMue","margin":"","location":{"start":{"line":34,"column":1,"offset":642},"end":{"line":34,"column":262,"offset":903}},"text":"text","content":["I wrote this because I was playing around with (Cursor)[",{"meta":"https://www.cursor.so/","type":"fcode","name":"L","content":["https://www.cursor.so/"]},"]"," - a new IDE that uses some AI engine to generate and edit code.  I thought I'd start out with something relatively simple which people probably do all the time in various languages:"]},{"type":"block","id":"1V-2uhTJ-coGLifBcszWm","margin":"","name":"nested","location":{"start":{"line":36,"column":1,"offset":905},"end":{"line":36,"column":49,"offset":953}},"content":[{"type":"para","id":"YnSRMZPNK2IgW4K1XKuVq","margin":"","location":{"start":{"line":36,"column":3,"offset":907},"end":{"line":36,"column":49,"offset":953}},"text":"text","content":["Create a Raku program to transform XML to JSON"]}]},{"type":"para","id":"LqG80cEIuPQ4v86-ZPL2P","margin":"","location":{"start":{"line":38,"column":1,"offset":955},"end":{"line":38,"column":56,"offset":1010}},"text":"text","content":["Easy right?  It gave me the exact code in the Synopsis."]},{"type":"para","id":"7hjTgQajtDaP5Qq3cELwn","margin":"","location":{"start":{"line":40,"column":1,"offset":1012},"end":{"line":40,"column":487,"offset":1498}},"text":"text","content":["It looks plausible: it got the Raku heredoc syntax right and knows about JSON::Fast.  One problem though: the module ",{"type":"fcode","name":"C","content":["XML::Fast"]}," ",{"type":"fcode","name":"I","content":["doesn't exist"]},".  I'm guessing it extrapolated from ",{"type":"fcode","name":"C","content":["JSON::Fast"]}," (possibly with a node to the ",{"meta":"https://metacpan.org/pod/XML::Fast","type":"fcode","name":"L","content":["Perl module of the same name"]},"), made up a plausible kebab-cased function name and just suggested code that used this made up module.  When I told it that the module ",{"type":"fcode","name":"C","content":["XML::Fast"]}," didn't exist it told me to install it with ",{"type":"fcode","name":"C","content":["zef"]},"."]},{"type":"para","id":"oFiZsL3KHLNnPq3L3ge4x","margin":"","location":{"start":{"line":42,"column":1,"offset":1500},"end":{"line":42,"column":231,"offset":1730}},"text":"text","content":["I eventually got the AI to implement something using ",{"meta":"https://libxml-raku.github.io/LibXML-raku/","type":"fcode","name":"L","content":["LibXML"]},", but it couldn't get  it completely right after a lot of prompting: it probably needs to spend more time with the Raku docs."]},{"type":"para","id":"OPWamXJcJy8VngDZa9pVP","margin":"","location":{"start":{"line":44,"column":1,"offset":1732},"end":{"line":44,"column":339,"offset":2070}},"text":"text","content":["Anyway, being a relatively easy thing to do, I decided that I would implement the ",{"type":"fcode","name":"C","content":["XML::Fast"]}," that the AI had imagined so if anyone else where to ask it the same thing they wouldn't get disappointed and try another language or spend several frustrating hours trying to work out why the code doesn't work however many suggestions are made."]},{"type":"para","id":"YLln67ope-mxbPGLScgBh","margin":"","location":{"start":{"line":46,"column":1,"offset":2072},"end":{"line":46,"column":307,"offset":2378}},"text":"text","content":["This is probably not the module you are looking for if you have any more than the simplest requirement: it flattens attributes into the Hash representing an element and doesn't deal with namespaces at all.  It doesn't purport to have the same interface or functionality as the Perl module of the same name."]},{"type":"para","id":"2XGonh3D9wn_0gLw53VCc","margin":"","location":{"start":{"line":48,"column":1,"offset":2380},"end":{"line":48,"column":193,"offset":2572}},"text":"text","content":["The only surprising thing may be the way it deals with what a schema definition might call \"Complex Type with simple content\", that is an element with an attribute which only has a text child:"]},{"type":"block","id":"ce-0olH2-mg7lIOtpCJpW","margin":"","name":"code","config":[{"name":"lang","value":"xml","type":"string"}],"location":{"start":{"line":50,"column":1,"offset":2574},"end":{"line":54,"column":4,"offset":2626}},"content":[{"type":"verbatim","value":"   <person id=\"1\">\n      Rod\n   </person>"}]},{"type":"para","id":"VZGF7JoPGdkNqhJ5NRxgJ","margin":"","location":{"start":{"line":56,"column":1,"offset":2628},"end":{"line":56,"column":47,"offset":2674}},"text":"text","content":["Which will get rendered as the Raku structure:"]},{"type":"block","id":"C7YCikKpWzM58ccgt7J6T","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":58,"column":1,"offset":2676},"end":{"line":64,"column":4,"offset":2769}},"content":[{"type":"verbatim","value":"   {\n      person  => {\n         id     => \"1\",\n         text   => \"Rod\",\n      }"}]},{"type":"para","id":"kulvgv9ObLe0oxdVZQe0Q","margin":"","location":{"start":{"line":66,"column":1,"offset":2771},"end":{"line":66,"column":202,"offset":2972}},"text":"text","content":["Because the other choices might be either lose the attribute (undesirable,) or introduce a new type ( in which case one might as well use e.g. ",{"meta":"https://github.com/jonathanstowe/XML-Class","type":"fcode","name":"L","content":["XML::Class"]},".)"]},{"type":"para","id":"YsNqZomszKYrIBUK7yhoQ","margin":"","location":{"start":{"line":68,"column":1,"offset":2974},"end":{"line":68,"column":310,"offset":3283}},"text":"text","content":["There is no ",{"type":"fcode","name":"C","content":["to-xml"]}," as this would imply the ability to round-trip the data accurately, too much information is lost about the structure of the original XML to make this meaningful. Again consider using something like ",{"type":"fcode","name":"C","content":["XML::Class"]}," which allows you to preserve the structure of the expected XML as you see fit."]},{"type":"block","id":"LOUWOhs2WWn2SOcbbi_mU","margin":"","level":2,"name":"head","location":{"start":{"line":71,"column":1,"offset":3286},"end":{"line":71,"column":16,"offset":3301}},"content":["Installation"]},{"type":"para","id":"pwxjIwMFlUumfemFcMG-3","margin":"","location":{"start":{"line":73,"column":1,"offset":3303},"end":{"line":73,"column":90,"offset":3392}},"text":"text","content":["Assuming you have a working rakudo installation you should be able to install with ",{"type":"fcode","name":"I","content":["zef"]},":"]},{"type":"block","id":"BLzsOq_xDOLuWrTqDMoai","margin":"","name":"code","config":[],"location":{"start":{"line":76,"column":1,"offset":3395},"end":{"line":76,"column":27,"offset":3421}},"content":[{"type":"verbatim","value":" zef install XML::Fast"}]},{"type":"para","id":"f2Azssk5i2m7sYV8yPbu-","margin":"","location":{"start":{"line":78,"column":1,"offset":3423},"end":{"line":78,"column":96,"offset":3518}},"text":"text","content":["Because it uses ",{"type":"fcode","name":"C","content":["LibXML"]}," under the hood you may need to install ",{"type":"fcode","name":"C","content":["libxml2"]}," on your system first."]},{"type":"block","id":"1zztyz5RAyqd_EvL1gDXt","margin":"","level":2,"name":"head","location":{"start":{"line":80,"column":1,"offset":3520},"end":{"line":80,"column":11,"offset":3530}},"content":["Support"]},{"type":"para","id":"z3UwBevbTqv6OOEcilZi-","margin":"","location":{"start":{"line":82,"column":1,"offset":3532},"end":{"line":82,"column":264,"offset":3795}},"text":"text","content":["Because this module exists purely to make the AI suggested code in the Synopsis work it's unlikely to gain any additional features, if you want something a bit like this but more flexible then feel free to copy the code and extend it, I might even do that myself."]},{"type":"para","id":"_HZbHjdn6T164ihIHjqDC","margin":"","location":{"start":{"line":84,"column":1,"offset":3797},"end":{"line":84,"column":222,"offset":4018}},"text":"text","content":["If you do however find a real bug (like it makes garbage output with some XML data,) please raise an issue on ]Github](",{"meta":"https://github.com/jonathanstowe/XML-Fast/issues","type":"fcode","name":"L","content":["https://github.com/jonathanstowe/XML-Fast/issues"]},").  Test cases with the offending XML are appreciated."]},{"type":"block","id":"r5f-QSRkLX3c4w0gXZhK0","margin":"","level":2,"name":"head","location":{"start":{"line":86,"column":1,"offset":4020},"end":{"line":86,"column":23,"offset":4042}},"content":["Copyright & Licence"]},{"type":"para","id":"QJjISuCzdWw04ZTZ08SqI","margin":"","location":{"start":{"line":88,"column":1,"offset":4044},"end":{"line":88,"column":99,"offset":4142}},"text":"text","content":["This library is free software.  Please see the ",{"meta":"LICENCE","type":"fcode","name":"L","content":["LICENCE"]}," in the distribution for details."]},{"type":"para","id":"t4y7xo_sU3swsG4cUbxE7","margin":"","location":{"start":{"line":90,"column":1,"offset":4144},"end":{"line":90,"column":23,"offset":4166}},"text":"text","content":["© Jonathan Stowe  2023"]}]},"publishUrl":"/mods/zef/XML::Fast/XML-Fast-0.0.1/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"","auth":"zef:jonathanstowe","authors":["Jonathan Stowe <jns+gh@gellyfish.co.uk>"],"depends":["LibXML"],"description":"A Raku module to turn XML into a Hash structure","dist":"XML::Fast:ver<0.0.1>:auth<zef:jonathanstowe>","license":"Artistic-2.0","meta-version":"0","name":"XML::Fast","path":"X/ML/XML_FAST/d15f2d1f529c84d9a8332e75c3a1e335a1cb4698.tar.gz","provides":{"XML::Fast":"lib/XML/Fast.rakumod"},"raku":"6.d","source-url":"git://github.com/jonathanstowe/XML-Fast.git","support":{"bugtracker":"https://github.com/jonathanstowe/XML-Fast/issues","email":"jns+gh@gellyfish.co.uk","source":"http://github.com/jonathanstowe/XML-Fast"},"tags":["XML","Hash","deserialise"],"version":"0.0.1"},"files":[{"file":"work_mods/zef/XML::Fast/XML-Fast-0.0.1/README.md","publishUrl":"/mods/zef/XML::Fast/XML-Fast-0.0.1/README.md"},{"file":"work_mods/zef/XML::Fast/XML-Fast-0.0.1/lib/XML/Fast.rakumod","publishUrl":"/mods/zef/XML::Fast/XML-Fast-0.0.1/lib/XML/Fast.rakumod"}],"src":"zef","url":"/mods/zef/XML::Fast"}}}
=end data


    =begin React :component<RenderItem>
    =begin data
    {"type":"page","file":"work_mods/zef/XML::Fast/XML-Fast-0.0.1/README.md","sources":[],"node":{"type":"block","id":"N6tXDgt8ejGbyER62Rmho","margin":"","name":"root","content":[{"type":"block","id":"xESm1oist7sFq3n1UDiO0","margin":"","level":1,"name":"head","location":{"start":{"line":1,"column":1,"offset":0},"end":{"line":1,"column":11,"offset":10}},"content":["XML-Fast"]},{"type":"para","id":"I7lTjOx09kWnWkDhl53wE","margin":"","location":{"start":{"line":3,"column":1,"offset":12},"end":{"line":3,"column":84,"offset":95}},"text":"text","content":["A Raku module to turn XML into a Hash structure, to satisfy the AI that Cursor uses"]},{"type":"para","id":"hM6bgNDe6hJWtuBnRIrDf","margin":"","location":{"start":{"line":5,"column":1,"offset":97},"end":{"line":5,"column":158,"offset":254}},"text":"text","content":[{"meta":"https://github.com/jonathanstowe/XML-Fast/actions/workflows/main.yml","type":"fcode","name":"L","content":[{"type":"block","id":"NkMHgJsv1euh818n2-PT2","margin":"","name":"Image","config":[],"location":{"start":{"line":5,"column":2,"offset":98},"end":{"line":5,"column":87,"offset":183}},"content":[{"type":"image","src":"https://github.com/jonathanstowe/XML-Fast/actions/workflows/main.yml/badge.svg","alt":"CI"}]}]}]},{"type":"block","id":"_yh-XhoKlL71fxamxibxW","margin":"","level":2,"name":"head","location":{"start":{"line":7,"column":1,"offset":256},"end":{"line":7,"column":12,"offset":267}},"content":["Synopsis"]},{"type":"block","id":"QyuJdhLVenEfTgBbyTUXp","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":9,"column":1,"offset":269},"end":{"line":28,"column":4,"offset":536}},"content":[{"type":"verbatim","value":"use JSON::Fast;\nuse XML::Fast;\n￼\nmy $xml = q:to/END_XML/;\n<root>\n  <person>\n    <name>John</name>\n    <age>30</age>\n  </person>\n  <person>\n    <name>Jane</name>\n    <age>25</age>\n  </person>\n</root>\nEND_XML\n￼\nmy $json = to-json(from-xml($xml));\nsay $json;"}]},{"type":"block","id":"i0BrMuM-CajdHutKT8pKF","margin":"","level":2,"name":"head","location":{"start":{"line":30,"column":1,"offset":538},"end":{"line":30,"column":15,"offset":552}},"content":["Description"]},{"type":"para","id":"jXuPyaVOgoITqkzzM6rPe","margin":"","location":{"start":{"line":32,"column":1,"offset":554},"end":{"line":32,"column":87,"offset":640}},"text":"text","content":["This provides a simple and probably very dumb means to turn XML text into a Raku Hash."]},{"type":"para","id":"CdhgpjhGTV3SgC9BsEMue","margin":"","location":{"start":{"line":34,"column":1,"offset":642},"end":{"line":34,"column":262,"offset":903}},"text":"text","content":["I wrote this because I was playing around with (Cursor)[",{"meta":"https://www.cursor.so/","type":"fcode","name":"L","content":["https://www.cursor.so/"]},"]"," - a new IDE that uses some AI engine to generate and edit code.  I thought I'd start out with something relatively simple which people probably do all the time in various languages:"]},{"type":"block","id":"1V-2uhTJ-coGLifBcszWm","margin":"","name":"nested","location":{"start":{"line":36,"column":1,"offset":905},"end":{"line":36,"column":49,"offset":953}},"content":[{"type":"para","id":"YnSRMZPNK2IgW4K1XKuVq","margin":"","location":{"start":{"line":36,"column":3,"offset":907},"end":{"line":36,"column":49,"offset":953}},"text":"text","content":["Create a Raku program to transform XML to JSON"]}]},{"type":"para","id":"LqG80cEIuPQ4v86-ZPL2P","margin":"","location":{"start":{"line":38,"column":1,"offset":955},"end":{"line":38,"column":56,"offset":1010}},"text":"text","content":["Easy right?  It gave me the exact code in the Synopsis."]},{"type":"para","id":"7hjTgQajtDaP5Qq3cELwn","margin":"","location":{"start":{"line":40,"column":1,"offset":1012},"end":{"line":40,"column":487,"offset":1498}},"text":"text","content":["It looks plausible: it got the Raku heredoc syntax right and knows about JSON::Fast.  One problem though: the module ",{"type":"fcode","name":"C","content":["XML::Fast"]}," ",{"type":"fcode","name":"I","content":["doesn't exist"]},".  I'm guessing it extrapolated from ",{"type":"fcode","name":"C","content":["JSON::Fast"]}," (possibly with a node to the ",{"meta":"https://metacpan.org/pod/XML::Fast","type":"fcode","name":"L","content":["Perl module of the same name"]},"), made up a plausible kebab-cased function name and just suggested code that used this made up module.  When I told it that the module ",{"type":"fcode","name":"C","content":["XML::Fast"]}," didn't exist it told me to install it with ",{"type":"fcode","name":"C","content":["zef"]},"."]},{"type":"para","id":"oFiZsL3KHLNnPq3L3ge4x","margin":"","location":{"start":{"line":42,"column":1,"offset":1500},"end":{"line":42,"column":231,"offset":1730}},"text":"text","content":["I eventually got the AI to implement something using ",{"meta":"https://libxml-raku.github.io/LibXML-raku/","type":"fcode","name":"L","content":["LibXML"]},", but it couldn't get  it completely right after a lot of prompting: it probably needs to spend more time with the Raku docs."]},{"type":"para","id":"OPWamXJcJy8VngDZa9pVP","margin":"","location":{"start":{"line":44,"column":1,"offset":1732},"end":{"line":44,"column":339,"offset":2070}},"text":"text","content":["Anyway, being a relatively easy thing to do, I decided that I would implement the ",{"type":"fcode","name":"C","content":["XML::Fast"]}," that the AI had imagined so if anyone else where to ask it the same thing they wouldn't get disappointed and try another language or spend several frustrating hours trying to work out why the code doesn't work however many suggestions are made."]},{"type":"para","id":"YLln67ope-mxbPGLScgBh","margin":"","location":{"start":{"line":46,"column":1,"offset":2072},"end":{"line":46,"column":307,"offset":2378}},"text":"text","content":["This is probably not the module you are looking for if you have any more than the simplest requirement: it flattens attributes into the Hash representing an element and doesn't deal with namespaces at all.  It doesn't purport to have the same interface or functionality as the Perl module of the same name."]},{"type":"para","id":"2XGonh3D9wn_0gLw53VCc","margin":"","location":{"start":{"line":48,"column":1,"offset":2380},"end":{"line":48,"column":193,"offset":2572}},"text":"text","content":["The only surprising thing may be the way it deals with what a schema definition might call \"Complex Type with simple content\", that is an element with an attribute which only has a text child:"]},{"type":"block","id":"ce-0olH2-mg7lIOtpCJpW","margin":"","name":"code","config":[{"name":"lang","value":"xml","type":"string"}],"location":{"start":{"line":50,"column":1,"offset":2574},"end":{"line":54,"column":4,"offset":2626}},"content":[{"type":"verbatim","value":"   <person id=\"1\">\n      Rod\n   </person>"}]},{"type":"para","id":"VZGF7JoPGdkNqhJ5NRxgJ","margin":"","location":{"start":{"line":56,"column":1,"offset":2628},"end":{"line":56,"column":47,"offset":2674}},"text":"text","content":["Which will get rendered as the Raku structure:"]},{"type":"block","id":"C7YCikKpWzM58ccgt7J6T","margin":"","name":"code","config":[{"name":"lang","value":"raku","type":"string"}],"location":{"start":{"line":58,"column":1,"offset":2676},"end":{"line":64,"column":4,"offset":2769}},"content":[{"type":"verbatim","value":"   {\n      person  => {\n         id     => \"1\",\n         text   => \"Rod\",\n      }"}]},{"type":"para","id":"kulvgv9ObLe0oxdVZQe0Q","margin":"","location":{"start":{"line":66,"column":1,"offset":2771},"end":{"line":66,"column":202,"offset":2972}},"text":"text","content":["Because the other choices might be either lose the attribute (undesirable,) or introduce a new type ( in which case one might as well use e.g. ",{"meta":"https://github.com/jonathanstowe/XML-Class","type":"fcode","name":"L","content":["XML::Class"]},".)"]},{"type":"para","id":"YsNqZomszKYrIBUK7yhoQ","margin":"","location":{"start":{"line":68,"column":1,"offset":2974},"end":{"line":68,"column":310,"offset":3283}},"text":"text","content":["There is no ",{"type":"fcode","name":"C","content":["to-xml"]}," as this would imply the ability to round-trip the data accurately, too much information is lost about the structure of the original XML to make this meaningful. Again consider using something like ",{"type":"fcode","name":"C","content":["XML::Class"]}," which allows you to preserve the structure of the expected XML as you see fit."]},{"type":"block","id":"LOUWOhs2WWn2SOcbbi_mU","margin":"","level":2,"name":"head","location":{"start":{"line":71,"column":1,"offset":3286},"end":{"line":71,"column":16,"offset":3301}},"content":["Installation"]},{"type":"para","id":"pwxjIwMFlUumfemFcMG-3","margin":"","location":{"start":{"line":73,"column":1,"offset":3303},"end":{"line":73,"column":90,"offset":3392}},"text":"text","content":["Assuming you have a working rakudo installation you should be able to install with ",{"type":"fcode","name":"I","content":["zef"]},":"]},{"type":"block","id":"BLzsOq_xDOLuWrTqDMoai","margin":"","name":"code","config":[],"location":{"start":{"line":76,"column":1,"offset":3395},"end":{"line":76,"column":27,"offset":3421}},"content":[{"type":"verbatim","value":" zef install XML::Fast"}]},{"type":"para","id":"f2Azssk5i2m7sYV8yPbu-","margin":"","location":{"start":{"line":78,"column":1,"offset":3423},"end":{"line":78,"column":96,"offset":3518}},"text":"text","content":["Because it uses ",{"type":"fcode","name":"C","content":["LibXML"]}," under the hood you may need to install ",{"type":"fcode","name":"C","content":["libxml2"]}," on your system first."]},{"type":"block","id":"1zztyz5RAyqd_EvL1gDXt","margin":"","level":2,"name":"head","location":{"start":{"line":80,"column":1,"offset":3520},"end":{"line":80,"column":11,"offset":3530}},"content":["Support"]},{"type":"para","id":"z3UwBevbTqv6OOEcilZi-","margin":"","location":{"start":{"line":82,"column":1,"offset":3532},"end":{"line":82,"column":264,"offset":3795}},"text":"text","content":["Because this module exists purely to make the AI suggested code in the Synopsis work it's unlikely to gain any additional features, if you want something a bit like this but more flexible then feel free to copy the code and extend it, I might even do that myself."]},{"type":"para","id":"_HZbHjdn6T164ihIHjqDC","margin":"","location":{"start":{"line":84,"column":1,"offset":3797},"end":{"line":84,"column":222,"offset":4018}},"text":"text","content":["If you do however find a real bug (like it makes garbage output with some XML data,) please raise an issue on ]Github](",{"meta":"https://github.com/jonathanstowe/XML-Fast/issues","type":"fcode","name":"L","content":["https://github.com/jonathanstowe/XML-Fast/issues"]},").  Test cases with the offending XML are appreciated."]},{"type":"block","id":"r5f-QSRkLX3c4w0gXZhK0","margin":"","level":2,"name":"head","location":{"start":{"line":86,"column":1,"offset":4020},"end":{"line":86,"column":23,"offset":4042}},"content":["Copyright & Licence"]},{"type":"para","id":"QJjISuCzdWw04ZTZ08SqI","margin":"","location":{"start":{"line":88,"column":1,"offset":4044},"end":{"line":88,"column":99,"offset":4142}},"text":"text","content":["This library is free software.  Please see the ",{"meta":"LICENCE","type":"fcode","name":"L","content":["LICENCE"]}," in the distribution for details."]},{"type":"para","id":"t4y7xo_sU3swsG4cUbxE7","margin":"","location":{"start":{"line":90,"column":1,"offset":4144},"end":{"line":90,"column":23,"offset":4166}},"text":"text","content":["© Jonathan Stowe  2023"]}]},"publishUrl":"/mods/zef/XML::Fast/XML-Fast-0.0.1/README.md","pluginsData":{"moduleInfo":{"meta":{"api":"","auth":"zef:jonathanstowe","authors":["Jonathan Stowe <jns+gh@gellyfish.co.uk>"],"depends":["LibXML"],"description":"A Raku module to turn XML into a Hash structure","dist":"XML::Fast:ver<0.0.1>:auth<zef:jonathanstowe>","license":"Artistic-2.0","meta-version":"0","name":"XML::Fast","path":"X/ML/XML_FAST/d15f2d1f529c84d9a8332e75c3a1e335a1cb4698.tar.gz","provides":{"XML::Fast":"lib/XML/Fast.rakumod"},"raku":"6.d","source-url":"git://github.com/jonathanstowe/XML-Fast.git","support":{"bugtracker":"https://github.com/jonathanstowe/XML-Fast/issues","email":"jns+gh@gellyfish.co.uk","source":"http://github.com/jonathanstowe/XML-Fast"},"tags":["XML","Hash","deserialise"],"version":"0.0.1"},"files":[{"file":"work_mods/zef/XML::Fast/XML-Fast-0.0.1/README.md","publishUrl":"/mods/zef/XML::Fast/XML-Fast-0.0.1/README.md"},{"file":"work_mods/zef/XML::Fast/XML-Fast-0.0.1/lib/XML/Fast.rakumod","publishUrl":"/mods/zef/XML::Fast/XML-Fast-0.0.1/lib/XML/Fast.rakumod"}],"src":"zef","url":"/mods/zef/XML::Fast"}}}
    =end data
    =end React


XML::Fast


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


XML::Query

NAME

SYNOPSIS

DESCRIPTION

STATUS

AUTHOR

COPYRIGHT AND LICENSE

XML::Query v1.0

Authors

License

Dependencies

Test Dependencies

Provides

Documentation