@spec action_api(String.t() | Wiki.SiteMatrix.Spec.t()) :: String.t()

Get the Action API for a known site

Wiki.SiteMatrix.new()
|> Wiki.SiteMatrix.get("enwiki")
|> Wiki.SiteMatrix.action_api()

# "https://en.wikipedia.org/w/api.php"

As a convenience, the site can be referenced as a bare string, in which case it will be looked up in the default Wikimedia farm. Note that this will be uncached and so inappropriate for most production use.

Wiki.SiteMatrix.action_api("dewiki")

Arguments

• site - Populated site structure.

Return value

Calculated Action API.

@spec get(sitematrix_state(), String.t()) ::
  {:ok, Wiki.SiteMatrix.Spec.t()} | {:error, any()}

Get a single site, matching on dbname

Arguments

• sitematrix - Result of Sitematrix.new()
• dbname - Wiki ID, for example "enwiki"

Return value

Site spec or error

@spec get!(sitematrix_state(), String.t()) :: Wiki.SiteMatrix.Spec.t()

Assertive variant of get.

@spec get_all(sitematrix_state()) ::
  {:ok, [Wiki.SiteMatrix.Spec.t()]} | {:error, any()}

Get all sites for a wiki farm.

Arguments

• sitematrix - Result of Sitematrix.new()

Return value

List of site specifications.

@spec new(client_options()) :: sitematrix_state()

Options

• api - Action API URL for a site participating in the farm. Defaults to https://meta.wikimedia.org/w/api.php.