Repolode
antiwork

antiwork/shortest

자연어로 테스트를 작성하는 AI 기반 엔드투엔드 테스트 프레임워크로, Playwright와 Anthropic Claude를 기반으로 합니다.

스타
5,698
포크
341
열린 이슈
2
마지막 커밋
3개월 전

어떤 프로젝트인가요?

Shortest는 선택자와 단계별 스크립트를 작성하는 대신 자연어로 브라우저 테스트를 설명할 수 있는 엔드투엔드 테스트 프레임워크입니다. 각 테스트는 shortest() 호출에 전달하는 자연어 문자열이며, Anthropic Claude API를 사용하는 AI 모델이 Playwright 기반 브라우저에서 테스트 단계를 실행합니다.

init 명령으로 프레임워크를 설치하면 패키지가 dev dependency로 추가되고 shortest.config.ts 파일이 생성되며 .env.local에 Anthropic API 키를 입력할 자리표시자가 설정됩니다. 테스트는 설정 가능한 파일 패턴에 따라 검색되며, 명령줄에서 실행할 수 있습니다. 파일이나 줄 번호를 지정해 실행할 수도 있고, CI에서 headless 모드로 실행할 수도 있습니다. 브라우저 세션이 끝난 후 실행되는 콜백 함수에 데이터베이스 검사 같은 assertion을 추가할 수 있습니다. 라이프사이클 훅, 테스트 흐름 연결, API 엔드포인트 테스트도 지원합니다.

프로젝트에는 2단계 인증을 포함한 GitHub 로그인용 내장 헬퍼와 Mailosaur를 통한 이메일 검증용 헬퍼가 포함되어 있습니다. TypeScript로 작성되었으며 Next.js 애플리케이션을 대상으로 하고, examples 디렉터리에 예제가 제공됩니다.

핵심 기능

  • 01선택자 기반 스크립트 대신 자연어 설명으로 테스트를 작성합니다.
  • 02Anthropic Claude API를 사용해 브라우저에서 테스트 단계를 실행합니다.
  • 03Playwright 기반이며 브라우저 컨텍스트 옵션을 설정할 수 있습니다.
  • 042단계 인증을 포함한 GitHub 로그인을 지원합니다.
  • 05Mailosaur를 통해 로그인 이메일을 검증합니다.
  • 06라이프사이클 훅, 테스트 연결, API 엔드포인트 테스트를 지원합니다.

활용 사례

  • 불안정한 선택자를 계속 관리하지 않고 Next.js 앱에 엔드투엔드 테스트를 추가합니다.
  • 2FA를 포함한 로그인 흐름을 테스트합니다.
  • CI/CD 파이프라인에서 브라우저 테스트를 headless 모드로 실행합니다.
  • 콜백에서 UI 검사와 데이터베이스 assertion을 함께 수행합니다.

빠른 시작

  1. 1

    init 명령으로 프로젝트에서 Shortest를 초기화합니다

    npx @antiwork/shortest init
  2. 2

    .env.local에 Anthropic API 키(ANTHROPIC_API_KEY)를 추가합니다

  3. 3

    app/login.test.ts와 같은 자연어로 작성된 테스트 파일을 만듭니다

  4. 4

    모든 테스트를 실행합니다

    pnpm shortest

사용 전 알아둘 점

  • 테스트를 실행할 때마다 Anthropic Claude API를 호출하므로 API 키가 필요하며 사용 요금이 부과됩니다.
  • 테스트 결과는 AI 실행에 따라 달라질 수 있어 실행할 때마다 결과가 다를 수 있습니다.
  • GitHub 2FA 및 이메일 확인과 같은 일부 기능에는 추가 타사 서비스가 필요합니다.

포함된 컬렉션

토픽

자주 묻는 질문

shortest은(는) 무엇인가요?
자연어로 테스트를 작성하는 AI 기반 엔드투엔드 테스트 프레임워크로, Playwright와 Anthropic Claude를 기반으로 합니다. Shortest는 선택자와 단계별 스크립트를 작성하는 대신 자연어로 브라우저 테스트를 설명할 수 있는 엔드투엔드 테스트 프레임워크입니다. 각 테스트는 shortest() 호출에 전달하는 자연어 문자열이며, Anthropic Claude API를 사용하는 AI 모델이 Playwright 기반 브라우저에서 테스트 단계를 실행합니다.
shortest은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
shortest은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
shortest은(는) 아직 유지보수되고 있나요?
6개월 이내 업데이트. shortest의 마지막 커밋은 2026년 8월 6일입니다.
shortest은(는) 어디에 사용할 수 있나요?
불안정한 선택자를 계속 관리하지 않고 Next.js 앱에 엔드투엔드 테스트를 추가합니다. 2FA를 포함한 로그인 흐름을 테스트합니다. CI/CD 파이프라인에서 브라우저 테스트를 headless 모드로 실행합니다. 콜백에서 UI 검사와 데이터베이스 assertion을 함께 수행합니다.
shortest는 어떻게 설치하나요?
init 명령으로 프로젝트에서 Shortest를 초기화합니다: npx @antiwork/shortest init .env.local에 Anthropic API 키(ANTHROPIC_API_KEY)를 추가합니다 app/login.test.ts와 같은 자연어로 작성된 테스트 파일을 만듭니다 모든 테스트를 실행합니다: pnpm shortest
shortest은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/antiwork/shortest

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트