appunite / link_preview

Link preview elixir library

LinkPreview

LinkPreview is a package that tries to receive meta information from given http(s) address

Installation

1. Add link_preview to your list of dependencies in mix.exs:

def deps do
  [
    {:link_preview, "~> 1.0"}
  ]
end

2. For Elixir < 1.4 ensure link_preview is started before your application:

def application do
  [applications: [:link_preview]]
end

Example usage

You just need to execute:

LinkPreview.create("www.yahoo.pl")

in response you'll receive

{:ok, %LinkPreview.Page{
  description: "News, email and search are just the beginning. Discover more every day. Find your yodel.",
  images: [%{url: "https://s.yimg.com/dh/ap/default/130909/y_200_a.png"}],
  original_url: "www.yahoo.pl",
  title: "Yahoo",
  website_url: "yahoo.com"
}}

License

Copyright 2017 Tobiasz Małecki [email protected]

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

link_preview's Issues

Improve readme

• Parsers
• Custom Parsers
• Additional config options

Badarg still hangs generator sometimes

Increase tests coverage

Add changelog

Html Parser description ignores some values

<h1></h1>
<h1>Text1</h1>
<h2>Text2</h2>

It checks only first tag and then checks <hx+1> tag
Make it to choose Text1 intead of Text2

setup CI

Replace custom redirections by httpoison/hackney and get final location from separate request

[follow_redirect: true] will be more resistant to edge cases

On Some Urls receive "[error] SSL: :certify: ssl_handshake.erl:1592:Fatal error: bad certificate"

For some urls such as the following link, https://plato.stanford.edu/entries/consciousness-higher/ the error [error] SSL: :certify: ssl_handshake.erl:1592:Fatal error: bad certificate is returned. Any idea what this could be or how to solve it?

Add support for favicon

• additional field in Page struct
• additional parsing function in Base parser
• at least one working parsing function implementation

Configure which parsing functions should be invoked

e.g. collect title and images but ignore description