Rga

프로그램 소개

RGA(ripgrep-all)는 ‘ripgrep’의 기능을 확장하여, 다양한 문서, 아카이브, 데이터베이스 파일 내부의 텍스트를 검색할 수 있게 하는 명령줄 도구입니다. 사용자는 일반적인 텍스트 파일뿐 아니라 PDF, DOCX, EPUB, SQLite, ZIP 등 여러 포맷의 파일에 저장된 내용을 하나의 명령어로 빠르게 검색할 수 있습니다.

주요 기능

RGA는 내장된 ‘어댑터’를 통해 여러 파일 형식을 처리합니다.

• 다양한 문서 형식 지원: PDF(poppler), DOCX, ODT, EPUB(pandoc) 등 Office 및 전자책 문서에서 텍스트를 추출하여 검색합니다.
• 아카이브 및 데이터베이스 검색: ZIP, TAR, GZ 등 압축 파일과 SQLite(.db, .sqlite3) 데이터베이스 내부 내용을 직접 검색할 수 있습니다.
• 미디어 메타데이터 검색: FFmpeg 어댑터를 사용하여 MKV, MP4, AVI 등 동영상 파일의 자막이나 메타데이터를 검색합니다.
• 정확한 파일 탐지: ‘–rga-accurate’ 옵션을 사용하면 파일 확장자가 아닌 실제 파일 내용(매직 바이트)을 기반으로 적절한 어댑터를 선택할 수 있습니다.

다운로드·설치 방법

Windows 사용자는 공식적으로 Chocolatey 또는 Scoop 패키지 관리자를 통한 설치가 지원됩니다. GitHub 릴리스에서 바이너리를 다운로드할 경우, 필요한 의존성(예: pdftotext)이 포함되지 않으므로 패키지 관리자 사용을 권장합니다.

• Scoop 사용 시: 터미널에서 scoop install rga 명령어를 실행합니다.
• Chocolatey 사용 시: 관리자 권한 터미널에서 choco install ripgrep-all 명령어를 실행합니다.

설치 중 ‘VCRUNTIME140.DLL could not be found’ 오류가 발생하면, Microsoft에서 제공하는 Visual C++ 재배포 가능 패키지(vc_redist.x64.exe)를 설치해야 합니다.

기본 사용법/명령어

RGA는 ‘ripgrep’와 동일한 문법을 사용합니다. 기본적인 사용법은 다음과 같습니다.

rga [RGA 옵션] [ripgrep 옵션] 검색어 [경로 ...]

예를 들어, 현재 디렉토리와 하위 폴더에 있는 모든 파일에서 ‘문자열’을 검색하려면 다음 명령어를 사용합니다.

rga '문서 검색'

특정 디렉토리만 검색하고 싶다면 경로를 지정할 수 있습니다.

rga '오류 로그' C:\문서\프로젝트

이런 경우에 유용합니다

RGA는 다음과 같은 업무나 개인 상황에서 유용하게 활용될 수 있습니다.

• 대규모 문서 아카이브 검색: 여러 해에 걸쳐 축적된 수백 개의 PDF 파일이나 Office 문서에서 특정 계약 조건, 회의록 내용 등을 신속하게 찾아야 할 때.
• 개발 및 데이터 분석: SQLite 데이터베이스 덤프 파일이나 코드 리포지토리 내의 압축된 로그 파일에서 특정 오류 메시지나 설정 값을 검색해야 할 때.
• 미디어 자료 조사: 다운로드한 동영상 파일들에서 특정 대사나 주제가 언급된 자막을 검색하여 관련 장면을 찾아야 할 때.

지원 환경·시스템 요구사항

RGA는 Windows(x64), macOS, Linux에서 사용할 수 있습니다. Windows에서 정상적으로 작동하려면 Visual C++ 재배포 가능 패키지가 설치되어 있어야 합니다. 기본적인 ‘ripgrep’ 기능 외에도 PDF, 문서 변환 등의 어댑터를 완전히 활용하려면 pandoc, poppler-utils, ffmpeg 같은 외부 도구가 추가로 설치되어야 합니다. 이는 패키지 관리자 설치 시 자동으로 처리되는 경우가 많습니다.

제한 사항·확인 사항

• Windows에서 GitHub 릴리스의 바이너리를 수동으로 다운로드하여 설치하면, PDF 검색에 필요한 pdftotext 등 의존성 도구가 포함되지 않아 일부 기능이 작동하지 않을 수 있습니다. 공식적으로는 Chocolatey 또는 Scoop을 통한 설치 방법을 지원합니다.
• 파일 형식별 어댑터는 외부 프로그램(pandoc, poppler, ffmpeg 등)에 의존합니다. 해당 프로그램이 설치되지 않은 환경에서는 해당 형식의 검색이 제한됩니다.
• 캐시 기능은 기본적으로 활성화되어 있어 반복 검색 시 성능이 향상되지만, ‘–rga-no-cache’ 옵션을 사용하여 비활성화할 수 있습니다.