goldfinger/README.md

Goldfinger, a Webfinger client for Ruby
=======================================

[![Gem Version](http://img.shields.io/gem/v/goldfinger.svg)][gem]

[gem]: https://rubygems.org/gems/goldfinger

A Webfinger client for Ruby. Supports `application/xrd+xml` and `application/jrd+json` responses. Raises `Goldfinger::NotFoundError` on failure to fetch the Webfinger or XRD data, or `Goldfinger::SSLError` if something is wrong with the HTTPS connection it uses.

## Installation

    gem install goldfinger

## Usage

    data = Goldfinger.finger('acct:gargron@quitter.no')

    data.link('http://schemas.google.com/g/2010#updates-from').href
    # => "https://quitter.no/api/statuses/user_timeline/7477.atom"

    data.aliases
    # => ["https://quitter.no/user/7477", "https://quitter.no/gargron"]

    data.subject
    # => "acct:gargron@quitter.no"

## RFC support

The official Webfinger RFC is [7033](https://tools.ietf.org/html/rfc7033).