FileQL

SQL-like 쿼리 실행

FileQL은 SQL과 유사한 구문을 사용하여 로컬 파일을 질의할 수 있습니다. 키워드는 대소문자를 구분하지 않습니다.

파일 시스템 접근

로컬 파일 시스템에 직접 접근하여 파일 및 디렉터리 정보를 조회할 수 있습니다.

파일 테이블 구조

FileQL은 파일을 테이블로 취급하며, 각 파일은 다음 열을 가집니다:

• path: 파일 경로
• parent: 부모 디렉터리 경로
• extension: 파일 확장자
• is_dir: 디렉터리 여부
• is_file: 파일 여부
• size: 파일 크기

함수 지원

FILES_COUNT 함수를 사용하여 디렉터리의 하위 항목 수를 계산할 수 있습니다.

설치 방법

FileQL은 다음 방법으로 설치할 수 있습니다:

• winget 사용: winget install fileql
• Cargo 사용: cargo install fileql
• 소스 코드에서 빌드: git clone https://github.com/AmrDeveloper/fileql.git 후 cargo build

기본 사용법

설치 후 명령 프롬프트 또는 PowerShell에서 fileql 명령을 실행합니다. 주요 옵션은 다음과 같습니다:

• -f, --files: 쿼리할 파일 경로
• -e, --excludes: 제외할 파일 경로
• -q, --query: 실행할 FileQL 쿼리
• -p, --pagination: 결과를 페이지 단위로 출력
• -ps, --pagesize: 페이지 크기 설정 (기본값: 10)
• -o, --output: 출력 형식 (render, json, csv)
• -a, --analysis: 쿼리 분석 출력

활용 예시

다음은 FileQL을 사용한 예시입니다:

• 모든 파일 조회: SELECT * FROM files
• 파일 수 계산: SELECT COUNT(path) FROM files
• 고유한 부모 디렉터리 조회: SELECT DISTINCT parent AS folders FROM files
• 디렉터리별 하위 항목 수: SELECT CHILDREN_COUNT(parent) FROM files

지원 환경

현재 증거에서는 Windows 환경에서 winget을 통한 설치가 확인됩니다. Cargo를 통한 설치도 가능하므로 Rust가 설치된 환경에서 사용할 수 있습니다.

버전 및 업데이트

최신 버전은 0.10.0이며, 2025년 2월 20일에 출시되었습니다. 이 버전에서는 GitQL 0.36.0으로의 마이그레이션과 윈도우 함수 지원이 추가되었습니다.

라이선스 및 확인 사항

FileQL은 MIT 라이선스로 배포됩니다. 자세한 내용은 공식 GitHub 저장소의 LICENSE 파일을 참조하십시오.