Repository files navigation

Wikidata Toolkit is a Java library for accessing Wikidata and other Wikibase installations. It can be used to create bots, to perform data extraction tasks (e.g., convert all data in Wikidata to a new format), and to do large-scale analyses that are too complex for using a simple SPARQL query service.

• Wikidata Toolkit homepage: project homepage with basic user documentation, including guidelines on how to setup your Java IDE for using Maven and git.
• Wikidata Toolkit examples: stand-alone Java project that shows how to use Wikidata Toolkit as a library for your own code.
• Wikidata Toolkit Javadocs: API documentation

Authors:Markus Kroetzsch,Julian Mendez,Fredo Erxleben,Michael Guenther,Markus Damm,Antonin Delpeuch,Thomas Pellissier Tanon andother contributors

License:Apache 2.0

The development of Wikidata Toolkit has been partially funded by the Wikimedia Foundation under theWikibase Toolkit Individual Engagement Grant, and by the German Research Foundation (DFG) underEmmy Noether grant KR 4381/1-1 "DIAMOND".

During development, the version number in thepom.xml files should be the next version number assuming that the next version is a patch release, followed by-SNAPSHOT. For instance, if the last version to have been released was1.2.3, then thepom.xml files should contain<version>1.2.4-SNAPSHOT</version>.

1. Pick the version number for the new release you want to publish, following SemVer. If this is going to be a patch release, it should be the version currently inpom.xml without the-SNAPSHOT suffix. In the following steps, we will assume this new version is1.2.4.
2. Write the new version number in thepom.xml files withmvn versions:set -DnewVersion=1.2.4
3. Add some release notes in theRELEASE-NOTES.md file at the root of the repository
4. Commit the changes:git commit -am "Set version to 1.2.4"
5. Add a tag for the version:git tag -a v1.2.4 -m "Version 1.2.4"
6. Write the next version number in thepom.xml file, by incrementing the patch release number:mvn versions:set -DnewVersion=1.2.5-SNAPSHOT
7. Commit the changes:git commit -am "Set version to 1.2.5-SNAPSHOT"
8. Push commits and tags:git push --tags && git push
9. In GitHub's UI, create a release by going tohttps://github.com/Wikidata/Wikidata-Toolkit/releases/new. Pick the tag you just created, give a title to the release and quickly describe the changes since the previous release (see existing releases for examples).
10. Update the version number mentioned inhttps://www.mediawiki.org/wiki/Wikidata_Toolkit
11. Update the examples inhttps://github.com/Wikidata/Wikidata-Toolkit-Examples (generally just bumping WDTK's version in thepom.xml file works. Make sure it still compiles afterwards.)

The library is automatically packaged and uploaded to Maven Central by the continuous deployment (with GitHub Actions). So is the HTML version of the javadoc (to GitHub Pages).