uncomment

언어 인식 렉싱

내장된 렉서는 다양한 프로그래밍 언어의 문자열 리터럴과 구문 규칙을 이해하여, 문자열 내부의 유사 주석을 실제 주석으로 오인하지 않습니다.

다양한 모드 지원

--mode 옵션을 통해 세 가지 동작을 선택할 수 있습니다: strip(기본값, 주석 제거), list(주석 목록 출력), count(주석 개수 세기).

커스터마이징 및 드라이 런

--langs 옵션으로 TOML 형식의 추가 언어 정의를 로드할 수 있으며, --dry-run으로 파일을 수정하지 않고 결과를 미리 볼 수 있습니다.

다운로드·설치 방법

Windows 사용자는 Chocolatey 패키지 관리자를 통해 간단히 설치할 수 있습니다. 관리자 권한으로 PowerShell을 열고 다음 명령을 실행합니다:

choco install uncomment

이 명령은 공식 Chocolatey 저장소에서 최신 버전을 다운로드하고 설치합니다. 설치 후 uncomment 명령을 바로 사용할 수 있습니다.

기본 사용법/명령어

단일 파일의 주석을 제거하여 원본 파일을 덮어쓰는 기본 사용법은 다음과 같습니다:

uncomment src/main.rs

이 명령은 src/main.rs 파일의 주석을 제거하고 변경 내용을 같은 파일에 저장합니다.

주요 옵션 설명

• --mode <MODE>: 수행할 동작 선택. strip(기본값), list, count 중 하나.
• --dry-run: 파일을 변경하지 않고 결과를 표준 출력으로 보여줍니다.
• -l, --lang <EXT>: 파일 확장자로 언어 강제 지정 (예: rs, py, js).
• -o, --output <FILE>: 결과를 특정 파일에 저장. 단일 파일 처리 시에만 사용 가능.
• --langs <FILE>: 추가 언어 정의를 포함한 TOML 파일 경로 지정.

사용 예시

Python 파일의 주석 개수를 세려면:

uncomment script.py --mode count

JavaScript 파일의 주석을 목록으로 보려면:

uncomment app.js --mode list

변경 전 결과를 미리 보려면:

uncomment config.json --dry-run

HTML 파일의 주석을 제거하고 새 파일에 저장하려면:

uncomment index.html -o index_clean.html

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

uncomment은 Windows, macOS, Linux에서 실행됩니다. Windows에서는 Chocolatey를 통해 설치되며, 이는 표준 Windows 10 이상 환경에서 작동합니다. 추가적인 런타임 의존성은 없으며, 실행 파일 하나로 동작합니다.

최신 버전·업데이트

현재 버전은 0.1.0이며, GitHub 저장소의 main 브랜치에서 최신 소스를 확인할 수 있습니다. 업데이트는 Chocolatey를 통해 choco upgrade uncomment 명령으로 수행할 수 있습니다.

제한 사항·확인 사항

이 도구는 소스 코드 파일의 주석 처리만을 목적으로 하며, 바이너리 파일이나 비텍스트 형식에는 적용할 수 없습니다. 언어 정의를 커스터마이징하려면 TOML 형식의 구성 파일을 이해해야 합니다.