mpt-api-python-client

A Python client for interacting with the MPT API.

Documentation

📚 Complete Usage Guide

Getting started

Prerequisites

• Docker and Docker Compose plugin (docker compose CLI)
• make
• CodeRabbit CLI (optional. Used for running review check locally)

Make targets overview

Common development workflows are wrapped in the Makefile. Run make help to see the list of available commands.

How the Makefile works

The project uses a modular Makefile structure that organizes commands into logical groups:

• Main Makefile (Makefile): Entry point that automatically includes all .mk files from the make/ directory
• Modular includes (make/*.mk): Commands are organized by category:
  • common.mk - Core development commands (build, test, format, etc.)
  • repo.mk - Repository management and dependency commands
  • migrations.mk - Database migration commands (Only available in extension repositories)
  • external_tools.mk - Integration with external tools

You can extend the Makefile with your own custom commands creating a local.mk file inside make folder. This file is automatically ignored by git, so your personal commands won't affect other developers or appear in version control.

Setup

Follow these steps to set up the development environment:

1. Clone the repository

git clone <repository-url>

cd mpt-api-python-client

2. Create environment configuration

Copy the sample environment file and update it with your values:

cp .env.sample .env

Edit the .env file with your actual configuration values. See the Configuration section for details on available variables.

3. Build the Docker images

Build the development environment:

make build

This will create the Docker images with all required dependencies and the virtualenv.

4. Verify the setup

Run the test suite to ensure everything is configured correctly:

make test

You're now ready to start developing! See Running the client for next steps.

Running the client

Before running, ensure your .env file is populated.

make run

Developer utilities

Useful helper targets during development:

make bash      # open a bash shell in the app container
make check     # run ruff, flake8, and lockfile checks
make check-all # run checks and tests
make format    # auto-format code and imports
make review    # check the code in the cli by running CodeRabbit

Configuration

The following environment variables are typically set in .env. Docker Compose reads them when using the Make targets described above.

Application

Environment Variable	Default	Example	Description
MPT_API_BASE_URL	-	https://portal.softwareone.com/mpt	SoftwareONE Marketplace API URL
MPT_API_TOKEN	-	eyJhbGciOiJSUzI1N...	SoftwareONE Marketplace API Token

E2E

Environment Variable	Default	Example	Description
MPT_API_TOKEN_CLIENT	-	eyJhbGciOiJSUzI1N...	SoftwareONE Marketplace API Client Token
MPT_API_TOKEN_OPERATIONS	-	eyJhbGciOiJSUzI1N...	SoftwareONE Marketplace API Operations Token
MPT_API_TOKEN_VENDOR	-	eyJhbGciOiJSUzI1N...	SoftwareONE Marketplace API Vendor Token
RP_API_KEY	-	pytest_XXXXXXXXXXXXXX	ReportPortal API key
RP_ENDPOINT	-	https://reportportal.example.com	ReportPortal endpoint
RP_LAUNCH	-	dev-env	ReportPortal launch