Skill

test-component

Expert agent for writing and maintaining tests for Keboola Python components. Use for any testing work — adding tests, fixing tests, improving coverage, setting up VCR functional tests. Covers datadir tests, unit tests, mock-based tests, and VCR recording with keboola.datadirtest. Triggers whenever testing is mentioned or needed for a Keboola component, including /generate-vcr-tests.

Install

npx claudepluginhub keboola/ai-kit --plugin component-developer

Tool Access

This skill uses the workspace's default tool permissions.

Preview

Three levels, in priority order:

Supporting Assets

references/datadir-tests.mdreferences/unit-and-mock-tests.mdreferences/vcr-configs-format.mdreferences/vcr-debug-from-platform.mdreferences/vcr-quickstart.mdreferences/vcr-sanitizers.mdreferences/vcr-troubleshooting.md

SKILL.md

Similar Skills

design-system

Generates design tokens/docs from CSS/Tailwind/styled-components codebases, audits visual consistency across 10 dimensions, detects AI slop in UI.

team-skills-platform

163.7k

ui-demo

Records polished WebM UI demo videos of web apps using Playwright with cursor overlay, natural pacing, and three-phase scripting. Activates for demo, walkthrough, screen recording, or tutorial requests.

team-skills-platform

163.7k

kotlin-patterns

Delivers idiomatic Kotlin patterns for null safety, immutability, sealed classes, coroutines, Flows, extensions, DSL builders, and Gradle DSL. Use when writing, reviewing, refactoring, or designing Kotlin code.

team-skills-platform

163.7k

Stats

Parent Repo Stars8

Parent Repo Forks2

Last CommitMar 30, 2026

Actions

View Source View Plugin View on GitHub View README

Keboola Component Tester

Testing approach

Three levels, in priority order:

Datadir tests — functional tests using KBC_DATADIR structure; the primary method for all components
Unit tests — isolated logic tests for transformations, validation, config parsing
VCR functional tests — for components that call external HTTP APIs (preferred over manual mocks for extractors/writers)

Choosing VCR vs mocks

Use VCR (keboola.datadirtest) when the component makes external HTTP calls:

Records real API interactions once → replays deterministically in CI without credentials
More realistic than hand-rolled mocks; catches API contract changes
Required for extractors; recommended for writers that call external APIs

Use mocks (unittest.mock) when:

Testing pure logic, transformation, or validation code
Writing unit tests for individual functions
The component has no HTTP calls (applications, pure transformations)

VCR setup workflow

Add keboola.datadirtest>=2.0.0 to pyproject.toml dev dependencies, run uv sync -U
Copy tests/test_functional.py from component-developer:component-defaults assets
Read component (src/component.py, src/configuration.py, component_config/configSchema.json) and build tests/setup/configs.json — see vcr-configs-format.md
For authenticated APIs: ask user for real credentials → secrets.json (verify it's in .gitignore)
Scaffold to record: uv run python -m keboola.datadirtest scaffold [--secrets secrets.json] [--chain-state]
Check cassettes for unsanitized dynamic values — see vcr-sanitizers.md
Update .gitignore, Dockerfile (COPY tests/ tests), and push.yml (use python -m pytest)
Verify: python -m pytest locally and in Docker

See vcr-quickstart.md for all scaffold commands. See vcr-troubleshooting.md for common failures.

References

File	When to read
`references/datadir-tests.md`	Setting up datadir tests — directory structure, config.json, output assertions, state, error cases
`references/unit-and-mock-tests.md`	Unit tests, mocking patterns, freezegun, by component type
`references/vcr-configs-format.md`	Building configs.json — wrapped format, OAuth, writers, coverage guidelines
`references/vcr-sanitizers.md`	Adding VCR_SANITIZERS — DefaultSanitizer, ResponseUrlSanitizer, QueryParamSanitizer
`references/vcr-quickstart.md`	All scaffold/record commands and repo layout
`references/vcr-troubleshooting.md`	Common VCR failures and fixes
`references/vcr-debug-from-platform.md`	Regression tests from Keboola platform debug job output (stage_output.zip)