Skip to main content

Provides IPython cell magic for dgraph queries, mutations, and alteration remote execution.

Project description

Provides IPython cell magic for dgraph remote interaction.


pip install idgraph

Why is this?

While dgraph provides several useful interfaces, I spend most of my time learning, exploring, and developing in Jupyter. Executable documentation is fantastic! This package abstractly provides cell magic for dgraph query, mutation, and alteration execution. You could do the same with curl or requests. But, the sensible defaults help make things less verbose and tedious. (It’s inspired by my experience with itikz which proved really beneficial.)


The easiest way to understand how this works is by following (and cloning) the tutorial notebook. It’s a projection dgraph’s Tour of Dgraph: A Bigger Dataset.

Cheat Sheet

Load the extension with,

%load_ext idgraph


  • By default, %%dgraph assumes a query.

    • %%dgraph --alter does an alteration

    • %%dgraph --mutate does a mutation

  • By default, %%dgraph assumes localhost:8080

    • %%dgraph --addr=remote-host:8080 overrides the default

    • The DGRAPH_ADDR environmental variable overrides default if the --addr flag isn’t set

  • By default, only the value associated with the data key in the response is shown.

    • %%dgraph --full-resp shows the full response including metadata.

    • %%dgraph --jmespath="query" allows you to extract part of the response with a jmespath query.

  • By default, each cell execution binds the extracted response to _dgraph and the full response to _dgraph_full

    • %%dgraph --into=name will bind the extracted response to name and the full response to {name}_full

  • By default, the cell contents are executed.

    • %%dgraph --skip skips execution.

      • Useful for mutations that are possibly dangerous on someone else’s computer.

  • Jinja

    • technically you can use templates in a directory. you almost certainly shouldnt though.


This package was created with Cookiecutter and the audreyr/cookiecutter-pypackage project template.


0.0.1 (2019-10-20)

  • Create initial version of idgraph.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

idgraph-0.0.1.tar.gz (11.2 kB view hashes)

Uploaded source

Built Distribution

idgraph-0.0.1-py2.py3-none-any.whl (6.2 kB view hashes)

Uploaded py2 py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page