wikibase-cli 19.4.2 → 20.1.0

package/README.md

@@ -55,7 +55,7 @@ See [CHANGELOG.md](CHANGELOG.md) for version info
 ## Dependencies
 
 ### General
-* [NodeJs](https://nodejs.org) **>= v18** (recommended way to install it: use [NVM](https://github.com/creationix/nvm) to install the latest LTS version `nvm install --lts`)
+* [NodeJS](https://nodejs.org) **>= v20.12.0** (Older NodeJS versions can be used for older wikibase-cli version, see [changelogs](./CHANGELOG.md). Recommendable way to install NodeJS: you may use [NVM](https://github.com/creationix/nvm) to install the latest LTS version `nvm install --lts`)
 * [Git](https://git-scm.com/)
 
 ### Per feature
@@ -124,9 +124,7 @@ export DEBUG=wikibase-cli:request ; wd label Q1
 * [wikibase-sdk](https://www.npmjs.com/package/wikibase-sdk): A javascript tool suite to query and work with Wikibase data, heavily used by wikibase-cli
 * [wikibase-edit](https://www.npmjs.com/package/wikibase-edit): Edit Wikibase from NodeJS, used in wikibase-cli for all [write operations](docs/write_operations.md)
 * [wikibase-dump-filter](https://npmjs.com/package/wikibase-dump-filter): Filter and format a newline-delimited JSON stream of Wikibase entities
-* [wikidata-subset-search-engine](https://github.com/inventaire/entities-search-engine/tree/wikidata-subset-search-engine): Tools to setup an ElasticSearch instance fed with subsets of Wikidata
-* [wikidata-taxonomy](https://github.com/nichtich/wikidata-taxonomy): A command-line tool to extract taxonomies from Wikidata
-* [import-wikidata-dump-to-couchdb](https://github.com/maxlath/import-wikidata-dump-to-couchdb): Import a subset or a full Wikidata dump into a CouchDB database
+* [wikidata-taxonomy](https://www.npmjs.com/package/wikidata-taxonomy): A command-line tool to extract taxonomies from Wikidata
 * [Other Wikidata external tools](https://www.wikidata.org/wiki/Wikidata:Tools/External_tools)
 
 ## You may also like

package/bin/wb-claims.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
+import { yellow } from 'tiny-chalk'
 import { isPropertyId, simplifyClaims, simplifyPropertyClaims, getStatementsKey } from 'wikibase-sdk'
-import { yellow } from '#lib/chalk'
 import errors_ from '#lib/errors'
 import { exitOnMissingInstance } from '#lib/exit_on_missing'
 import getEntities from '#lib/get_entities'

package/bin/wb-config.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { green } from '#lib/chalk'
+import { green } from 'tiny-chalk'
 import { checkConfigFileExistance } from '#lib/config/check_config_file_existance'
 import { config } from '#lib/config/config'
 import { configurateCredentials } from '#lib/config/credentials_config'

package/bin/wb-graph-path.js

@@ -0,0 +1,85 @@
+#!/usr/bin/env node
+import { map, partition, uniq, values, without } from 'lodash-es'
+import { grey } from 'tiny-chalk'
+import { isEntityId, isPropertyId } from 'wikibase-sdk'
+import errors_ from '#lib/errors'
+import { getEntitiesLabels } from '#lib/get_entities_labels'
+import { makeSparqlQuery } from '#lib/make_sparql_query'
+import program from '#lib/program'
+
+await program
+.option('-f, --format <format>', 'Available alternative formats: mermaid')
+.process('graph-path')
+
+const { args, format } = program
+const [ subject, property, joinedObjects ] = args
+
+if (!(subject && property && joinedObjects)) {
+  program.helpAndExit(0)
+}
+
+const objects = joinedObjects.split(',')
+
+if (!isEntityId(subject)) throw new Error(`invalid subject id: ${subject}`)
+if (!isPropertyId(property)) throw new Error(`invalid property id: ${property}`)
+objects.forEach(object => {
+  if (!isEntityId(object)) throw new Error(`invalid object id: ${object}`)
+})
+
+const rows = await makeSparqlQuery(`SELECT DISTINCT ?intermediary ?next {
+  VALUES (?object) { ${objects.map(object => `(wd:${object})`).join(' ')} }
+  wd:${subject} wdt:${property}* ?intermediary .
+  ?object ^wdt:${property}* ?intermediary .
+  OPTIONAL {
+    ?intermediary wdt:${property} ?next .
+  }
+}`)
+
+if (rows.length === 0) {
+  errors_.exitMessage('no path found')
+}
+
+const intermediaries = uniq(map(rows, 'intermediary'))
+const relevantRows = rows.filter(row => intermediaries.includes(row.next))
+
+const allEntityIds = uniq(relevantRows.flatMap(row => values(row)))
+const labels = await getEntitiesLabels(allEntityIds, program.lang)
+
+if (format === 'mermaid') {
+  let output = 'graph LR\n'
+  const getNodeLabel = id => `${labels[id]} (${id})`
+  for (const { intermediary, next } of relevantRows) {
+    output += `${getNodeLabel(intermediary)} --> ${getNodeLabel(next)}\n`
+  }
+  console.log(output.trim())
+} else {
+  let remainingRows = relevantRows
+  let nextSubjects = [ subject ]
+  let paths = [ subject ]
+  const replacedPaths = []
+
+  while (remainingRows.length > 0) {
+    const newPaths = []
+    const [ nextRows, rest ] = partition(remainingRows, ({ intermediary }) => {
+      return nextSubjects.includes(intermediary)
+    })
+    if (rest.length === remainingRows.length) throw new Error('stuck')
+    remainingRows = rest
+    nextRows.forEach(({ intermediary, next }) => {
+      const relevantPaths = paths.filter(path => {
+        const pathParts = path.split('.')
+        return pathParts.at(-1) === intermediary
+      })
+      const updatedPaths = relevantPaths.map(path => `${path}.${next}`)
+      // Leave the relevantPaths in paths, to let other rows fork them if needed
+      replacedPaths.push(...relevantPaths)
+      newPaths.push(...updatedPaths)
+    })
+    nextSubjects = uniq(map(nextRows, 'next'))
+    paths = [ ...without(paths, ...replacedPaths), ...newPaths ]
+  }
+
+  for (const path of paths) {
+    console.log(path.split('.').map(part => `${labels[part]} ${grey(`(${part})`)}`).join(' → '))
+  }
+}

package/bin/wb-props.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { red } from '#lib/chalk'
+import { red } from 'tiny-chalk'
 import errors_ from '#lib/errors'
 import formatPropertiesData from '#lib/format_properties_data'
 import getLangProps from '#lib/get_lang_props'

package/bin/wb-query.js

@@ -1,5 +1,6 @@
 #!/usr/bin/env node
-import { grey } from '#lib/chalk'
+import { grey } from 'tiny-chalk'
+import errors_ from '#lib/errors'
 import { generateDescribeSparqlQuery } from '#lib/generate_describe_sparql_query'
 import { generateSampleSparqlQuery } from '#lib/generate_sample_sparql_query'
 import { generateSelectSparqlQuery } from '#lib/generate_select_sparql_query'
@@ -30,6 +31,10 @@ await program
 .option('-x, --index <variable>', "Return the result as an index, instead of a list, using the passed variable as key (can't be used with the 'raw' option)")
 .process('query')
 
+if (program.args.length > 0) {
+  errors_.exitMessage('wb query can not have positional arguments', `found positional arguments: ${program.args}`)
+}
+
 if (!(program.subject || program.property || program.object || program.describe || program.sample || program.statementProperty)) {
   program.helpAndExit(0)
 }

package/bin/wb-search.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import { padEnd } from 'lodash-es'
-import { red, grey } from '#lib/chalk'
+import { red, grey } from 'tiny-chalk'
 import { entityDataParser } from '#lib/entity_data_parser'
 import { exitOnMissingInstance } from '#lib/exit_on_missing'
 import parseEntityType from '#lib/parse_entity_type'

package/lib/common_errors.js

@@ -1,4 +1,4 @@
-import { red } from '#lib/chalk'
+import { red } from 'tiny-chalk'
 
 export const missingProperty = property => {
   console.error(red(`the property ${property} could not be found\n`) +

package/lib/config/config.js

@@ -1,4 +1,4 @@
-import { red } from '#lib/chalk'
+import { red } from 'tiny-chalk'
 import { readJsonFile } from '#lib/json'
 import { configFilePath } from './file_path.js'
 

package/lib/config/credentials_config.js

@@ -1,4 +1,4 @@
-import { yellow, green } from '#lib/chalk'
+import { yellow, green } from 'tiny-chalk'
 import { initCredentials } from '#lib/edit/init_credentials'
 import validateInstanceCredentials from '../edit/validate_instance_credentials.js'
 import errors_ from '../errors.js'

package/lib/debug.js

@@ -1,4 +1,4 @@
-import { cyan, grey } from '#lib/chalk'
+import { cyan, grey } from 'tiny-chalk'
 
 const { DEBUG = '' } = process.env
 const namespace = 'wikibase-cli'

package/lib/edit/assert_credentials.js

@@ -1,4 +1,4 @@
-import { yellow } from '#lib/chalk'
+import { yellow } from 'tiny-chalk'
 import { debug } from '#lib/debug'
 import { initCredentials } from './init_credentials.js'
 

package/lib/edit/edit_command.js

@@ -1,7 +1,7 @@
 import { inspect } from 'node:util'
 import split from 'split'
+import { red } from 'tiny-chalk'
 import wbEdit from 'wikibase-edit'
-import { red } from '#lib/chalk'
 import { debug } from '#lib/debug'
 import { config } from '../config/config.js'
 import errors_ from '../errors.js'

package/lib/edit/init_credentials.js

@@ -1,4 +1,4 @@
-import { green, red } from '#lib/chalk'
+import { green, red } from 'tiny-chalk'
 import configOps from '../config/file_operations.js'
 import prompt from './prompt.js'
 import validateInstanceCredentials from './validate_instance_credentials.js'

package/lib/edit/prompt.js

@@ -1,5 +1,5 @@
 import read from 'read'
-import { blue, yellow, grey } from '#lib/chalk'
+import { blue, yellow, grey } from 'tiny-chalk'
 
 export default readsData => {
   const results = {}

package/lib/entity_attribute_command.js

@@ -1,5 +1,5 @@
 import { max, padEnd, values } from 'lodash-es'
-import { grey, red } from '#lib/chalk'
+import { grey, red } from 'tiny-chalk'
 import { debug } from '#lib/debug'
 import entityAttributeParser from './entity_attribute_parser.js'
 import { entityDataParser } from './entity_data_parser.js'

package/lib/errors.js

@@ -1,4 +1,4 @@
-import { red } from '#lib/chalk'
+import { red } from 'tiny-chalk'
 
 const errors_ = {
   new: (message, context) => {

package/lib/exit_on_missing.js

@@ -1,4 +1,4 @@
-import { red } from '#lib/chalk'
+import { red } from 'tiny-chalk'
 
 const missingInstance = `A Wikibase instance should be specificed.
 

package/lib/fetch_lang_props.js

@@ -1,5 +1,5 @@
+import { red, yellow } from 'tiny-chalk'
 import { simplifySparqlResults } from 'wikibase-sdk'
-import { red, yellow } from '#lib/chalk'
 import { get } from '#lib/request'
 import { isValidLang } from '#lib/validate'
 import { getWbk } from '#lib/wbk'

package/lib/get_claims_texts.js

@@ -1,11 +1,9 @@
-import chalk from 'chalk'
+import chalk, { grey, bgWhite, black } from 'tiny-chalk'
 import { isEntityId } from 'wikibase-sdk'
 import { missingProperty } from './common_errors.js'
 import getPropertiesData from './get_properties_data.js'
 import { propTypes } from './properties.js'
 
-const { grey, bgWhite, black } = chalk
-
 export default async ({ labels, simplifiedClaims, resort, lang }) => {
   const propertiesIds = Object.keys(simplifiedClaims)
   const propertiesData = await getPropertiesData(propertiesIds, lang)

package/lib/log_claims.js

@@ -1,5 +1,5 @@
 import { chain, compact, max, padEnd, uniq } from 'lodash-es'
-import { bgMagenta, grey } from '#lib/chalk'
+import { bgMagenta, grey } from 'tiny-chalk'
 import filterClaimsProperties from '#lib/filter_claims_properties'
 import getClaimsTexts from '#lib/get_claims_texts'
 import { getEntitiesLabels } from './get_entities_labels.js'

package/lib/log_command_examples.js

@@ -1,6 +1,6 @@
 import { execSync } from 'node:child_process'
 import { dirname } from 'node:path'
-import { grey } from '#lib/chalk'
+import { grey } from 'tiny-chalk'
 
 export default (command, examples, doc, dryRun = false) => {
   if (examples && examples.length > 0) {

package/lib/make_sparql_query.js

@@ -1,5 +1,5 @@
+import { grey } from 'tiny-chalk'
 import { simplifySparqlResults, minimizeSimplifiedSparqlResults, buildBlazeGraphSparqlQueryUrl, buildQLeverSparqlQueryUrl } from 'wikibase-sdk'
-import { grey } from '#lib/chalk'
 import errors_ from '#lib/errors'
 import { exitOnMissingSparqlEndpoint } from '#lib/exit_on_missing'
 import { outputFactory } from '#lib/output'

package/lib/object_arg_parser.js

@@ -1,5 +1,5 @@
 import { existsSync } from 'node:fs'
-import { red } from '#lib/chalk'
+import { red } from 'tiny-chalk'
 import { readJsonFile } from '#lib/json'
 import { isJsonString, getAbsoluteFileUrl, validateTemplateCommand } from '#lib/utils'
 import { parseReconciliationArg } from './edit/reconciliation.js'

package/lib/output.js

@@ -1,5 +1,5 @@
 import { promisify } from 'node:util'
-import { grey } from '#lib/chalk'
+import { grey } from 'tiny-chalk'
 import { copyAndExit } from '#lib/copy'
 import { tabularize } from '#lib/tabularize'
 import { isArray, isCollection, isPlainObject } from '#lib/types'

package/lib/properties.js

@@ -1,5 +1,5 @@
 export const mainProps = {
-  'https://www.wikidata.org': [ 'P31', 'P279' ],
+  'https://www.wikidata.org': [ 'P31', 'P279', 'P569', 'P570', 'P571', 'P577', 'P580', 'P582' ],
 }
 
 export const propTypes = {

package/lib/reset_properties.js

@@ -1,5 +1,5 @@
 import { exec } from 'node:child_process'
-import { green } from '#lib/chalk'
+import { green } from 'tiny-chalk'
 import { getCacheFolderPath } from '#lib/get_cache_folder_path'
 
 export default () => {

package/lib/summary_parser.js

@@ -1,6 +1,6 @@
 import { pick, values } from 'lodash-es'
+import { bgGreen, bgMagenta, bgBlue, grey, white } from 'tiny-chalk'
 import { simplify, getSitelinkUrl } from 'wikibase-sdk'
-import { bgGreen, bgMagenta, bgBlue, grey, white } from '#lib/chalk'
 import entityAttributeParser from '#lib/entity_attribute_parser'
 import logClaims from '#lib/log_claims'
 import { mainProps } from '#lib/properties'
@@ -69,7 +69,7 @@ const parseEntity = async (entity, params) => {
     if (instanceMainProps) properties = instanceMainProps
   }
   claims = program.verbose ? claims : pick(claims, properties)
-  const simplifiedClaims = simplify.claims(claims, { keepTypes: true })
+  const simplifiedClaims = simplify.claims(claims, { keepTypes: true, timeConverter: 'simple-day' })
 
   const extraData = {}
   if (type === 'lexeme') {

package/lib/tabularize.js

@@ -1,5 +1,5 @@
 import { get, padEnd } from 'lodash-es'
-import { inverse } from '#lib/chalk'
+import { inverse } from 'tiny-chalk'
 import { isPlainObject } from './types.js'
 
 export function tabularize (collection) {

package/metadata/add-alias.js

@@ -3,10 +3,10 @@ import { editCommandsOptions } from '#lib/common_options'
 export default {
   alias: 'aa',
   args: '<entity> <language> <aliases>',
-  description: 'add one or several aliases to the list of aliases of an entity in a given language',
+  description: 'Add one or several aliases to the list of aliases of an entity in a given language',
   options: editCommandsOptions,
   examples: [
-    { args: 'Q4115189 fr foo', comment: "add 'foo' to the Sandbox entity (Q4115189) French aliases" },
-    { args: 'Q4115189 fr "foo|bar|buzz', comment: "add 'foo', 'bar', and 'buzz' to the Sandbox entity (Q4115189) French aliases" },
+    { args: 'Q4115189 fr foo', comment: "Add 'foo' to the Sandbox entity (Q4115189) French aliases" },
+    { args: 'Q4115189 fr "foo|bar|buzz', comment: "Add 'foo', 'bar', and 'buzz' to the Sandbox entity (Q4115189) French aliases" },
   ],
 }

package/metadata/add-badge.js

@@ -3,7 +3,7 @@ import { editCommandsOptions } from '#lib/common_options'
 export default {
   alias: 'ab',
   args: '<entity> <site> [badges]',
-  description: 'add badges on an existing sitelink, without removing other badges that might already have been set',
+  description: 'Add badges on an existing sitelink, without removing other badges that might already have been set',
   options: editCommandsOptions,
   examples: [
     { args: 'Q4115189 enwikiquote Q17437796,Q17437798', comment: 'Add Q17437796 and Q17437798 badges on Q4115189 enwikiquote sitelink' },

package/metadata/add-claim.js

@@ -3,9 +3,9 @@ import { editCommandsOptions } from '#lib/common_options'
 export default {
   alias: 'ac',
   args: '<entity> <property> <value>',
-  description: 'add a claim to an entity',
+  description: 'Add a claim to an entity',
   options: { rank: true, reconciliation: true, ...editCommandsOptions },
   examples: [
-    { args: 'Q4115189 P2002 Zorglub', comment: "add the Twitter account (P2002) 'Zorglub' to the Sandbox (Q4115189) entity" },
+    { args: 'Q4115189 P2002 Zorglub', comment: "Add the Twitter account (P2002) 'Zorglub' to the Sandbox (Q4115189) entity" },
   ],
 }

package/metadata/add-qualifier.js

@@ -3,14 +3,14 @@ import { editCommandsOptions } from '#lib/common_options'
 export default {
   alias: 'aq',
   args: '<claim-guid> <property> <value>',
-  description: 'add a qualifier to a claim',
+  description: 'Add a qualifier to a claim',
   options: editCommandsOptions,
   examples: [
-    { args: "'Q4115189$E66DBC80-CCC1-4899-90D4-510C9922A04F' P155 'Q13406268'", comment: 'entity qualifier' },
-    { args: "'Q4115189$E66DBC80-CCC1-4899-90D4-510C9922A04F' P1545 'A-123'", comment: 'string qualifier' },
-    { args: "'Q4115189$E66DBC80-CCC1-4899-90D4-510C9922A04F' P580 '1802-02-26'", comment: 'time qualifier' },
-    { args: "'Q4115189$E66DBC80-CCC1-4899-90D4-510C9922A04F' P2130 123", comment: 'quantity qualifier' },
-    { args: "'Q4115189$E66DBC80-CCC1-4899-90D4-510C9922A04F' P2130 '{\"amount\":123,\"unit\":\"Q4916\"}'", comment: 'quantity qualifier with a unit' },
-    { args: "'Q4115189$E66DBC80-CCC1-4899-90D4-510C9922A04F' P3132 \"text=les sanglots long des violons de l'automne&language=fr\"", comment: 'monolingualtext qualifier' },
+    { args: "'Q4115189$E66DBC80-CCC1-4899-90D4-510C9922A04F' P155 'Q13406268'", comment: 'Entity qualifier' },
+    { args: "'Q4115189$E66DBC80-CCC1-4899-90D4-510C9922A04F' P1545 'A-123'", comment: 'String qualifier' },
+    { args: "'Q4115189$E66DBC80-CCC1-4899-90D4-510C9922A04F' P580 '1802-02-26'", comment: 'Time qualifier' },
+    { args: "'Q4115189$E66DBC80-CCC1-4899-90D4-510C9922A04F' P2130 123", comment: 'Quantity qualifier' },
+    { args: "'Q4115189$E66DBC80-CCC1-4899-90D4-510C9922A04F' P2130 '{\"amount\":123,\"unit\":\"Q4916\"}'", comment: 'Quantity qualifier with a unit' },
+    { args: "'Q4115189$E66DBC80-CCC1-4899-90D4-510C9922A04F' P3132 \"text=les sanglots long des violons de l'automne&language=fr\"", comment: 'Monolingualtext qualifier' },
   ],
 }

package/metadata/add-reference.js

@@ -3,10 +3,10 @@ import { editCommandsOptions } from '#lib/common_options'
 export default {
   alias: 'ar',
   args: '<claim-guid> <property> <value>',
-  description: 'add a reference to a claim',
+  description: 'Add a reference to a claim',
   options: editCommandsOptions,
   examples: [
-    { args: "'Q4115189$E66DBC80-CCC1-4899-90D4-510C9922A04F' P854 'https://example.org/rise-and-box-of-the-holy-sand-box'", comment: 'add a reference URL (P854) to this claim' },
-    { args: "'Q4115189$E66DBC80-CCC1-4899-90D4-510C9922A04F' P143 Q60856", comment: 'reference the claim as imported from (P143) Wikipedia in Uyghur (Q60856)' },
+    { args: "'Q4115189$E66DBC80-CCC1-4899-90D4-510C9922A04F' P854 'https://example.org/rise-and-box-of-the-holy-sand-box'", comment: 'Add a reference URL (P854) to this claim' },
+    { args: "'Q4115189$E66DBC80-CCC1-4899-90D4-510C9922A04F' P143 Q60856", comment: 'Reference the claim as imported from (P143) Wikipedia in Uyghur (Q60856)' },
   ],
 }

package/metadata/aliases.js

@@ -3,10 +3,10 @@ import { entityAttributeCommandsOptions } from '#lib/common_options'
 export default {
   alias: 'a',
   args: '<entity>',
-  description: "display the entity's aliases",
+  description: "Display the entity's aliases",
   options: entityAttributeCommandsOptions,
   examples: [
-    { args: 'Q123', comment: 'fetch the aliases for the entity Q123' },
-    { args: 'Q123 --lang ja', comment: 'fetch the aliases for the entity Q123 in Japanese' },
+    { args: 'Q123', comment: 'Fetch the aliases for the entity Q123' },
+    { args: 'Q123 --lang ja', comment: 'Fetch the aliases for the entity Q123 in Japanese' },
   ],
 }

package/metadata/badges.js

@@ -1,7 +1,7 @@
 export default {
   alias: 'b',
   args: '',
-  description: 'list sitelink badges available on a Wikibase instance',
+  description: 'List sitelink badges available on a Wikibase instance',
   options: {
     lang: false,
     verbose: false,

package/metadata/claims.js

@@ -1,7 +1,7 @@
 export default {
   alias: 'c',
   args: '<entity> [property]',
-  description: 'display the claims of an entity',
+  description: 'Display the claims of an entity',
   options: {
     lang: true,
     verbose: true,
@@ -11,11 +11,11 @@ export default {
     sparqlEndpoint: true,
   },
   examples: [
-    { args: 'Q2001', comment: 'fetch all claims for the entity Q2001' },
-    { args: 'Q2001 P106', comment: 'or just the claims for the property P106' },
-    { args: 'Q2001 --type Url', comment: 'or just the claims from properties of type Url (other possible types: ExternalId, String, WikibaseItem, WikibaseProperty, Time, Monolingualtext, Quantity, CommonsMedia, GlobeCoordinate)' },
-    { args: 'Q2001 library', comment: 'or just the claims from properties with labels matching "library"' },
-    { args: 'Q2001 website', comment: 'or website, etc' },
-    { args: 'Q2001 --lang de', comment: 'fetch all claims for the entity Q2001 with properties labels in German' },
+    { args: 'Q2001', comment: 'Fetch all claims for the entity Q2001' },
+    { args: 'Q2001 P106', comment: 'Or just the claims for the property P106' },
+    { args: 'Q2001 --type Url', comment: 'Or just the claims from properties of type Url (other possible types: ExternalId, String, WikibaseItem, WikibaseProperty, Time, Monolingualtext, Quantity, CommonsMedia, GlobeCoordinate)' },
+    { args: 'Q2001 library', comment: 'Or just the claims from properties with labels matching "library"' },
+    { args: 'Q2001 website', comment: 'Or website, etc' },
+    { args: 'Q2001 --lang de', comment: 'Fetch all claims for the entity Q2001 with properties labels in German' },
   ],
 }

package/metadata/config.js

@@ -1,8 +1,8 @@
-import { grey } from '#lib/chalk'
+import { grey } from 'tiny-chalk'
 
 export default {
   args: '<key> [value]',
-  description: 'get and set configuration parameters',
+  description: 'Get and set configuration parameters',
   options: {
     lang: false,
     verbose: false,
@@ -12,15 +12,15 @@ export default {
     sparqlEndpoint: false,
   },
   examples: [
-    { args: 'clipboard true', comment: 'always copy results to the clipboard when possible' },
-    { args: 'lang nl', comment: 'set prefered language to Dutch' },
-    { args: 'instance reset', comment: 'reset the instance setting to its default value' },
-    { args: 'credentials https://www.wikidata.org', comment: 'get the credentials for an instance' },
-    { args: 'credentials https://localhost:8181 reset', comment: 'reset the credentials for an instance' },
-    { args: 'credentials http://localhost:8181 test', comment: 'test the validity of your credentials for an instance' },
-    { args: 'path', comment: 'get configuration path' },
-    { args: 'reset', comment: 'reset configuration' },
-    { args: `--json > config.json.backup\n  ${grey('# to restore it, simply override the current config file')}\n  cp config.json.backup $(wb config path)`, comment: 'can be used to backup the config' },
+    { args: 'clipboard true', comment: 'Always copy results to the clipboard when possible' },
+    { args: 'lang nl', comment: 'Set prefered language to Dutch' },
+    { args: 'instance reset', comment: 'Reset the instance setting to its default value' },
+    { args: 'credentials https://www.wikidata.org', comment: 'Get the credentials for an instance' },
+    { args: 'credentials https://localhost:8181 reset', comment: 'Reset the credentials for an instance' },
+    { args: 'credentials http://localhost:8181 test', comment: 'Test the validity of your credentials for an instance' },
+    { args: 'path', comment: 'Get configuration path' },
+    { args: 'reset', comment: 'Reset configuration' },
+    { args: `--json > config.json.backup\n  ${grey('# to restore it, simply override the current config file')}\n  cp config.json.backup $(wb config path)`, comment: 'Can be used to backup the config' },
   ],
   doc: 'https://github.com/maxlath/wikibase-cli/blob/main/docs/config.md#config',
 }

package/metadata/convert.js

@@ -1,6 +1,6 @@
 export default {
   args: '',
-  description: 'convert batches of external ids to Wikidata ids and vice versa',
+  description: 'Convert batches of external ids to Wikidata ids and vice versa',
   options: {
     lang: false,
     verbose: true,
@@ -10,8 +10,8 @@ export default {
     sparqlEndpoint: true,
   },
   examples: [
-    { args: '-p P268 -o 11865344k 11932251d', comment: 'get the Wikidata ids corresponding to those BNF ids' },
-    { args: '-p P268 -s Q45 Q140', comment: 'get the BNF ids corresponding to those Wikidata ids' },
-    { args: '-p P268 -o < ids_list', comment: 'the same but taking the ids from a file' },
+    { args: '-p P268 -o 11865344k 11932251d', comment: 'Get the Wikidata ids corresponding to those BNF ids' },
+    { args: '-p P268 -s Q45 Q140', comment: 'Get the BNF ids corresponding to those Wikidata ids' },
+    { args: '-p P268 -o < ids_list', comment: 'The same but taking the ids from a file' },
   ],
 }

package/metadata/create-entity.js

@@ -8,15 +8,15 @@ export default {
   examples: [
     {
       args: "'{\"labels\":{\"en\":\"a label\",\"fr\":\"un label\"},\"descriptions\":{\"en\":\"some description\",\"fr\":\"une description\"},\"claims\":{\"P1775\":[\"Q3576110\",\"Q12206942\"],\"P2002\":\"bulgroz\"}}'",
-      comment: 'pass data as JSON',
+      comment: 'Pass data as JSON',
     },
     {
       args: './new_entity_data.json',
-      comment: 'pass data as a JSON file path',
+      comment: 'Pass data as a JSON file path',
     },
     {
       args: './new_entity_data.json --instance http://some/wikibase/instance/w/api.php --sparql-endpoint http://some/sparql/endpoint',
-      comment: 'in case you use are not editing wikidata.org, make sure to specify the custom Wikibase instance and its SPARQL endpoint, as claims formatting and validation will depend on properties types that are retrieved from the SPARQL endpoint',
+      comment: 'In case you use are not editing wikidata.org, make sure to specify the custom Wikibase instance and its SPARQL endpoint, as claims formatting and validation will depend on properties types that are retrieved from the SPARQL endpoint',
     },
   ],
 }

package/metadata/data.js

@@ -1,7 +1,7 @@
 export default {
   alias: 'd',
   args: '<entity>',
-  description: "output the entity's data",
+  description: "Output the entity's data",
   options: {
     lang: false,
     verbose: false,
@@ -11,12 +11,12 @@ export default {
     sparqlEndpoint: false,
   },
   examples: [
-    { args: 'Q123', comment: "fetch Q123's raw data" },
-    { args: '--props labels,claims,sitelinks Q123', comment: "fetch Q123's labels, claims, and sitelinks only" },
-    { args: '--simplify Q123', comment: 'fetch Q123 simplified data' },
-    { args: '--simplify --keep ids,references,qualifiers,hashes,nontruthy Q123', comment: 'simplified Q123 data, but keep some attributes' },
-    { args: '--simplify --keep all Q123', comment: 'same as above' },
-    { args: 'Q1496 | jq .labels.pt', comment: "take advantage of the raw data being output as JSON\n    # to pass it to jq (a JSON parsers https://jqlang.github.io/jq/)\n    # and get only the piece of data you're looking for" },
-    { args: '--simplify --keep ids Q123 | jq .claims.P138 -j', comment: 'get Q123 P138 claims ids' },
+    { args: 'Q123', comment: "Fetch Q123's raw data" },
+    { args: '--props labels,claims,sitelinks Q123', comment: "Fetch Q123's labels, claims, and sitelinks only" },
+    { args: '--simplify Q123', comment: 'Fetch Q123 simplified data' },
+    { args: '--simplify --keep ids,references,qualifiers,hashes,nontruthy Q123', comment: 'Simplified Q123 data, but keep some attributes' },
+    { args: '--simplify --keep all Q123', comment: 'Same as above' },
+    { args: 'Q1496 | jq .labels.pt', comment: "Take advantage of the raw data being output as JSON\n    # to pass it to jq (a JSON parsers https://jqlang.github.io/jq/)\n    # and get only the piece of data you're looking for" },
+    { args: '--simplify --keep ids Q123 | jq .claims.P138 -j', comment: 'Get Q123 P138 claims ids' },
   ],
 }

package/metadata/delete-entity.js

@@ -8,11 +8,11 @@ export default {
   examples: [
     {
       args: 'Q1',
-      comment: 'delete an item',
+      comment: 'Delete an item',
     },
     {
       args: 'P1',
-      comment: 'delete a property',
+      comment: 'Delete a property',
     },
   ],
 }

package/metadata/description.js

@@ -3,10 +3,10 @@ import { entityAttributeCommandsOptions } from '#lib/common_options'
 export default {
   alias: 'desc',
   args: '<entity>',
-  description: "display the entity's description",
+  description: "Display the entity's description",
   options: entityAttributeCommandsOptions,
   examples: [
-    { args: 'Q123', comment: 'fetch the description for the entity Q123' },
-    { args: 'Q123 --lang ja', comment: 'fetch the description for the entity Q123 in Japanese' },
+    { args: 'Q123', comment: 'Fetch the description for the entity Q123' },
+    { args: 'Q123 --lang ja', comment: 'Fetch the description for the entity Q123 in Japanese' },
   ],
 }