This is a CLI to interact with CloudBees Smart Tests.

Usage

See https://help.launchableinc.com/resources/cli-reference/ and https://help.launchableinc.com/sending-data-to-launchable/using-the-launchable-cli/getting-started/.

Development

Preparation

We recommend uv for dependency management:

# Install uv
curl -LsSf https://astral.sh/uv/install.sh | sh

# Install dependencies
uv sync --dev

In order to automatically format files with autopep8, this repository contains a configuration for pre-commit. Install the hook with uv run pre-commit install.

Load development environment

# Activate virtual environment
source .venv/bin/activate
# or use uv run for individual commands
uv run <command>

From this shell, run pip install -e . to create launchable wrapper script from the workspace. This is useful to test the CLI with real/local server.

Run tests cli

# Using poethepoet (recommended)
uv run poe test

# Direct command
uv run python -m unittest

Run tests exe_deploy.jar

bazel test ...

Available Development Tasks

This project uses poethepoet for task management. Available tasks:

# Show all available tasks
uv run poe --help

# Run tests
uv run poe test

# Run tests with XML output
uv run poe test-xml

# Run linting
uv run poe lint

# Run type checking
uv run poe type

# Format code
uv run poe format

# Build package
uv run poe build

# Install package locally
uv run poe install

Add dependency

# Add runtime dependency
uv add some-package

# Add development dependency
uv add --dev some-dev-package

Adding new command

smart_tests/args4p defines a small command line argument parsing framework for this CLI. See its README.md for the capabilities.

smart_tests/__main__.py defines the top level commands. Follow the code from there to see where sub-commands are registered.

Updating Python Version

When updating the Python version requirement, update the following files:

1. .python-version - Used by pyenv, uv, and local development
2. pyproject.toml - Update requires-python = ">=X.Y"
3. setup.cfg - Update python_requires = >=X.Y
4. .github/workflows/python-package.yml - Update python-version: ["X.Y"]
5. .github/workflows/python-publish.yml - Update uv python install X.Y
6. README.md - Update prerequisite section
7. CLAUDE.md - Update development notes

How to release

Create new release on Github, then Github Actions automatically uploads the module to PyPI.

How to update bundled documentation

The product documentation lives in smart_tests/docs/ and is bundled into the distributed package. To pull in the latest from the docsite repository:

uv run poe update-docs

Users can extract the bundled docs to the current directory with:

smart-tests get docs

How to update smart_tests/jar/exe_deploy.jar

./build-java.sh

Installing CLI

You can install the smart-tests command from either source or pypi.

Prerequisite

• >= Python 3.13
• >= Java 8

Install from source

$ pwd
~/cli

$ python setup.py install

Install from pypi

$ pip3 install --user --upgrade smart-tests~=1.0

Versioning

This module follows Semantic versioning such as X.Y.Z.

• Major (X)
  • Drastic update breaking backward compatibility
• Minor (Y)
  • Add new plugins, options with backward compatibility
• Patch (Z)-
  • Fix bugs or minor behaviors