vifraa / gopom

A maven pom.xml parser written in Go.
MIT License
25 stars 17 forks source link
go go-module golang maven maven-pom pom xml xml-parser

gopom - a maven pom.xml parser

Tests Go Report Card

gopom is a Golang module to easily parse and work with maven pom.xml files.

Supports the offical pom.xml structure that can be read about here.

Installation

go get -u github.com/vifraa/gopom

Usage

To load and parse a pom.xml file it is possible to use the gopom.Parse(path string) function which will load the file at the given path and return the parsed pom.
See below for example:

package main

import (
    "github.com/vifraa/gopom"
    "log"
)

func main() {

    var pomPath string = ... // Path to the pom.xml file
    parsedPom, err := gopom.Parse(pomPath)
    if err != nil {
        log.Fatal(err)
    }
}

If one already has the pom.xml loaded as a string or bytes you can use encoding/xml from the standard library.
This can be seen below:

package main

import (
    "encoding/xml"
    "github.com/vifraa/gopom"
    "log"
)

func main() {
    var pomString string = ... // The pom string

    var parsedPom gopom.Project
    err := xml.Unmarshal([]byte(pomString), &parsedPom)
    if err != nil {
        log.Fatal(err)
    }
}

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

Please make sure to update tests as appropriate.

License

Copyright (c) 2020-present Viktor Franzén

Licensed under MIT License