NAME
    LinkEmbedder - Embed / expand oEmbed resources and other URL / links

SYNOPSIS
      use LinkEmbedder;

      my $embedder = LinkEmbedder->new;
      my $link     = $embedder->get("http://xkcd.com/927");
      print $link->html;

DESCRIPTION
    LinkEmbedder is a module that can expand an URL into a rich HTML snippet
    or simply to extract information about the URL.

    Note that this module is currently EXPERIMENTAL. It will replace
    Mojolicious::Plugin::LinkEmbedder when it gets stable.

    These web pages are currently supported:

    * <http://imgur.com/>

    * <https://instagram.com/>

    * <https://appear.in/>

    * <https://github.com>

    * <https://ix.io>

    * <https://maps.google.com>

    * <https://metacpan.org>

    * <http://paste.opensuse.org>

    * <http://paste.scsys.co.uk>

    * <http://pastebin.com>

    * <https://www.spotify.com/>

    * <https://ted.com>

    * <https://travis-ci.org>

    * <https://twitter.com>

    * <https://vimeo.com>

    * <https://youtube.com>

    * <https://www.xkcd.com/>

    * HTML

      Any web page will be parsed, and "og:", "twitter:", meta tags and
      other significant elements will be used to generate a oEmbed response.

    * Images

      URLs that looks like an image is automatically converted into an img
      tag.

    * Video

      URLs that looks like a video resource is automatically converted into
      a video tag.

ATTRIBUTES
  ua
      $ua = $self->ua;

    Holds a Mojo::UserAgent object.

  url_to_link
      $hash_ref = $self->url_to_link;

    Holds a mapping between host names and link class to use.

METHODS
  get
      $self = $self->get($url, sub { my ($self, $link) = @_; });
      $link = $self->get($url);

    Used to construct a new LinkEmbedder::Link object and retrieve
    information about the URL.

  serve
      $self = $self->serve(Mojolicious::Controller->new, $url);

    Used as a helper for Mojolicious web applications to reply to an oEmbed
    request.

AUTHOR
    Jan Henning Thorsen

COPYRIGHT AND LICENSE
    This program is free software, you can redistribute it and/or modify it
    under the terms of the Artistic License version 2.0.

