code-tester 0.1.0-base.2

A tool to test if the algorithm is right.
code-tester-0.1.0-base.2 is not a library.

CodeTester Documentation

δΈ­ζ–‡ζ–‡ζ‘£

πŸ“Œ Introduction

code-tester is a Rust-based algorithm validation tool that automates testing to help developers verify algorithm correctness and performance. It supports single-case testing, batch testing, and runtime limits.

πŸš€ Installation

crates.io

cargo install code-tester  

GitHub Release

Direct download available

πŸ“¦ Command Overview

test Command

Validates algorithm correctness and performance.

Syntax:

code-tester test [OPTIONS] <FILE>  

Arguments

Argument Type Description
<FILE> Required Path to the algorithm executable

Options

Option Shortcut Type Description
--input-file -i File Path Specify input file path
--ans-file -a File Path Reference answer/output file
--time-limit -t Number (ms) Maximum execution time in milliseconds
--data -d Path Test case directory/archive (supports .in/.ans pairs, folders, or ZIP files)
--no-input - Flag Indicates no input required

πŸ” Examples

Single Case Testing

# Test my_algo with input/answer files and 200ms timeout  
code-tester test my_algo --input-file input.txt --ans-file answer.txt --time-limit 200  

Batch Testing

# Use test directory (must contain test_cases1.in/test_cases1.ans etc.)  
code-tester test my_algo --data test_cases/  

# ZIP file support  
code-tester test my_algo --data examples.zip  

No-Input Testing

# For input-free algorithms  
code-tester test my_algo --no-input --ans-file answer.txt  

⚠️ Important Notes

  1. Time Unit: --time-limit uses milliseconds (e.g., 200ms = 0.2s)
  2. Archive Requirements: Ensure complete test file pairs after extraction
  3. Input Conflict: --no-input cannot coexist with --input-file
  4. Test Case Naming Rules:
    • Must contain matched example<number>.in and example<number>.ans files
    • Folder name must match file prefix:
      • βœ… Valid Examples:
        a/a1.in + a/a1.ans
        b.zip/b1.in + b.zip/b1.ans
      • ❌ Invalid Examples:
        a/b1.in (folder-name mismatch)
        test/test.in (missing numeric index)

πŸ“Š Version Info

code-tester --version  

πŸ’‘ Developer Guide

# Build from source  
git clone https://github.com/weiwei-cool/code-tester  
cd code-tester  
cargo build --release  

πŸ“ Contributing

We welcome PRs! Follow semantic versioning and include test cases for new features.

πŸ“„ License

MIT License