Skip to main content

Nuxeo REST API Python client

Project description

Client Library for Nuxeo API

Build Status Quality Coverage

The Nuxeo Python Client is a Python client library for the Nuxeo Automation and REST API. It works with Python 3.6+.

This is an ongoing project, supported by Nuxeo.

Getting Started

The installation is as simple as:

python -m pip install -U --user nuxeo

The client can make use of the Amazon S3 provider, to install its requirements:

python -m pip install -U --user "nuxeo[s3]"

The client is compatible with OAuth2 mechanism, to install its requirements:

python -m pip install -U --user "nuxeo[oauth2]"

And to install several flavors of requirements:

python -m pip install -U --user "nuxeo[oauth2, s3]"

Import

Then, use the following import statement to have access to the Nuxeo API:

from nuxeo.client import Nuxeo

Documentation

Check out the API documentation.

Requirements

The Nuxeo Python client works only with:

  • the Nuxeo Platform >= LTS 2015

  • requests >= 2.12.2 (for unicode authentication)

  • setuptools >= 30.3.0

Quick Start

This quick start guide will show how to do basics operations using the client.

Connect to the Nuxeo Platform

The easiest way to connect to the Nuxeo Platform with a basic authentication is passing a tuple containing the username and the password to the client, like so:

nuxeo = Nuxeo(auth=('Administrator', 'Administrator'))

You can then use the nuxeo object to interact with the Platform. If you want to use a specific instance, you can specify the base_url like so:

nuxeo = Nuxeo(
    host='http://demo.nuxeo.com/nuxeo/',
    auth=('Administrator', 'Administrator')
)

Download/Upload Configuration

In the nuxeo/constants.py file, you have several constants that are used throughout the client that you can change to fit your needs. Some of them are:

  • CHECK_PARAMS (False by default), to check operation’s parameters for each and every HTTP calls.

  • CHUNK_LIMIT (10 MiB by default), the size above which the upload will automatically be chunked.

  • CHUNK_SIZE (8 KiB by default), the size of the chunks when downloading.

  • MAX_RETRY (5 by default), the number of retries for connection error on any HTTP call.

  • UPLOAD_CHUNK_SIZE (20 MiB by default), the size of the chunks when uploading.

Run NXQL Queries

You can run queries in NXQL (NXQL is a subset of SQL, you can check how to use it in the documentation). Here, we are first fetching a workspace, and then using its uid to build a query which will find all its children that have a File or Picture type, and are not deleted.

# Fetch a workspace
ws = nuxeo.documents.get(path='/default-domain/workspaces/ws')

# Build a query using its UID
nxql = ("SELECT * FROM Document WHERE ecm:ancestorId = '{uid}'"
        "   AND ecm:primaryType IN ('File', 'Picture')"
        "   AND ecm:currentLifeCycleState != 'deleted'")
query = nxql.format(uid=ws.uid)

# Make the request
search = nuxeo.client.query(query, params={'properties': '*'})

# Get results
entries = search['entries']

entries will be a list containing a dict for each element returned by the query.

Usage

Now that your client is set up, here are pages to help you with the main functions available:

You can also check the API documentation of this Python client for further options.

Contributing

See our contribution documentation.

Setup

git clone https://github.com/nuxeo/nuxeo-python-client
cd nuxeo-python-client
python -m pip install -e ".[oauth2, s3]"

Test

A Nuxeo Platform instance needs to be running on http://localhost:8080/nuxeo for the tests to be run, and then:

python -m pip install -U --user tox
tox

Sentry

We use Sentry to catch unhandled errors from tests. You can tweak it before running tox.

It can be disabled:

export SKIP_SENTRY=1

You can also customize the Sentry DSN for your own team:

export SENTRY_DSN="XXX"

And customize the Sentry environment too:

# Note that the default value is "testing"
export SENTRY_ENV="testing"

Deploying

Releases are fully automated, have a look at that GitHub Action.

Reporting Issues

You can follow the developments in the Nuxeo Python Client project of our JIRA bug tracker: NXPY.

You can report issues on answers.nuxeo.com.

License

Apache License 2.0 Copyright (c) Nuxeo

About Nuxeo

Nuxeo dramatically improves how content-based applications are built, managed and deployed, making customers more agile, innovative and successful. Nuxeo provides a next generation, enterprise ready platform for building traditional and cutting-edge content oriented applications. Combining a powerful application development environment with SaaS-based tools and a modular architecture, the Nuxeo Platform and Products provide clear business value to some of the most recognizable brands including Verizon, Electronic Arts, Sharp, FICO, the U.S. Navy, and Boeing. Nuxeo is headquartered in New York and Paris. More information is available at www.nuxeo.com.

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

nuxeo-6.1.2.tar.gz (44.4 kB view details)

Uploaded Source

Built Distribution

nuxeo-6.1.2-py3-none-any.whl (53.7 kB view details)

Uploaded Python 3

File details

Details for the file nuxeo-6.1.2.tar.gz.

File metadata

  • Download URL: nuxeo-6.1.2.tar.gz
  • Upload date:
  • Size: 44.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.12.7

File hashes

Hashes for nuxeo-6.1.2.tar.gz
Algorithm Hash digest
SHA256 cbc5b2db534dd380154f8800c7ac5881a2fd8aef5f061a8cdb780a1538e66e27
MD5 165556a6a15d33302e339703468b6e2c
BLAKE2b-256 49abcd48c18e5124efa4bad3e953b09f6e7eb50952534e717c419aa1f729bff9

See more details on using hashes here.

File details

Details for the file nuxeo-6.1.2-py3-none-any.whl.

File metadata

  • Download URL: nuxeo-6.1.2-py3-none-any.whl
  • Upload date:
  • Size: 53.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.12.7

File hashes

Hashes for nuxeo-6.1.2-py3-none-any.whl
Algorithm Hash digest
SHA256 009d7c82f90ef310cb1d21559f989312f985ce338e2bf53495fe8857086b1a1a
MD5 37df1167c1d8d232ee195222c3fd1522
BLAKE2b-256 7908daac1faa5835098c67fb7607e3617f58571d1f5c0e269ac7ef7b5fb13661

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