talend-task 0.1.4

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 Processing API to trigger job runs and monitor status.

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 region.

• Access Token: Generate it in the Talend Management Console.
• API URL: Base endpoint URL for the API you will connect to.

Configuration is provided via environment variables:

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

Alternatively, you can define these variables in a .env file in the current directory:

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

---

Usage Examples

Direct mode

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

talend_task --job Job1

Interactive mode

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

talend_task

---

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