# marsalo

**Repository Path**: mirrors_Knetic/marsalo

## Basic Information

- **Project Name**: marsalo
- **Description**: Convenience library for unmarshalling HTTP request/response bodies from XML or JSON
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-08-09
- **Last Updated**: 2026-10-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

#marsalo

[![Build Status](https://travis-ci.org/Knetic/marsalo.svg?branch=master)](https://travis-ci.org/Knetic/marsalo)
[![Godoc](https://godoc.org/github.com/Knetic/marsalo?status.png)](https://godoc.org/github.com/Knetic/marsalo)

Marsalo is a small library that makes one-liner unmarshalling of http responses easy. The library isn't complicated, it's just a convenience library for code that tends to get written over and over.

Marsalo is Esperanto for "marshal".

## Usage

Often you'll have an HTTP request or response whose body will need to be unmarshalled into a real object model. Generally, you don't care if the request body is XML or JSON, you just want the parsed content thereof. This library encapsulates that logic of unmarshalling a request or response body from the appropriate transport type.

Assume you have the following object model (just as an example):

    type SomeObjectModel struct {

      name string `json:"name" xml:"name"`
      location string `json:"location" xml:"location"`
      entries int `json:"entries" xml:"entries"`
    }

And let's say you write a client to an HTTP API which may return either XML or JSON (or maybe you can pick, whatever), but the object represented by the response is the same.

    func HandleResponse(response *http.Response) {

      var structuredResponse SomeObjectModel

      err := marsalo.UnmarshalResponse(response, &structuredResponse)
      if(err != nil) {
        // some parsing error
        return
      }
    }

    // Otherwise, structuredResponse now contains the unmarshalled XML or JSON body of [response]

`marsalo` works similarly for writing a webserver which needs to unmarshal the request from a client:

    func HandleRequest(request *http.Request) {

      var structuredResponse SomeObjectModel

      err := marsalo.UnmarshalRequest(request, &structuredResponse)
      if(err != nil) {
        // some parsing error
        return
      }
    }