Skip to main content
CircleCI build status Latest version on PyPI

Tools for using the Civis Platform with Jupyter notebooks

Installation and Setup

Run the following commands in a shell:

pip install civis-jupyter-extensions
jupyter nbextension install --py civis_jupyter_ext
jupyter nbextension enable --py civis_jupyter_ext

In order to use the extensions, make sure to have your Civis Platform API key in your local environment as CIVIS_API_KEY.

Magic Commands

To load the magic commands, use the following in ipython or a Jupyter notebook:

%load_ext civis_jupyter_ext

You can also autoload the magic commands every time a notebook is opened by adding:

c.InteractiveShellApp.extensions = ['civis_jupyter_ext']

to your ~/.ipython/profile_default/ipython_config.py.

SQL Queries

To get a table preview, use the cell magic like this:

%%civisquery my-database
select * from dummy.table limit 10;

To return a DataFrame for further processing, use the line magic like this:

df = %civisquery my-database; select * from dummy.table;

Metadata

Release files for civis-jupyter-extensions 1.2.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for civis-jupyter-extensions 1.2.0
File Size Uploaded
civis_jupyter_extensions-1.2.0.tar.gz 5.9 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for civis-jupyter-extensions 1.2.0
File Interpreter ABI Platform
civis_jupyter_extensions-1.2.0-py3-none-any.whl Python 3 none any Details

Total release size: 11.4 kB

Release files / civis_jupyter_extensions-1.2.0.tar.gz

Download URL civis_jupyter_extensions-1.2.0.tar.gz
Size 5.9 kB
Tags Source
SHA-256 checksum
How to use checksums
f7731dddf8706cb26dc9c0bcb90279f3bc87aa3a0fdf8ac66b4c95eefc77ae00
BLAKE2b-256 checksum
How to use checksums
ff7df5b414c79e736139c9de71bf1d8494c4737aacd91c6e3612dfd5ab0d8d32
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/5.0.0 CPython/3.12.2

Release files / civis_jupyter_extensions-1.2.0-py3-none-any.whl

Download URL civis_jupyter_extensions-1.2.0-py3-none-any.whl
Size 5.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
9d157c1d36c61a3e834b5218e86d3dbbc617dd461531427b02761dc3b535b285
BLAKE2b-256 checksum
How to use checksums
595357c20df029cf887d3ad867b19d70298de30d967ed3d801c0c556f583a1fc
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/5.0.0 CPython/3.12.2

Release history Release notifications | RSS feed

This release

1.2.0 This release

2 release files

1.1.0

2 release files

1.0.0

1 release file

0.1.3

1 release file

0.1.2

1 release file

0.1.1

1 release file

0.1.0

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page