vertopal 1.0.2

Convert your files in terminal using Vertopal API

Vertopal-CLI

Vertopal-CLI is a small, yet powerful utility for converting digital files to a variety of file formats using Vertopal public API.

You can use Vertopal-CLI by either terminal commands or importing as Python package.

Installing Vertopal-CLI

Vertopal-CLI is available on PyPI:

python -m pip install vertopal

You can also download the most recent version of Vertopal-CLI binaries for MacOS, Windows, and Linux from the releases page or the product page.

Installer

An automatic installer is available for each different platform. It will run an install script that downloads and copy Vertopal-CLI binaries to the correct location.

Using macOS Terminal:

curl https://run.vertopal.com/cli/macos | bash

On Windows using PowerShell:

curl.exe https://run.vertopal.com/cli/windows | iex

Using Linux Terminal:

curl https://run.vertopal.com/cli/linux | bash

Using Vertopal-CLI

To use Vertopal-CLI you need to obtain an App-ID and a Security Token.

Converting files using terminal commands are very simple:

vertopal convert document.ipynb --to pdf

To view full command-line help, execute vertopal --help and vertopal convert --help in terminal.

Setting App ID and Security Token

Before executing vertopal convert commands in terminal, you need to set your obtained App-ID and Security Token in global configuration file:

vertopal config --app "your-app-id" --token "your-security-token"

Importing as Python package

Importing vertopal as a Python package gives you more control and flexibility over each individual task:

>>> import vertopal
>>> response = vertopal.API.upload(
...     filename="document.pdf",
...     filepath="/home/vertopal/document.ipynb",
...     app="your-app-id",
...     token="your-security-token",
... )
>>> response
<Response [200]>
>>> json_response = response.json()
>>> json_response["result"]["output"]["connector"]
'the-connector-of-the-upload-task'