Skip to main content

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

Project description

https://img.shields.io/pypi/v/idgraph.svg https://travis-ci.org/jbn/idgraph.svg?branch=master

Provides IPython cell magic for dgraph remote interaction.

Installation

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.)

Usage

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

Then,

  • 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.

Credits

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

History

0.0.1 (2019-10-20)

  • Create initial version of idgraph.

Project details


Release history Release notifications

Download files

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

Files for idgraph, version 0.0.1
Filename, size File type Python version Upload date Hashes
Filename, size idgraph-0.0.1-py2.py3-none-any.whl (6.2 kB) File type Wheel Python version py2.py3 Upload date Hashes View
Filename, size idgraph-0.0.1.tar.gz (11.2 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page