Name: Vut
SKU: -

소개

Vut은 프로젝트 내 다양한 파일에 버전 번호를 자동으로 전파하는 유틸리티입니다. 저장소 내 여러 파일에서 버전을 일관되게 관리해야 할 때 사용되며, 템플릿, 버전 소스 업데이트, 파일 업데이터 세 가지 메커니즘을 제공합니다. Rust로 작성되었으며, Chocolatey 패키지를 통해 Windows에서 간편하게 설치할 수 있습니다. 버전 관리의 반복 작업을 자동화하여 개발 효율성을 높이는 도구입니다.

상세정보

템플릿 기반 파일 생성

Vut은 .vutemplate 확장자를 가진 템플릿 파일을 찾아 {{Version}}과 같은 변수를 실제 버전 값으로 치환하여 파일을 생성합니다. 예를 들어 C# 프로젝트에서 AppVersion.cs.vutemplate 템플릿을 사용하면 버전이 포함된 AppVersion.cs 파일을 자동으로 만들어 코드 내에서 버전을 참조할 수 있습니다.

버전 소스 업데이트

권위 있는 버전 소스(VERSION 파일, Cargo.toml, package.json 등)를 기준으로 다른 버전 소스를 동기화할 수 있습니다. 이를 통해 프로젝트 내 다양한 패키지 매니페스트의 버전을 일관되게 유지할 수 있습니다.

정규식 기반 파일 업데이터

템플릿 사용이 어려운 텍스트 파일 내에서 정규식을 이용해 특정 버전 패턴을 찾아 교체할 수 있습니다. TOML 설정에서 파일 업데이터를 정의하고 glob 패턴으로 대상 파일을 지정하여 자동으로 버전을 업데이트할 수 있습니다.

다운로드·설치 방법

Windows에서는 Chocolatey 패키지 관리자를 통해 Vut을 간편하게 설치할 수 있습니다. 관리자 권한으로 명령 프롬프트 또는 PowerShell을 열고 다음 명령을 실행하면 됩니다.

choco install vut

설치 후 vut 명령이 PATH에 등록되어 어디서든 사용할 수 있습니다. GNU/Linux 및 기타 운영체제에서는 Rust를 설치하고 소스 코드를 클론한 후 cargo build –release 로 빌드하여 사용할 수 있습니다.

기본 사용법/명령어

Vut은 프로젝트 루트에서 버전 관리를 시작하기 위해 설정 파일을 생성하는 것을 권장합니다. 먼저 다음 명령으로 기본 설정 파일을 만들 수 있습니다.

vut init

이 명령은 VERSION 파일과 vut.toml 설정 파일을 생성합니다. 예시 설정과 주석을 포함한 상세한 설정 파일을 생성하려면 다음 명령을 사용합니다.

vut init –example

버전을 올리려면 bump 명령을 사용합니다. major, minor, patch, prerelease, build 중 원하는 구성 요소를 지정할 수 있습니다.

vut bump minor

버전을 특정 값으로 직접 설정하려면 set 명령을 사용합니다.

vut set 1.0.2-beta.3+build42

현재 버전 정보를 조회하려면 get 명령을 사용합니다. json 형식으로 출력하면 모든 버전 변수를 확인할 수 있습니다.

vut get json

버전을 변경하지 않고 템플릿을 다시 생성하거나 파일을 업데이트하려면 generate 명령을 사용합니다.

vut generate

이런 경우에 유용합니다

여러 프로젝트나 파일이 동일한 버전을 공유해야 하는 저장소에서 Vut은 유용합니다. 예를 들어 C 라이브러리와 그에 대한 NuGet 패키지, 웹 프론트엔드의 package.json이 모두 같은 버전을 가져야 할 때, 한 곳에서 버전을 올리면 관련 파일들이 자동으로 업데이트됩니다. 이는 릴리스 과정에서 버전 불일치로 인한 오류를 방지하고 배포 프로세스를 안정화하는 데 도움이 됩니다.

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

Vut은 Windows에서 Chocolatey 패키지로 제공되며, GNU/Linux 및 기타 Unix-like 시스템에서는 Rust 툴체인을 이용해 소스에서 빌드하여 사용할 수 있습니다. Windows에서는 choco install vut 명령으로 설치 후 바로 사용할 수 있으며, 다른 플랫폼에서는 Rust 설치 및 저장소 클론이 선행되어야 합니다.

제한 사항·확인 사항

Vut을 효과적으로 사용하려면 프로젝트 루트에 권한 있는 버전 소스(VERSION 파일, Cargo.toml, package.json 중 하나)가 존재하거나 설정 파일을 통해 지정되어야 합니다. 버전 소스가 없는 상태에서 템플릿이나 파일 업데이터 기능을 사용하려면 먼저 vut init 으로 버전 소스를 생성해야 합니다. 일부 고급 기능은 설정 파일이 필수이므로, 초기 설정 단계를 생략하지 않는 것이 좋습니다.

시스템 요구사항

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

Vut

소개