Name: nresx (Localization Resource File CLI)
SKU: -

소개

nresx는 localization resource 파일을 읽고 쓰며 변환하고 검증하는 명령줄 도구입니다. svjatpro가 개발한 이 도구는 Windows, Linux, macOS에서 실행되며 13가지 이상의 파일 형식을 지원합니다. .NET 없이도 실행 가능한 독립 실행형 바이너리로 제공되며, Chocolatey, Scoop, dotnet tool 등을 통해 설치할 수 있습니다.

상세정보

포맷 Agnostic 변환

nresx는 po, json, yaml, Android, iOS, resx, xliff 등 13가지 이상의 형식 간에 일대일 변환을 지원합니다. 하나의 모델과 명령 세트로 어떤 형식에서도 다른 형식으로 변환할 수 있습니다.

CI 친화적 설계

결정적 출력을 제공하며 문서화된 종료 코드를 사용합니다. 오류는 stderr로 출력되며, validate 명령은 CI 파이프라인에서 localization 건강 상태를 검사하는 게이트로 사용할 수 있습니다.

배치 처리 지원

모든 명령은 와일드카드와 -r 플래그를 받아들여 전체 디렉터리 트리를 한 번에 처리할 수 있습니다. 예를 들어 현재 디렉터리 트리의 모든 .resx 파일을 .yaml 형제로 변환할 수 있습니다.

독립 실행형 바이너리 (Windows)

GitHub 릴리스 페이지에서 nresx-win-x64.zip을 다운로드합니다. 압축을 해제한 후, 예를 들어 C:Toolsnresx에 추출하고 시스템 PATH에 추가합니다. PowerShell을 사용해 다음과 같이 설정할 수 있습니다:

[Environment]::SetEnvironmentVariable("Path", $env:Path + ";C:Toolsnresx", "User")

설정 후 셸을 다시 시작한 다음 nresx --version으로 설치를 확인합니다.

Chocolatey를 통한 설치 (Windows)

Chocolatey가 이미 설치되어 있다면 다음 명령으로 nresx를 설치할 수 있습니다:

choco install nresx

Scoop을 통한 설치 (Windows)

Scoop을 사용 중이라면 다음 명령으로 설치할 수 있습니다:

scoop install https://raw.githubusercontent.com/svjatpro/nresx.tools/main/packaging/scoop/nresx.json

.NET SDK를 통한 dotnet tool 설치

.NET SDK가 설치되어 있다면 다음 명령으로 전역 도구로 설치할 수 있습니다:

dotnet tool install -g nresx

파일 변환

단일 파일을 다른 형식으로 변환하려면 다음 명령을 사용합니다. 결과 파일은 원본 파일과 동일한 디렉터리에 생성됩니다:

nresx convert strings.po -f json

디렉터리 트리 일괄 변환

현재 디렉터리 트리의 모든 .resx 파일을 .yaml 형제로 변환하려면 -r 플래그를 추가합니다:

nresx convert *.resx -f yaml -r

파일 정보 확인

파일의 형식, 문화, 요소 수를 확인하려면 info 명령을 사용합니다:

nresx info strings.json

키-값 쌍 목록 출력

파일의 모든 키-값 쌍을 출력하려면 list 명령을 사용합니다. -t 플래그로 출력 형식을 사용자 지정할 수 있습니다:

nresx list strings.json

번역 리소스 검증

언어 간 파일의 drift, 중복, 미번역 항목을 검사하려면 validate 명령을 사용합니다. -r 플래그로 디렉터리 트리를 재귀적으로 검사하고, –warnings-as-errors로 경고를 오류로 처리할 수 있습니다:

nresx validate "locales/strings.*.json" -r --warnings-as-errors

이런 경우에 유용합니다

다국어 애플리케이션을 개발하거나 유지보수하는 개발자는 nresx를 통해 다양한 형식의 localization 파일을 일관되게 관리할 수 있습니다. 예를 들어 번역가가 반환한 .po 파일을 앱의 locale 파일로 통합하거나, CI 파이프라인에서 localization 건강 상태를 자동으로 검증하는 데 유용합니다.

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

독립 실행형 바이너리는 Windows x64, Linux x64, macOS Apple Silicon에서 실행됩니다. Linux에서는 libicu 런타임 의존성이 필요하며, 대부분의 데스크톱 배포판(Ubuntu, Debian, Fedora 등)에 기본 포함되어 있습니다. 최소 컨테이너에서는 수동 설치가 필요할 수 있습니다.

시스템 요구사항

별도의 시스템 요구사항이 등록되지 않았습니다.

nresx (Localization Resource File CLI)

소개