revoize 0.3.0

Revoize Python SDK

Revoize SDK

This package allows you to interact with Revoize through Python.

Installation

To install:

pip install revoize

Basic usage

To use this package you will need to have created an account with Revoize and received an API Key from the Revoize Support team.

To enhance your file (my-file.wav) with Revoize you can either use the CLI:

revoize-enhance \
    --api-key **** \
    --input-file-path my-file.wav \
    --output-file-path my-file-revoize.wav

or through the Python API:

from revoize import RevoizeClient

client = RevoizeClient(api_key="***")
client.enhance_file("my-file.wav", "my-file-revoize.wav")

Advanced usage

Additional parameters

You can also specify some processing parameters:

• output loudness - in LUFS, between -32 and -8

Using the CLI you can specify this through the --output-loudness parameter.

Using the Python API:

from revoize.api import RevoizeClient
from revoize.schema import EnhancementParameters

client = RevoizeClient(username="****", password="****")
params = EnhancementParameters(loudness=-20)
client.enhance_file("my-file.wav", "my-file-revoize.wav", params)

Using with a different Revoize tenant

You may need to use this SDK against a different Revoize environment than our global production. In that case, you should be provided a dedicated revoize_url. This should be passed to the RevoizeClient constructor like:

from revoize.api import RevoizeClient
client = RevoizeClient(
    api_key="****",
    revoize_url=revoize_url,
)

After this setup, you can use the client object as usual.

Publishing to PyPI

This section contains a guide for maintainers about publishing to PyPI.

Before you can publish updates to this package you need to go through a few steps of configuration:

0. Globally install poetry (https://python-poetry.org/) and poethepoet (https://poethepoet.natn.io/)
1. Create a PyPI account.
2. Contact Revoize admins to add you to package maintainers.
3. Create a PyPI API token.
4. Configure Poetry to use the API token with poetry config pypi-token.pypi <token>

You can then issue updates with:

1. poe bump-version (major|minor|patch)
2. Commit the change, have it reviewed and merged
3. poe publish

Testing

To test the SDK against production environment, all you need to do is run:

TEST_API_KEY="<your Revoize API Key>" poe test