View Source Wiki.SiteMatrix (mediawiki_client v0.4.5)
Retrieves sites from a wiki farm with the SiteMatrix extension installed.
Link to this section Summary
Functions
Get the Action API for a known site
Get a single site, matching on dbname
Assertive variant of get
.
Get all sites for a wiki farm.
Options
api
- Action API URL for a site participating in the farm. Defaults to https://meta.wikimedia.org/w/api.php.
Link to this section Types
@type client_options() :: [Wiki.Action.client_option() | {:api, binary()}]
@opaque sitematrix_state()
Link to this section Functions
@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
Arguments
site
- Populated site structure.
return-value
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
Arguments
sitematrix
- Result of Sitematrix.new()dbname
- Wiki ID, for example "enwiki"
return-value
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
Arguments
sitematrix
- Result of Sitematrix.new()
return-value
Return value
List of site specifications.
@spec new(client_options()) :: sitematrix_state()
options
Options
api
- Action API URL for a site participating in the farm. Defaults to https://meta.wikimedia.org/w/api.php.