Skip to main content

Launchpy

Python wrapper for the Adobe Launch API.
This module is named launchpy.

Current version: 0.5.2. This version fixes GET retries and adds automatic HTTP 429 retries across all five connector methods. See the 0.5.2 release notes for details.

Installation

You can install the module by realising the following pip command:
pip install launchpy

You can access the version of the module that you run via the following attribute:
launchpy.__version__

Content of the module

This module is built around 7 main parts:

Get Started

A get started guide has been created to explain the different functionality. You can find a more detail description functionalities at datanalyst.info.

Main documentation

Most of the documentation has been imported from the datanalyst website here.

Release information

You can find release information here.

Proxy support

Pass a proxy URL to launchpy.configure(...), or add "proxy" to your JSON configuration file. The same proxy serves both HTTP and HTTPS. Proxy settings apply to OAuth authentication, API requests, and asynchronous property exports, with separate settings per organization.

launchpy.configure(
    org_id="your-org@AdobeOrg",
    client_id="your-client-id",
    secret="your-secret",
    scopes="your-scopes",
    proxy="http://proxy.example.com:8080",
)

The CLI accepts --proxy URL at startup and in the interactive config command. An explicit CLI proxy overrides the file setting. Without an explicit proxy, existing environment-based proxy behavior is unchanged. See the Python and JSON examples and CLI examples.

HTTP retries

The AdobeRequest connector always retries HTTP 429 responses for GET, POST, PUT, PATCH, and DELETE, even when their body is not JSON or retry=0. Rate-limit retries have no attempt limit and do not consume the configured retry budget. A request can therefore keep waiting while the API remains rate limited; it can be interrupted normally.

The connector honors Retry-After in seconds or HTTP-date format; absent or invalid values use exponential backoff starting at 45 seconds and capped at 300 seconds. The JSON-returning methods also always retry Adobe error code 429050.

The retry setting is reserved for other retryable errors: currently, GET responses that cannot be decoded as JSON. It specifies the number of additional attempts, with a default of 0. Set property.connector.retry = 3 or pass retry=3 to a connector method to override this budget; neither setting limits rate-limit retries.

Successful return values are unchanged: DELETE returns the HTTP status code, while the other methods return decoded JSON. GET also retries invalid JSON responses with a 30-second delay. Invalid JSON from write operations and network exceptions do not trigger retries, to avoid replaying writes that may already have succeeded. This policy applies to the five connector methods, not the separate OAuth token request or async property-extraction requests.

Metadata

Release files for launchpy 0.5.4

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for launchpy 0.5.4
File Size Uploaded Provenance Actions
launchpy-0.5.4.tar.gz 110.6 kB Without provenance Details for launchpy-0.5.4.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for launchpy 0.5.4
File Interpreter ABI Platform Actions
launchpy-0.5.4-py3-none-any.whl Python 3 none any Details for launchpy-0.5.4-py3-none-any.whl

Total release size: 185.3 kB

Release files / launchpy-0.5.4.tar.gz

Download URL launchpy-0.5.4.tar.gz
Size 110.6 kB
Tags Source
SHA-256 checksum
How to use checksums
d08fbb3758ff1439a20caf7f6e605acb9b7acc32683062472bc3988a0ff087d8
BLAKE2b-256 checksum
How to use checksums
d0afca62518f2f22a3765530b0934ddbeef13632092cd4392c0166ec1c73d569
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.13.3

Release files / launchpy-0.5.4-py3-none-any.whl

Download URL launchpy-0.5.4-py3-none-any.whl
Size 74.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
f5c2f1cba1d95915d9c5e42874d678ee09efe235ed72dabc3742fda3e99b35f4
BLAKE2b-256 checksum
How to use checksums
8d9c1846a8b5594ebb16e4b7faa628736acd0f1e2a1b7e74dd92bde9b922a405
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.13.3

Security for launchpy 0.5.4

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.5.4 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page