wikidata.client
— Client session¶
-
wikidata.client.
WIKIDATA_BASE_URL
= 'https://www.wikidata.org/'¶ (
str
) The defaultbase_url
ofClient
constructor.Changed in version 0.3.0: As the meaning of
Client
constructor’sbase_url
parameter, it now became tohttps://www.wikidata.org/
fromhttps://www.wikidata.org/wiki/
(which contained the trailing pathwiki/
).
-
class
wikidata.client.
Client
(base_url: str='https://www.wikidata.org/', opener: typing.Union=None, datavalue_decoder: typing.Union=None, entity_type_guess: bool=True, repr_string: typing.Union=None) → None¶ Wikidata client session.
Parameters: - base_url (
str
) – The base url of the Wikidata.WIKIDATA_BASE_URL
is used by default. - opener (
urllib.request.OpenerDirector
) – The opener forurllib.request
. If omitted orNone
the default opener is used. - entity_type_guess (
bool
) – Whether to guesstype
ofEntity
from itsid
for less HTTP requests.True
by default.
Changed in version 0.3.0: The meaning of
base_url
parameter changed. It originally meanthttps://www.wikidata.org/wiki/
which contained the trailing pathwiki/
, but now it means onlyhttps://www.wikidata.org/
.New in version 0.2.0: The
entity_type_guess
option.-
datavalue_decoder
= None¶ (
Union
[Decoder
,Callable
[[Client
,str
,Mapping
[str
,object
]],object
]]) The function to decode the given datavalue. It’s typically an instance ofDecoder
or its subclass.
-
decode_datavalue
(datatype: str, datavalue: typing.Mapping) → object¶ Decode the given
datavalue
using the configureddatavalue_decoder
.New in version 0.3.0.
-
entity_type_guess
= True¶ (
bool
) Whether to guesstype
ofEntity
from itsid
for less HTTP requests.New in version 0.2.0.
-
get
(entity_id: <function NewType.<locals>.new_type at 0x7fc400288488>, load: bool=False) → wikidata.entity.Entity¶ Get a Wikidata entity by its
EntityId
.Parameters: Returns: The found entity.
Return type: New in version 0.3.0: The
load
option.
-
guess_entity_type
(entity_id: <function NewType.<locals>.new_type at 0x7fc400288488>) → typing.Union¶ Guess
EntityType
from the givenEntityId
. It could returnNone
when it fails to guess.Note
It always fails to guess when
entity_type_guess
is configued toFalse
.Returns: The guessed EntityId
, orNone
if it fails to guess.Return type: Optional
[EntityType
]New in version 0.2.0.
- base_url (