xray

파일 형태 분석

파일의 행 수, 열 수를 분석하고 헤더 행 위치, 구분자, 인코딩, 줄 끝남을 자동으로 감지합니다.

실제 컬럼 데이터 타입 추론

각 컬럼의 실제 데이터 타입을 텍스트, 정수, 통화 텍스트 등으로 세부적으로 추론하며, 선행 zéro나 통화 기호가 포함된 경우를 텍스트로 정확히 식별합니다.

데이터 품질 위험 요소 탐지

누락 값, 불일치 형식, 총계 행이 데이터로 위장한 경우, 혼합 타입 컬럼, 헤더가 제목 행 아래에 buried된 경우 등을 findings로 ranked 목록 형태로 보고합니다.

설치·시작·기본 사용

Windows에서는 WinGet을 통해 winget install Excelano.xray 명령으로 설치할 수 있으며, 설치 후 xray --install-skill로 Claude Code 스킬을 연동할 수 있습니다. Linux 및 macOS에서는 Homebrew, crates.io, 또는 curl을 사용한 설치 스크립트를 통해 설치 가능합니다. 설치는 xray path/to/file.csv 형태로 실행하며, 파이프 입력(... | xray -)도 지원합니다.

활용 예시

데이터 파일을 받아서 먼저 구조와 타입을 확인하고 싶을 때 xray를 실행하여 빠른 요약 보고서를 얻을 수 있습니다. 예를 들어, 계약서 지출 데이터에서 fy25_spend 컬럼이 통화 텍스트로 저장되어 숫자 연산 시 오류가 발생할 수 있음을 사전에 탐지할 수 있습니다.

지원 환경·요구사항

xray는 Windows 10 이상, Linux 배포본(Debian, Ubuntu 등), macOS에서 실행 가능하며, x64 및 arm64 아키텍처를 지원합니다. Rust 런타임이 필요하며, 공식 저장소에서 제공하는 바이너리 또는 패키지 관리자를 통해 설치할 수 있습니다.

버전·업데이트

현재 버전은 0.1.0이며, GitHub 저장소에서 정기적으로 업데이트됩니다. 릴리스 노트는 공식 릴리스 페이지에서 확인할 수 있습니다.

제한·라이선스·확인사항

xray는 읽기 전용 프로파일러이므로 파일을 수정하지 않습니다. CSV 및 DSV 형식만 지원하며 다른 파일 형식은 처리하지 않습니다. 그래픽 사용자 인터페이스(GUI)는 제공되지 않습니다. 라이선스는 MIT 라이선스로 배포되며, 자세한 내용은 저장소의 LICENSE 파일에서 확인할 수 있습니다.