HAL support

[technoweenie]

Just a quick idea on how we might handle hypermedia parsing. The GitHub API structs would want to extend HALResource into something that checks HAL first, and then *Url properties second.

[owenthereal]

👍

[technoweenie]

Added support for reflecting hypermedia based on the fields (Url, RepositoryUrl, etc). Most of them will need to use the "rel" annotation so it uses a value consistent with HAL.

As far as the GitHub API goes, we should rely on the reflected hypermedia behavior. Full HAL support would come through a specific media type like "application/vnd.github.hal+json".

Instead of passing the structs around as interface{}, we can pass them around as *HypermediaResource.

[owenthereal]

Are you planning to move the parsing logic to a decoder?

[owenthereal]

We may need two decoders in the end: json decoder and hyperresource decoder to fill up a HyperResource

[technoweenie]

Okay, this is much easier. I don't care for the names though. Kind of thinking:

sawyer.HypermediaFieldsDecoder
sawyer.HypermediaHALDecoder

It could go into a separate hypermedia package too.

hypermedia.Decoder
hypermedia.HALDecoder

[owenthereal]

👍 It tastes good. The APIs for this portion start to become elegant!

[technoweenie]

I think I'm going to keep the hypermedia stuff in the sawyer package. The names are longer, but you won't have to import two things every time you use sawyer. What do you think?

[owenthereal]

I think it makes perfect sense to keep it within the same package for now

[technoweenie]

Cool. Merging this. I don't consider this repo "published" yet, so we can still change names. The README still says "Very experimental", and there aren't really any go docs yet. I'd actually like to successfully integrate this into a couple clients to see how it feels.