talend-task 0.1.5

CLI for running Talend Cloud jobs

talend-task

CLI for running Talend Cloud jobs

• Copyright (c) 2026 Corey Goldberg
• Development: GitHub
• Releases: PyPI
• License: MIT

---

Status

Latest Version
Build/Tests (CI)
Supported Python Versions

---

About

talend_task is a Python CLI for running Talend Cloud jobs, including ETL pipelines, workflows, and tasks. It uses the Talend Cloud Processing API to trigger job runs and monitor status.

In the CLI, a "job" refers to a runnable Talend Task. Running a job creates a Talend Execution.

Select a job interactively, or specify one directly with --job.

---

Installation

Install the package from PyPI:

pip install talend-task

CLI

After installation, the talend_task command is available in your shell.

CLI Options:

$ talend_task --help
usage: talend_task [-h] [--debug] [--wait] [--activity] [--job NAME] [--timeout SECS]
                   [--poll-interval SECS]

Talend Cloud CLI

options:
  -h, --help            show this help message and exit
  --debug               enable debug logging
  --wait                wait for job to complete and return status
  --activity            show recent runs without executing job (cannot be used with --wait)
  --job NAME            job name
  --timeout SECS        timeout (requires --wait, default: none)
  --poll-interval SECS  polling interval (requires --wait, default: 5)

---

Configuration

The CLI requires an Access Token and an API URL for your Talend Cloud region.

• API URL: Talend Cloud regional API endpoint.
• Access Token: Generate in Talend Management Console.

Configuration is provided via environment variables:

export API_URL=https://api.<region>.cloud.talend.com
export ACCESS_TOKEN=<access-token>

(region = us, eu, us-west, etc)

Alternatively, define them in a .env file in the current directory:

API_URL=https://api.<region>.cloud.talend.com
ACCESS_TOKEN=<access-token>

---

Usage Examples

Direct mode

Run a job by providing --job <name>:

talend_task --wait --job Job1

Interactive mode

Run the CLI without specifying a job to select and execute one from a menu:

talend_task --wait

Activity mode

Show recent runs for a job without executing it:

talend_task --activity --job Job1

---

Screenshots

Interactive mode

Direct mode

---

Development

• Install as editable package with required development/testing dependencies:

  pip install --editable --group dev --group test .
  

• Run all tests:

  pytest
  

• Run linting and formatting:

  tox -e lint
  

• Run validation, linting, formatting, and all tests across all supported/installed Python environments:

  tox
  

Project Structure

./
├── .github/
│   └── workflows/
│       └── test.yml
├── src/
│   └── talend_task/
│       ├── __init__.py
│       ├── cli.py
│       └── talend_client.py
├── tests/
│   ├── test_cli.py
│   └── test_talend_client.py
├── pyproject.toml
└── tox.ini