소스 생성기 만들기 7부 - 소스 생성기 '마커 특성' 문제 해결 - 1부

[dimohy]

소스 생성기 만들기 1부 - 증분 생성기 만들기

이 글은 Andrew Lock님의 소스 생성기 만들기 연재를 번역한 글입니다. 이 게시물에서는 증분 소스 생성기를 만드는 방법을 설명합니다. 사례 연구로 ToStringFast()라는 열거형에 대한 확장 메서드를 생성하기 위한 소스 생성기를 설명합니다. 이 방법은 내장 ToString()에 상응하는 것보다 훨씬 빠르며 소스 생성기를 사용하는 것은 사용하기 쉽다는 것을 의미합니다! 이것은 내가 최근에 만든 NetEscapades.EnumGenerators라는 소스 생성기를 기반으로 합니다. GitHub 또는 NuGet에서 찾을 수 있습니다. 소스 생성기에 대한 약간의 배경 지식을 제공하고 열거형에서 ToString()을 호출하는 문제부터 시작하겠습니다. 나머지 게시물에서는 증분 생성기를 만드는 과정을 단계별로 설명합니다. 최종 결과는 동작하는 소스 생성기이지만 게시물 끝에서 제한 사항을 설명합니다. 소스 생성기 프로젝트 만들기 열거형에 대한 세부정보 수집 마커 특성 추…

소스 생성기 만들기 2부 - 스냅샷 테스트로 증분 생성기 테스트

이 글은 Andrew Lock님의 소스 생성기 만들기 연재를 번역한 글입니다. 이것은 소스 생성기 만들기 시리즈의 두 번째 게시물입니다. 이전 게시물에서 소스 생성기를 만드는 방법을 자세히 설명했지만 테스트라는 매우 중요한 단계를 놓쳤습니다. 이 게시물에서는 알려진 문자열에 대해 수동으로 소스 생성기를 실행하고 출력을 평가하여 소스 생성기를 테스트하는 방법 중 하나를 설명합니다. 스냅샷 테스트는 생성기가 계속 작동하는지 확인하는 좋은 방법을 제공하며, 이 게시물에서는 뛰어난 Verify 라이브러리를 사용합니다. 요약: EnumExtensions 생성기 간단히 요약하자면, 이전 게시물에서 enum에서 ToString()을 호출하는 문제에 대해 논의했으며(느림), 소스 생성기를 사용하여 동일한 기능을 제공하는 100배 빠른 확장 메서드를 만드는 방법을 설명했습니다. 따라서 다음과 같은 간단한 enum의 경우: public enum Colour { Red = 0, …

소스 생성기 만들기 3부 - 통합 테스트 및 NuGet 패키징

이 글은 Andrew Lock님의 소스 생성기 만들기 연재를 번역한 글입니다. 소스 생성기 만들기 연재의 세 번째 게시물 입니다. 이 시리즈의 첫 번째 게시물에서는 .NET 6 증분 소스 생성기를 만드는 방법을 설명했고, 두 번째 게시물에서는 Verify와 함께 스냅샷 테스트를 사용하여 생성기를 단위 테스트하는 방법을 설명했습니다. 이것은 소스 생성기를 구축하는 데 필수적인 첫 번째 단계이며 스냅샷 테스트는 빠르고 쉽게 디버깅할 수 있는 테스트 접근 방식을 제공합니다. 패키지 테스트의 또 다른 필수 부분은 통합 테스트입니다. 즉, 프로젝트 컴파일 프로세스의 일부로 실제로 사용될 소스 생성기를 테스트하는 것을 의미합니다. 마찬가지로 소스 생성기를 NuGet 패키지로 제공하려는 경우 프로젝트를 사용할 때 NuGet 패키지가 올바르게 작동하는지 테스트해야 합니다. 이 게시물에서는 이 시리즈에서 만든 소스 생성기에 대해 3가지 작업을 수행할 것입니다: 통합 테스트 프로젝트 만…

소스 생성기 만들기 4부 - 마커 특성으로 생성된 코드 커스터마이징

이 글은 Andrew Lock님의 소스 생성기 만들기 연재를 번역한 글입니다. 이 글은 소스 생성기 만들기 시리즈의 네 번째 게시물 입니다. 이 시리즈의 이전 게시물에서 증분 소스 생성기를 만드는 방법, 단위 및 통합 테스트 방법, NuGet 패키지에 패키지하는 방법을 보여주었습니다. 이 게시물에서는 추가 특성으로 마커 특성을 확장하여 소스 생성기의 동작을 사용자 지정하는 방법을 설명합니다. 소스 생성기 마커 특성 확장 모든 소스 생성기의 첫 번째 단계 중 하나는 프로젝트에서 소스 생성에 참여해야 하는 코드를 식별하는 것입니다. 소스 생성기는 특정 유형이나 멤버를 찾을 수 있지만 또 다른 일반적인 접근 방식은 마커 특성을 사용하는 것입니다. 이것이 이 시리즈의 첫 번째 게시물에서 설명한 접근 방식입니다. 첫 번째 게시물에서 설명한 [EnumExtensions] 특성은 다른 특성이 없는 단순한 특성이었습니다. 즉, 소스 생성기에 의해 생성된 코드를 사용자 정의할 방법이 없었…

소스 생성기 만들기 5부 - 유형 선언의 네임스페이스 및 유형 계층 찾기

이 글은 Andrew Lock님의 소스 생성기 만들기 연재를 번역한 글입니다. 이것은 소스 생성기 만들기의 다섯번째 게시물 입니다. 소스 생성기에 대한 다음 포스트에서는 소스 생성기를 만들 때 필요한 몇 가지 일반적인 패턴을 보여줍니다: 주어진 클래스/구조체/열거형 구문에 대한 유형의 네임스페이스를 결정하는 방법 클래스/구조체/열거형의 이름을 계산할 때 중첩 유형을 처리하는 방법 표면적으로는 간단한 작업처럼 보이지만 예상보다 까다로울 수 있는 미묘한 부분이 있습니다. 클래스 구문의 네임스페이스 찾기 소스 생성기에 대한 일반적인 요구 사항은 지정된 class 또는 기타 구문의 namespace를 결정하는 것입니다. 예를 들어 지금까지 이 시리즈에서 내가 설명한 EnumExtensions 생성기는 고정된 namespace인 NetEscapades.EnumGenerators에서 확장 메서드를 생성합니다. 한 가지 개선 사항은 원래 enum과 동일한 namespace에서 확장…

소스 생성기 만들기 6부 - 소스 제어에 소스 생성기 출력 저장

이 글은 Andrew Lock님의 소스 생성기 만들기 연재를 번역한 글입니다. 이것은 소스 생성기 만들기의 여섯 번째 게시물 입니다. 이 게시물에서는 소스 생성기의 출력을 디스크에 유지하여 소스 제어 및 코드 검토의 일부가 될 수 있도록 하는 방법, 파일이 출력되는 위치를 제어하는 방법, 소스 생성기가 대상 프레임워크에 따라 다른 출력을 생성하는 경우를 처리하는 방법에 대해 설명합니다. 소스 생성기는 기본적으로 아티팩트를 생성하지 않습니다. 소스 생성기의 가장 큰 장점 중 하나는 컴파일러에서 실행된다는 것입니다. 따라서 별도의 빌드 단계가 필요하지 않으므로 t4 템플릿과 같은 다른 소스 생성 기술보다 더 편리합니다. 그러나 한 가지 잠재적인 단점은 소스 생성기가 컴파일러 내에서 실행된다는 사실에서 비롯됩니다. 이는 IDE 컨텍스트에 있지 않을 때 소스 생성기의 효과를 보기 어렵게 만들 수 있습니다. 예를 들어, 소스 생성기를 사용하는 GitHub의 pull 요청을 검토하…

소스 생성기 만들기 8부 - 소스 생성기 '마커 특성' 문제 해결 - 2부

이 글은 Andrew Lock님의 소스 생성기 만들기 연재를 번역한 글입니다. 이것은 소스 생성기 만들기의 여덟 번째 게시물 입니다. 이전 게시물에서 마커 특성, 소스 생성기에서 마커 특성을 사용하는 방법, 사용자 프로젝트에서 마커 특성을 참조하는 방법을 결정하는 문제에 대해 설명했습니다. 이 게시물에서는 내가 시도한 몇 가지 접근 방식과 내가 결정한 최종 접근 방식에 대해 설명합니다. 외부 dll에서 마커 특성 참조 요약하자면 마커 특성은 소스 생성기가 코드 생성에 사용해야 하는 유형을 제어하는 데 사용되는 간단한 특성이며 소스 생성기에 옵션을 전달하는 방법을 제공합니다. 예를 들어 내 StronglyTypedId 프로젝트를 사용하면 [StronglyTypedId] 특성으로 struct를 장식할 수 있습니다. 소스 생성기는 해당 특성의 존재를 사용하여 구조체에 대한 형식 변환기 및 속성 생성을 트리거합니다. 마찬가지로 Microsoft.Extensions.Logging…