Tests that find your code, not your folders.

🚀 Quick Start

npm install --save-dev adaptive-tests

const { discover } = require('adaptive-tests');

test('finds my service automatically', async () => {
  const UserService = await discover({
    name: 'UserService',
    type: 'class',
    methods: ['create', 'update', 'delete']
  });

  const service = new UserService();
  expect(service.create({ name: 'Ada' })).toBeTruthy();
});

📖 Documentation

Getting Started

• Why Adaptive Tests? - The business case with ROI
• Framework Comparison - vs Jest, Mocha, Pytest, JUnit
• How It Works - Technical deep dive
• Migration Guide - Migrate existing tests
• Best Practices - Patterns and tips

Framework Guides

• React Quick Start
• Vue.js Quick Start
• Express Quick Start
• Java Quick Start
• PHP Quick Start

Reference

• API Reference - Complete API docs
• Error Messages Guide - Detailed error explanations
• CI/CD Strategy - Integration strategies
• Troubleshooting - Problem solving
• Common Issues - Known issues

GitHub Integration

• GitHub Action
• Automated Publishing

🎯 Why Adaptive Tests?

Save $200,000+ per year on test maintenance. Tests that break from moving files cost your team 15-20% of their time. Adaptive Tests eliminates this entirely.

The Problem

Traditional tests break when you refactor:

// This breaks when you move Calculator.js
import { Calculator } from '../src/utils/Calculator';

The Solution

Adaptive tests find your code automatically:

// This works no matter where Calculator lives
const Calculator = await discover({ name: 'Calculator' });

→ Read the full engineering case

✨ Features

• 🔍 Smart Discovery - Finds classes, functions, and modules by structure
• 🚀 Zero Configuration - Works out of the box with Jest
• 🌍 Multi-language - Core JS/TS; others beta/experimental
• ⚡ Fast - AST-based parsing with intelligent caching
• 🛠️ VS Code Extension - Visual discovery tools and scaffolding
• 🔄 CI/CD Ready - GitHub Actions integration

💬 Community

• GitHub Discussions - Ask questions, share ideas
• Issue Tracker - Report bugs, request features
• Examples - See it in action

📊 Language Support

Language	AST Parser	Status
JavaScript	Babel	✅ Stable
TypeScript	TypeScript Compiler	✅ Stable
Python	Native ast module	🟡 Beta
Java	JavaParser	🟡 Beta
PHP	token_get_all / nikic/php-parser	🟡 Beta
Ruby	Ripper	🧪 Experimental
Go	go/parser (via tree‑sitter bindings)	🧪 Experimental
Rust	Lezer (rust)	🧪 Experimental
Wolfram	CodeParse	🧪 Experimental

Status legend: Stable = production‑ready; Beta = broadly usable with caveats; Experimental = early support, subject to change.

🤝 Contributing

We welcome contributions! See our Contributing Guide.

📄 License

MIT - See LICENSE for details.