Cysharp/ConsoleAppFramework

어떤 프로젝트인가요?

핵심 기능

• 01런타임 의존성 없이 컴파일 시 인수 파싱 및 명령 디스패치 코드를 생성합니다.
• 02Native AOT를 지원하며 리플렉션과 박싱을 사용하지 않습니다.
• 03CancellationToken을 통해 Ctrl+C와 SIGTERM을 처리해 정상적으로 종료할 수 있습니다.
• 04명령 실행 전후에 필터(미들웨어) 파이프라인을 제공합니다.
• 05옵션 별칭을 포함한 도움말을 XML 문서 주석에서 생성합니다.
• 06DataAnnotations 유효성 검사와 명령 클래스의 의존성 주입을 지원합니다.

활용 사례

• Native AOT 바이너리로 게시해야 하는 작고 빠르게 시작되는 CLI 도구를 만들 때.
• 의존성 주입을 활용해 대규모 .NET 명령줄 도구를 중첩 명령으로 구성할 때.
• 장시간 실행 작업을 Ctrl+C로 안전하게 취소해야 하는 내부 배치형 도구를 작성할 때.

빠른 시작

1. 1

   프로젝트에 NuGet 패키지를 추가합니다

   dotnet add package ConsoleAppFramework
2. 2

   Program에서 람다 또는 메서드를 사용해 ConsoleApp.Run을 호출합니다

사용 전 알아둘 점

• !.NET 8 이상이 필요합니다. .NET 8 프로젝트에서는 C# 13 언어 버전을 명시적으로 설정해야 합니다.

포함된 컬렉션

토픽

자주 묻는 질문

ConsoleAppFramework은(는) 무엇인가요?

Source Generator로 컴파일 시 파싱 및 라우팅 코드를 생성하는, 의존성과 할당이 없고 AOT에 안전한 C# CLI 프레임워크입니다. ConsoleAppFramework는 명령줄 애플리케이션을 만들기 위한 C# 라이브러리입니다. 특성과 런타임 리플렉션에 의존하는 대신, ConsoleApp.Run에 전달된 람다 식이나 메서드를 분석해 컴파일 시 인수 파싱 및 디스패치 코드를 생성합니다. 따라서 프레임워크 자체에 대한 런타임 의존성이 없는 애플리케이션을 만들 수 있어 어셈블리 크기를 줄이고 Native AOT와의 호환성을 확보합니다.

ConsoleAppFramework은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

ConsoleAppFramework은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

ConsoleAppFramework은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. ConsoleAppFramework의 마지막 커밋은 2026년 11월 6일입니다.

ConsoleAppFramework은(는) 어디에 사용할 수 있나요?

Native AOT 바이너리로 게시해야 하는 작고 빠르게 시작되는 CLI 도구를 만들 때. 의존성 주입을 활용해 대규모 .NET 명령줄 도구를 중첩 명령으로 구성할 때. 장시간 실행 작업을 Ctrl+C로 안전하게 취소해야 하는 내부 배치형 도구를 작성할 때.

ConsoleAppFramework는 어떻게 설치하나요?

프로젝트에 NuGet 패키지를 추가합니다: dotnet add package ConsoleAppFramework Program에서 람다 또는 메서드를 사용해 ConsoleApp.Run을 호출합니다

ConsoleAppFramework은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/Cysharp/ConsoleAppFramework