Skip to main content

Quickstart

New users? Use Option 1: Interactive Wizard for the fastest setup.

Advanced users? See Option 2: Manual Configuration for full control.

1. Create a configuration​

testbench-defect-service init

This single command walks you through:

It creates a complete config.toml when finished.

2. Start the service​

testbench-defect-service start

3. Open Swagger UI​

Visit http://127.0.0.1:8030/docs to explore the API interactively.

4. Quick API check​

curl -u "ADMIN_USERNAME:PASSWORD" http://127.0.0.1:8030/projects

That's it! Your service is ready to use.

Option 2: Manual Configuration​

1. Install optional dependencies (if needed)​

Choose the extras for your backend. See Installation for available options.

2. Create the configuration file​

Create a new file called config.toml in the root directory of your installation. Start from a minimal example. Here is one for the JSONL client:

# config.toml
[testbench-defect-service]
client_class = "testbench_defect_service.clients.JsonlDefectClient"
host = "127.0.0.1"
port = 8030

[testbench-defect-service.client_config]
defects_path = "defects/jsonl/"

For other clients see JSONL or Jira.

3. Set credentials​

The API uses HTTP Basic Auth. Generate a hashed password:

testbench-defect-service set-credentials

This prompts for username and password and stores a secure hash in config.toml.

4. Start the service​

testbench-defect-service start

5. Open Swagger UI​

Visit http://127.0.0.1:8030/docs.

6. Quick API check​

curl -u "ADMIN_USERNAME:PASSWORD" http://127.0.0.1:8030/projects
tip

Use testbench-defect-service configure to update specific parts of your configuration later without starting from scratch.

API documentation endpoints​

Once the service is running, these endpoints are available without authentication:

EndpointDescription
/docsInteractive Swagger UI
/docs/openapi.jsonOpenAPI specification (JSON)
/openapi.yamlOpenAPI specification (YAML)

Next steps​