NAME
    App::wdq - command line access to Wikidata Query Service

DESCRIPTION
    The command line script wdq, included in CPAN module App::wdq, provides
    a tool to access Wikidata Query Service <https://query.wikidata.org/>.
    It supports formulation and execution of SPARQL SELECT queries
    <http://www.w3.org/TR/sparql11-query/#select> to extract selected
    information from Wikidata or other Wikibase instances.

INSTALLATION
    Perl should already installed at most operating systems. Otherwise [get
    Perl first](https://www.perl.org/get.html).

  FROM CPAN
    Install sources from CPAN including all dependencies:

      cpanm App::wdq

    First [install
    cpanm](https://github.com/miyagawa/cpanminus/#installation) if missing.
    If installation of "App::wdq" fails try cpanm option "--notest" or
    install dependencies as packages as described below.

  PREBUILD PACKAGES
    Install dependencies as prebuild packages for your operating system:

      # Debian based systems e.g. Ubuntu
      sudo apt-get install libhttp-tiny-perl librdf-query-perl

      # Windows/ActiveState
      ppm install HTTP-Tiny
      ppm install RDF-Query

    Then install `wdq` from CPAN as described above or copy the script to
    some place in your $PATH:

      wget https://github.com/nichtich/wdq/raw/master/bin/wdq
      chmod +x wdq

    The latter method will not install this documentation.

USAGE
    Get a documented list of all command line options:

      wdq --help

  query mode (default)
    Pass a (possibly abbreviated) SPARQL query via STDIN or option
    "--query".

      wdq < queryfile

  lookup mode
    Pass a line-separated list of Wikidata identifiers or Wikimedia project
    URLs via STDIN or command line arguments:

      wdq Q1
      wdq lookup Q1
      echo Q1 | wdq lookup

EXAMPLES
      # get all parts of the solar system
      wdq -q '?c wdt:P361 wd:Q544'

      # get all references used at an item
      wdq -q 'wd:Q1 ?prop [ prov:wasDerivedFrom ?ref ]'

      # get doctoral advisor graph (academic genealogy) as CSV
      wdq -q '?student wdt:P184 ?advisor' --ids --format csv

      # print expanded SPARQL query 
      wdq -n -q '?c wdt:P361 wd:Q544'
  
      # execute query and return first 10 tab-separated values
      wdq -f tsv --limit 10 < query

      # print result as Markdown Table (requires Catmandu::Exporter::Table)
      wdq --export Table < query

      # look up label and description
      wdq Q42 P9

      # look up German Wikipedia article and get label description in French
      wdq -g fr http://de.wikipedia.org/wiki/Argon

COPYRIGHT AND LICENSE
    Copyright Jakob Voss, 2015-

    GPL 2.0