Skip to main content

Helper library for curvenote versioning and tracking with Jupyter notebooks

Project description

The Curvenote Python client library and Command Line Interface. Access and interact with your projects via the Curvenote API.

Installation

~$ python -m pip install curvenote

Retrieve your API_TOKEN from curvenote support

CLI Usage

Access Curvenote projects via the command line. Get help on commands by:

~$ python -m curvenote --help
~$ python -m curvenote COMMAND --help

Command Summary

  • get-me list my user information
    ~$ python -m curvenote get-me API_TOKEN
  • get-my-projects list all projects that the current user has access to
    ~$ python -m curvenote get-my-projects API_TOKEN
  • push upload local documents into a curvenote project. .md (import and update existing) and .ipynb (import new only) files supported
    ~$ python -m curvenote push PATH PROJECT API_TOKEN
  • pull-as-latex create a local latex project and download contents of a Curvenote article into it
    ~$ python -m curvenote push TARGET PROJECT ARTICLE API_TOKEN --version=INTEGER

Python Client Usage

From Python - get curvenote blocks:

>>> import curvenote
>>> session = curvenote.Session(token=API_TOKEN)
>>> session.me()
>>> session.my_projects()
>>> session.get_block_latest(PROJECT_ID, BLOCK_ID)
>>> ...

From Python - push a local folder to a curvenote project:

>>> import curvenote
>>> session = curvenote.Session(token=AUTHORIZATION_TOKEN)
>>> proj = session.get_project("My Cool Project")
>>> session.push_folder("./cool_stuff/", proj)
>>> ...

There is also limited CLI functionality, though this still requires the Python installation:

Documentation

To build the documentation: * Clone the repository * Activate your virtual environment * pip install -r requirements_dev.txt * make docs

HTML doc pages will be written to ./build/html/

Development

To use this library (in development):

  • Clone the repository

  • Activate your virtual environment

  • pip install -r requirements.txt

  • Retrieve your API_TOKEN from curvenote support

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

curvenote-0.0.4.tar.gz (19.5 kB view details)

Uploaded Source

Built Distribution

curvenote-0.0.4-py3-none-any.whl (23.3 kB view details)

Uploaded Python 3

File details

Details for the file curvenote-0.0.4.tar.gz.

File metadata

  • Download URL: curvenote-0.0.4.tar.gz
  • Upload date:
  • Size: 19.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.3.0 pkginfo/1.7.0 requests/2.25.1 setuptools/52.0.0 requests-toolbelt/0.9.1 tqdm/4.59.0 CPython/3.7.6

File hashes

Hashes for curvenote-0.0.4.tar.gz
Algorithm Hash digest
SHA256 ec45b6b0d5ab341211a02149c823f80f3af6c95eb188bb5b412548fd465f4b43
MD5 86b91adc1f3eec3a85a5259f12c8db9e
BLAKE2b-256 460ff2f2d2e5e04adb0d8b3c21b3fa42faeb9ae6e3c591b6211320f070743c17

See more details on using hashes here.

File details

Details for the file curvenote-0.0.4-py3-none-any.whl.

File metadata

  • Download URL: curvenote-0.0.4-py3-none-any.whl
  • Upload date:
  • Size: 23.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.3.0 pkginfo/1.7.0 requests/2.25.1 setuptools/52.0.0 requests-toolbelt/0.9.1 tqdm/4.59.0 CPython/3.7.6

File hashes

Hashes for curvenote-0.0.4-py3-none-any.whl
Algorithm Hash digest
SHA256 30a8b81553d2f96268ba1b1b7f95b104f8ed3bf80478a19ccf723baf70afccd2
MD5 d7029b8774ae4f38b85f10f89cf8dfc5
BLAKE2b-256 8400d7ddf6acc28b8279b37d4c11aab99da9de143ecbba2e4fe3fed55e0ab8a9

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page