Packages

mediawiki_client

0.5.4
0.6.4 0.6.3 0.6.2 0.6.1 0.6.0 0.5.5 0.5.4 0.5.3 0.5.2 0.5.1 0.5.0 0.4.9 0.4.8 0.4.7 0.4.6 0.4.5 0.4.4 0.4.3 0.4.2 0.4.1 0.4.0 0.3.1 0.3.0 0.2.6

API client library for any MediaWiki-based site, such as Wikipedia or Wikimedia Commons. Provides the Action API, realtime feed ingestion, and ORES scoring.

HexDocs

Current section

Files

Jump to
Readme
24 Versions
6 Dependencies
Dependants
Files
Activity
mediawiki_client lib rest.ex
Raw

lib/rest.ex 

defmodule Wiki.Rest do

  @moduledoc """

  Streamlined interface for reading pages and fetching basic information.



  See upstream references:

  - https://www.mediawiki.org/wiki/Parsoid/API

  - https://www.mediawiki.org/wiki/Specs/HTML

  - https://www.mediawiki.org/wiki/Special:MyLanguage/API:REST_API

  - https://www.mediawiki.org/wiki/API:REST_API/Reference

  - https://www.wikidata.org/wiki/Special:MyLanguage/Wikidata:REST_API



  Older backend:

  - https://www.mediawiki.org/wiki/Wikimedia_REST_API

  """



  @doc """

  Fetch rendered page HTML with RDFa annotations.



  ```

  Wiki.Rest.page_html(:enwiki, "Earth")

  ```

  """

  def page_html(site, title, _revision \\ nil) do

    Wiki.SiteMatrix.get!(site)

    |> rest_url("/page/#{title}/html")

    |> Tesla.get!()

  end



  def page_images(site, title) do

    Wiki.SiteMatrix.get!(site)

    |> rest_url("/page/#{title}/links/media")

    |> Tesla.get!()

  end



  defp rest_url(site, path) when is_struct(site, Wiki.SiteMatrix.Spec) do

    "#{site.base_url}/w/rest.php/v1#{path}"

  end

end