java-test-library - SKILL.md Agent Skill

name: java-test-library description: Java 25 test library development patterns for crypto-scout-test including MockData, PodmanCompose, and RabbitMQ utilities license: MIT compatibility: opencode metadata: language: java framework: junit6 domain: testing

What I Do

Provide guidance for developing and maintaining the crypto-scout-test library, a Java 25 Maven library offering test support utilities.

Project Structure

crypto-scout-test/
├── src/main/java/.../test/
│   ├── Constants.java              # All configuration constants
│   ├── MockData.java               # Typed mock data loader
│   ├── PodmanCompose.java          # Container lifecycle
│   ├── DBUtils.java                # Database utilities
│   ├── StreamTestPublisher.java    # RabbitMQ Streams publisher
│   ├── StreamTestConsumer.java     # RabbitMQ Streams consumer
│   ├── AmqpTestPublisher.java      # AMQP publisher
│   ├── AmqpTestConsumer.java       # AMQP consumer
│   └── Assertions.java             # Test assertions
├── src/main/resources/
│   ├── bybit-spot/           # 12 JSON mock data files
│   ├── bybit-linear/         # 13 JSON mock data files
│   ├── crypto-scout/         # 6 JSON mock data files
│   └── podman/               # Container configuration
└── src/test/java/.../test/   # 9 test classes

Core Components

MockData

Typed API for loading bundled JSON fixtures:

// Load SPOT 1m klines
var spotKlines = MockData.get(MockData.Source.BYBIT_SPOT, MockData.Type.KLINE_1);
// Load LINEAR tickers
var linearTickers = MockData.get(MockData.Source.BYBIT_LINEAR, MockData.Type.TICKERS);
// Load crypto-scout FGI
var fgi = MockData.get(MockData.Source.CRYPTO_SCOUT, MockData.Type.FGI);

Sources: CRYPTO_SCOUT, BYBIT_SPOT, BYBIT_LINEAR

Types (17 total):

Timeframes: KLINE_1, KLINE_5, KLINE_15, KLINE_60, KLINE_240, KLINE_D, KLINE_W
Market data: TICKERS, PUBLIC_TRADE
Order books: ORDER_BOOK_1, ORDER_BOOK_50, ORDER_BOOK_200, ORDER_BOOK_1000
Linear only: ALL_LIQUIDATION
Crypto-scout: FGI, LPL, BTC_PRICE_RISK, BTC_RISK_PRICE

PodmanCompose

Container lifecycle management:

@BeforeAll
static void setUp() {
    PodmanCompose.up();  // Starts TimescaleDB + RabbitMQ, waits for readiness
}

@AfterAll
static void tearDown() {
    PodmanCompose.down();  // Stops containers, removes volumes
}

Waits for:

Database connectivity (port 5432)
RabbitMQ Streams (port 5552)

RabbitMQ Utilities

Streams Protocol (port 5552):

StreamTestPublisher.create(reactor, executor, environment, stream)
StreamTestConsumer.create(reactor, executor, environment, stream)

AMQP Protocol (port 5672):

AmqpTestPublisher.create(reactor, executor, connectionFactory, queue)
AmqpTestConsumer.create(reactor, executor, connectionFactory, queue)

Features:

Thread-safe using AtomicReference
ActiveJ ReactiveService integration
Automatic connection/channel management
5s confirmation timeout for AMQP publisher

DBUtils

// Check connectivity
DBUtils.canConnect();

// Clean tables for test isolation
DBUtils.deleteFromTables(dataSource, 
    "crypto_scout.bybit_spot_tickers", 
    "crypto_scout.bybit_spot_kline_1m");

Assertions

Assertions.assertTableCount("crypto_scout.bybit_spot_tickers", 5);

Configuration

All settings via system properties:

Property	Default	Description
`test.db.jdbc.url`	`jdbc:postgresql://localhost:5432/crypto_scout`	Database URL
`test.db.user`	`crypto_scout_db`	Database user
`test.db.password`	`crypto_scout_db`	Database password
`test.mq.host`	`localhost`	RabbitMQ host
`test.mq.port`	`5552`	RabbitMQ Streams port
`test.mq.user`	`crypto_scout_mq`	RabbitMQ user
`test.mq.password`	`crypto_scout_mq`	RabbitMQ password
`podman.compose.cmd`	`podman-compose`	Podman Compose binary
`podman.compose.up.timeout.min`	`3`	Container startup timeout
`podman.compose.down.timeout.min`	`1`	Container shutdown timeout
`podman.compose.ready.interval.sec`	`2`	Readiness check interval

Resource Files

Located in src/main/resources/:

Mock Data:

bybit-spot/ - 12 JSON files (klines, tickers, orderbooks, trades)
bybit-linear/ - 13 JSON files (includes allLiquidation)
crypto-scout/ - 6 JSON files (fgi, lpl, btc price/risk)

Podman Configuration:

podman/podman-compose.yml - Service definitions
podman/script/init.sql - Database initialization
podman/script/bybit_spot_tables.sql - Spot table schemas
podman/script/bybit_linear_tables.sql - Linear table schemas
podman/script/crypto_scout_tables.sql - Crypto scout table schemas
podman/rabbitmq/enabled_plugins - RabbitMQ plugins
podman/rabbitmq/rabbitmq.conf - RabbitMQ configuration
podman/rabbitmq/definitions.json - RabbitMQ definitions

When to Use Me

Use this skill when:

Implementing new test utilities or mock data fixtures
Understanding the library's component architecture
Configuring test environments with Podman containers
Working with RabbitMQ Streams or AMQP in tests
Managing database state in integration tests