Repository files navigation

xgen is a library written in pure Go providing a set of functions that allow you to parse XSD (XML schema definition) files. This library needs Go version 1.10 or later. The full API docs can be seen using go's built-in documentation tool, or online atgo.dev.

xgen commands automatically compiles XML schema files into the multi-language type or class declarations code.

Install the command line tool first.

If you're using Go 1.17 and later, installing executables withgo install

go install github.com/xuri/xgen/cmd/xgen@latest

If you're using Go 1.16 and earlier, installing executables withgo get

go get -u -v github.com/xuri/xgen/cmd/...

The command below will walk on thexsd path and generate Go language struct code under theoutput directory.

$ xgen -i /path/to/your/xsd -o /path/to/your/output -l Go

Usage:

$ xgen [<flag> ...] <XSD file or directory> ...   -i <path> Input file path or directory for the XML schema definition   -o <path> Output file path or directory for the generated code   -p        Specify the package name   -l        Specify the language of generated code (Go/C/Java/Rust/TypeScript)   -h        Output this help and exit   -v        Output version and exit

XSD, a recommendation of the World Wide Web Consortium (W3C), specifies how to formally describe the elements in an Extensible Markup Language (XML) document. It can be used by programmers to verify each piece of item content in a document. They can check if it adheres to the description of the element it is placed in.

XSD can be used to express a set of rules to which an XML document must conform in order to be considered "valid" according to that schema. However, unlike most other schema languages, XSD was also designed with the intent that determination of a document's validity would produce a collection of information adhering to specific data types. Such a post-validation infoset can be useful in the development of XML document processing software.

Contributions are welcome! Open a pull request to fix a bug, or open an issue to discuss a new feature or change. XSD is compliant withXML Schema Part 1: Structures Second Edition.

This program is under the terms of the BSD 3-Clause License. Seehttps://opensource.org/licenses/BSD-3-Clause.

Logo is designed byxuri. Licensed under theCreative Commons 3.0 Attributions license.