versions follow SemVer
- Added global
--config
option andWB_CONFIG
environment variable, to allow customizing the config used
wd revisions
: now accepts ids on stdin and--props
wb move-claim
: Allow to change the moved claim value
BREAKING CHANGE: updated NodeJS minimal version to >= v18
to be able to use the native fetch
BREAKING CHANGE: updated NodeJS minimal version >= v14.0.0
to be able to convert the code from CommonJS to ES modules
- Added support for
entity.statements
as an alias forentity.claims
, to support Wikibase-ish instances such as https://commons.wikimedia.org. For more on this oddity, see https://phabricator.wikimedia.org/T149410. wb summary
: include an extract from the corresponding Wikipedia article when available
- Added
wb badges
- Added
wb add-badge
- Added
wb remove-badge
wb sparql
/wb query
: added--log-response-headers
option
- Added
wb remove-label
- Added
wb remove-description
- Added
wb set-sitelink
- Added
wb remove-sitelink
wb data
: added--keep badges
option
wb merge-entity
: add--keep-oldest
option
BREAKING CHANGE: updated NodeJS minimal version >= v10.0.0
wb search
: added support for Cirrus search
wb edit-entity
/wb create-claim
/wb remove-claim
: add reconciliation capabilities, throughwikibase-edit
reconciliation syntaxwb props
: allow to filter by both type and patternwb claims
: allow to filter claims by both type and pattern
wb data
: allow to set thenondeprecated
simplify option
- allow to pass templates to all edit commands where it wasn't possible yet (
wb-add-alias
,wb-add-qualifier
,wb-add-reference
,wb-delete-entity
,wb-merge-entity
,wb-move-claim
,wb-move-qualifier
,wb-remove-alias
,wb-remove-claim
,wb-remove-reference
,wb-remove-qualifier
,wb-set-alias
,wb-set-description
,wb-set-label
,wb-update-claim
,wb-update-qualifier
) - allow to set
dryRun=false
in templates examples - allow to set a
commands
shortlist in templates
wb data
: added--time-converter
wb data
: added support for entities schemawb generate-template
: added a--json
(equivalent to--format json
)
- Edit commands: allow to set the
baserevid
wb sparql
: added support for template metadata, allowing to generate a [template-specific--help
menu]
wb move-qualifier
/wb remove-qualifier
: accept statement uri in place of a statement guid- template help menu: added a new recommended template syntax
wb sparql
/wb query
: add support for xml, tsv, csv, and rdfbin formats
wb sparql
: Added support for async SPARQL-generating functions
wb generate-template
: added a--no-minimize
flag
create-entity
/edit-entity
: add support for template metadata, allowing to generate a template-specific--help
menu
wb open
: added a--talk
option to open an entity's talk pagewb move-claim
/wb move-qualifier
: add type conversion between properties of different datatypes
wb add-claim
,wb update-claim
: Added support for the object interface- Added support for custom calendars (example with
wb add-claim
)
BREAKING CHANGE: wb convert
now requires ids to be passed as explicit subject or object options.
wb add-claim
,wb update-claim
: Added a--rank
option
BREAKING CHANGE: local files are now always stored in the home directory. To keep your current config after this upgrade, follow this steps:
mkdir -p ~/.config/wikibase-cli
wb config --json > ~/.config/wikibase-cli/config.json
# Now we can run the upgrade
npm install -g wikibase-cli@14
- batch mode: allow to combine arguments passed inline and those passed on stdin
BREAKING CHANGE: output now defaults to newline-delimited values (instead of space-delimited values)
wb data
: added support for property claims id
- Added
wb move-qualifier
wb move-claim
: allow to move all property claims at once
wb-generate-template
:- BREAKING CHANGE: default to format js, when only one entity is requested
- When using
--format js
: add entities labels as comments - Added
--create-mode
option
- Added
wb move-claim
wb config credentials
: add atest
mode, to easily validate credentialswb config <option> reset
=>wb config <option> reset
(but the keywordclear
remains available to avoid a breaking change)
- batch mode: added
--no-exit-on-error
option
wb-generate-template
: add batch mode
BREAKING CHANGE:
- the short option
-n
is repurposed to alias--limit
in read operations (it was previously associated with the--no-cache
option) - the short option
-t
is repurposed to alias--type
in read operations (it was previously associated with the--limit
option)
New features:
wb summary
: added support for lexemeswb search
: added support for lexemes, forms, and senseswb open
: added support for lexemes, forms, and senseswb lemma
BREAKING CHANGE: Removed the -g, --edit-group <key>
option, as it is now automatically generated when in batch mode and targeting wikidata.org
- Added edit summary
- Added edit group support
- Added batch mode to write operations
BREAKING CHANGE: updated wikibase-edit
to > v4.0.0
, which uses async/await, and started using those internally too, thus requiring NodeJS >= v7.6.0
. If you are locked on an older version of NodeJS, you are thus advised to stay on wikibase-cli@8
wb-data
/wb-generate-template
: add lazy syntax to props selection
wb query
: add--count
option
BREAKING CHANGES:
- renamed:
create-item
=>create-entity
edit-item
=>edit-entity
wb config <option> default
=>wb config <option> clear
- removed:
wb-coord
(as it was just an alias ofwb claims P625
, and thus coupled to Wikidata)
- changed behavior:
wb-add-claim
: doesn't stop you from creating duplicated claims anymore (no claim existance check)
- changed aliases:
wb s
is now an alias forwb sparql
, whilewb u
iswb summary
new alias
New features:
- Added a
wb
command, which is now considered the default command in the documentation,wd
simply now being the Wikidata-bound version of it. - Added multiple instances credentials support (so that acting on different instances now only depends on the command flags without the painful process of entering credentials)
- Added OAuth tokens support
- Added
wb delete-entity
- Added
wb merge-entity
- Add option
--format table
towb sparql
andwb query
- Add option
--all
towb claims
- Add alias
wb r
towb sparql
wd data
: allow to request sub property keys
wd data
: allow to fetch an old revision's datawd generate-template
: allow to generate template from a specific revisionwd generate-open
: allow to open a specifc revision's page
wd create-item
/wd edit-item
: accept JS files as input, where the JS file should export either an object or a function, to which command line arguments are passed- Added
wd generate-template
: a command to easily create those JSON or JS files to be passed towd create-item
orwd edit-item
from existing items wd data
: allow to fetch a single claim's data by passing a claim GUID- Added
wd lang
wd claims
returns claims GUIDs when provided with a property and a value
- Added new
keep
options values towd data
:richvalues
andtypes
(commit 6cd7b7f) - Add option
-y, --history
towd open
- BREAKING CHANGE:
wd sparql
orwd query
commands making use of the--index <variable>
option now get their values aggregated in an array instead of being the direct value of the index key, preventing to delete multiple values for a same key.
- Added
wd convert
wd data
: added support forformat=ttl
- Added
wd hub
- Added support for 'novalue' and 'somevalue' snaktypes to
add-claim
andadd-qualifier
- Added the possibility to override config options with environment variables
wd props
:
- BREAKING CHANGE:
wd data
andwd revisions
now output newline delimited JSON, which is valid JSON if taken line by line, but not as a whole. wd data
can now fetch more than 50 entities at once and accepts ids from stdin- Added
wd sparql
wellknown query:all-instances
- Add option
-t, --limit
towd search
wd claims
accepts a filter pattern as second arguments, filtering claims by their properties type or labelwd props --type
accepts an additional arguments to filter matching properties by property type- Add option
-n, --no-cache
towd props
- Add option
-x, --index
towd sparql
, returns the request results as an index instead of a list
wd claims
,wd data
,wd open
, andwd revisions
accept numeric ids, assume it's an item id (commit: 37afea9)
- Added the command
wikibase-cli
as an alias towd
[UPDATE: implementation failed, removed by d0df064]
- Added the possibility to pass a JS file to
wd sparql
to generate SPARQL requests from the command arguments
- Add option
-v, --verbose
towd search
which passes the found ids towd summary
- Added
keep
options towd data
- BREAKING CHANGE:
wd add-reference
expects a property to be explicity set - BREAKING CHANGE:
wd add-claim
now can't be passed a reference: the reference needs to be added separately. See add claim with a reference. - Entity attribute commands (
wd summary
,wd label
,wd description
,wd aliases
) can now request the attributes of several entities at once wd add-claim
accepts time values with month or day precisionwd add-claim
now supports rich values- Added
wd edit-item
- Added
wd remove-reference
- Added
wd add-qualifier
- Added
wd update-qualifier
- Added
wd remove-qualifier
- Added
wd create-item
- Let
wd props
accept additional arguments to filter matching properties
- Added bot support
- Added
wd search
- Added
wd aliases
- Added
wd add-alias
- Added
wd remove-alias
- Added
wd set-alias
- Added
wd revisions
- Add option
-p,--props
towd data
- Added
wd update-claim
- Added
wd remove-description
- Added
wd set-description
- Added multiple entities mode to
wd data
- Added
simplify
option towd data
- Output
wd data
data as Wikidata-Dump-style line delimited JSON to make filterable bywikidata-filter
- Added
wd summary
- Added
wd description
- Added option
-u,--url
towd open
- Added
wd set-label
- Added
wd add-reference
- Added
wd add-claim
- Added
wd config
- Added
wd props --type
- Added
wd coord
wd open
opens a search page when no entity or property id can be found in the input
- Make results minimalist unless bassed the
-v, --verbose
option. Could be considered a breaking change as one might have built on the default verbose outputs. - Not copying results to clipboard anymore, unless passed the
-c, --clipboard
option - Format outputs for the shell by default, unless passed the
-j, --json
option - Renamed
wd wikiqid
towd id
. Using github#master version of commander to be able to set wikiqid as an alias to avoid making it a breaking change.
- Renamed
wd graph
->wd query
- Added
wd graph
- Added a help menu:
wd help
- Renamed
qlabel
->wd label
- Renamed
qclaims
->wd claims
- Renamed
qdata
->wd data
- Renamed
wdprops
->wd props
- Renamed
wdprops reset
->wd props --reset
- Renamed
wikiqid
->wd wikiqid
- Renamed
wdsparql
->wd sparql
- Removed
wdsparqlsimplify
: usewd sparql -s
- Replaced all language options by a uniformized
-l, --lang
option - Added
wd open
- Added qdata, a command to get the data of a given entity
- wikiqid accepts full wikipedia urls
- Added wdsparqlsimplify, like
wdsparql
but with simplified results out of the box
- Added wdprops, a command to get the list of all Wikidata properties
-
Added a new option to wdsparql:
--simplify
, which simplifies the query results using wikidata-sdksimplifySparqlResults
function
- Commands use the environment local language as default instead of English
- Added wdsparql
- Added qclaims