<div id="readability-page-1" class="page"><div>
 01 May 2025
 
 <div>
 
<a href="https://github.com/swiftlang/swift-testing/blob/e2ec0411e5f7407fc2d325c9feea8f0ac10a60e2/Sources/Testing/Test%2BDiscovery.swift#L26">Test+Discovery.swift#L26</a>를 보면, <code>__🟠$test_container__</code> 문자열이 포함된 타입 이름을 찾을려는 것을 <code>_testContainerTypeNameMagic</code> 속성 이름을 통해 알 수 있습니다.



<img src="https://minsone.github.io/image/2025/05/01.png">



또한, 아래 all 속성에서 <code>enumerateTypes(withNamesContaining:)</code> 를 이용하여 <code>__🟠$test_container__</code> 문자열이 포함된 타입을 추출하여, 해당 타입이 <code>__TestContainer.Type</code> 타입인지 체크를 한 뒤, <code>__tests</code> 를 꺼내어 <code>Sequence</code>에 넣어, 테스트를 수행할려는 것을 확인할 수 있습니다.

<code>enumerateTypes(withNamesContaining:)</code> 함수는 <a href="https://github.com/swiftlang/swift-testing/blob/e2ec0411e5f7407fc2d325c9feea8f0ac10a60e2/Sources/Testing/Test%2BDiscovery.swift#L69">Test+Discovery.swift#L69</a>에서 찾을 수 있습니다.



<img src="https://minsone.github.io/image/2025/05/02.png">



이 함수에서 실질적인 동작을 수행하는 함수인 <code>swt_enumerateTypes(withNamesContaining:_:_:)</code>를 찾아야 합니다.

이 함수는 <a href="https://github.com/swiftlang/swift-testing/blob/5b4d6d6f7d4e0dbca4dd6593e0c8862022388d7c/Sources/_TestingInternals/include/Discovery.h#L40">Discovery.h#L40</a>에서 찾을 수 있습니다. <code>swt_enumerateTypesWithNamesContaining</code> 함수로, Swift에서 이름을 축약해서 사용할 수 있도록 <code>SWT_SWIFT_NAME(swt_enumerateTypes(withNamesContaining:_:_:))</code> 코드를 작성한 것을 확인할 수 있습니다.



<img src="http://127.0.0.1:4000/image/2025/05/03.png">



이제 <code>swt_enumerateTypesWithNamesContaining</code> 함수가 구현된 <a href="https://github.com/swiftlang/swift-testing/blob/5b4d6d6f7d4e0dbca4dd6593e0c8862022388d7c/Sources/_TestingInternals/Discovery.cpp#L509">Discovery.cpp</a>를 확인해봅시다.

<div><pre><code>void swt_enumerateTypesWithNamesContaining(const char *nameSubstring, void *context, SWTTypeEnumerator body) {
 enumerateTypeMetadataSections([=] (const SWTSectionBounds&lt;SWTTypeMetadataRecord&gt;&amp; sectionBounds, bool *stop) {
 for (const auto&amp; record : sectionBounds) {
 auto contextDescriptor = record.getContextDescriptor();
 if (!contextDescriptor) {
 // This type metadata record is invalid (or we don't understand how to
 // get its context descriptor), so skip it.
 continue;
 } else if (contextDescriptor-&gt;isGeneric()) {
 // Generic types cannot be fully instantiated without generic
 // parameters, which is not something we can know abstractly.
 continue;
 }

 // Check that the type's name passes. This will be more expensive than the
 // checks above, but should be cheaper than realizing the metadata.
 const char *typeName = contextDescriptor-&gt;getName();
 bool nameOK = typeName &amp;&amp; nullptr != std::strstr(typeName, nameSubstring);
 if (!nameOK) {
 continue;
 }

 if (void *typeMetadata = contextDescriptor-&gt;getMetadata()) {
 body(sectionBounds.imageAddress, typeMetadata, stop, context);
 }
 }
 });
}
</code></pre></div>

<code>enumerateTypeMetadataSections</code> 함수를 통해 현재 프로세스에 로드된 Swift 타입 메타데이터 섹션을 열거하고, 각 섹션 내의 모든 타입 메타데이터 레코드를 반복 처리합니다.

메타데이터 레코드가 유효하지 않거나, 제네릭이면 건너뜁니다.

<code>const char *typeName = contextDescriptor-&gt;getName();</code> 에서 타입 이름을 가져와서, 해당 이름에 <code>__🟠$test_container__</code> 문자열이 포함되어 있는지 검사하고, 일치하면 타입 메타데이터를 가져와 이미지 주소, 타입 메타데이터, 중지 플래그, 컨텍스트 정보를 전달합니다.

즉, 타입 이름에 주어진 문자열이 포함되는 Swift 타입들을 찾아 넘겨주는 역할을 합니다. 이 방식은 enum, struct, class 등의 모든 타입을 찾아내기 위에 사용할 수 있습니다.

이를 이용하면, 타입 메타데이터를 스캔하는 기능을 만들어낼 수 있습니다.



<h2 id="참고자료">참고자료</h2>

<ul>
 <li><a href="https://github.com/swiftlang/swift-testing">Swift Testing</a></li>
 <li><a href="https://medium.com/eureka-engineering/displaying-all-swiftui-previews-in-a-storybook-app-1dd8e925d777">Displaying all SwiftUI Previews in a Storybook app</a>
 <ul>
 <li><a href="https://github.com/eure/Storybook-ios">eure/Storybook-ios</a></li>
 </ul>
 </li>
 <li>GitHub
 <ul>
 <li><a href="https://github.com/minsOne/DIContainer/blob/d331a2c64ceefef5ea67bb0e46d0d0ae71aac750/Sources/DIContainer/Scanner/MachOLoader/MachOLoader.swift">minsone/DIContainer</a></li>
 <li><a href="https://github.com/p-x9/MachOKit">p-x9/MachOKit</a></li>
 </ul>
 </li>
</ul>

 </div>

 
 <ul>
 <li></li>
 
 


 
 
 	<li><a href="about:/tags.html#type%20scanner-ref">type scanner 2</a></li>
 
 	<li><a href="about:/tags.html#swift-ref">swift 144</a></li>
 
 	<li><a href="about:/tags.html#testing-ref">testing 2</a></li>
 
 	<li><a href="about:/tags.html#Swift%20Testing-ref">Swift Testing 2</a></li>
 
 



 </ul>
 

 <hr>
 
 <hr>
 




 </div></div>

민소네

Test+Discovery.swift#L26를 보면, __🟠$test_container__ 문자열이 포함된 타입 이름을 찾을려는 것을 _testContainerTypeNameMagic 속성 이름을 통해 알 수 있습니다.
또한, 아래 all 속성에서 enumerateTypes(withNamesContaining:) 를 이용하여 __🟠$test_container__ 문자열이 포함된 타입을 추출하여, 해당 타입이 __TestContainer.Type 타입인지 체크를 한 뒤, __tests 를 꺼내어 Sequence에 넣어, 테스트를 수행할려는 것을 확인할 수 있습니다.
enumerateTypes(withNamesContaining:) 함수는 Test+Discovery.swift#L69에서 찾을 수 있습니다.
이 함수에서 실질적인 동작을 수행하는 함수인 swt_enumerateTypes(withNamesContaining:_:_:)를 찾아야 합니다.
이 함수는 Discovery.h#L40에서 찾을 수 있습니다. swt_enumerateTypesWithNamesContaining 함수로, Swift에서 이름을 축약해서 사용할 수 있도록 SWT_SWIFT_NAME(swt_enumerateTypes(withNamesContaining:_:_:)) 코드를 작성한 것을 확인할 수 있습니다.
이제 swt_enumerateTypesWithNamesContaining 함수가 구현된 Discovery.cpp를 확인해봅시다.
void swt_enumerateTypesWithNamesContaining(const char *nameSubstring, void *context, SWTTypeEnumerator body) {
 enumerateTypeMetadataSections([=] (const SWTSectionBounds<SWTTypeMetadataRecord>& sectionBounds, bool *stop) {
 for (const auto& record : sectionBounds) {
 auto contextDescriptor = record.getContextDescriptor();
 if (!contextDescriptor) {
 // This type metadata record is invalid (or we don't understand how to
 // get its context descriptor), so skip it.
 continue;
 } else if (contextDescriptor->isGeneric()) {
 // Generic types cannot be fully instantiated without generic
 // parameters, which is not something we can know abstractly.
 continue;
 }
 // Check that the type's name passes. This will be more expensive than the
 // checks above, but should be cheaper than realizing the metadata.
 const char *typeName = contextDescriptor->getName();
 bool nameOK = typeName && nullptr != std::strstr(typeName, nameSubstring);
 if (!nameOK) {
 continue;
 }
 if (void *typeMetadata = contextDescriptor->getMetadata()) {
 body(sectionBounds.imageAddress, typeMetadata, stop, context);
 }
 }
 });
}
enumerateTypeMetadataSections 함수를 통해 현재 프로세스에 로드된 Swift 타입 메타데이터 섹션을 열거하고, 각 섹션 내의 모든 타입 메타데이터 레코드를 반복 처리합니다.
메타데이터 레코드가 유효하지 않거나, 제네릭이면 건너뜁니다.
const char *typeName = contextDescriptor->getName(); 에서 타입 이름을 가져와서, 해당 이름에 __🟠$test_container__ 문자열이 포함되어 있는지 검사하고, 일치하면 타입 메타데이터를 가져와 이미지 주소, 타입 메타데이터, 중지 플래그, 컨텍스트 정보를 전달합니다.
즉, 타입 이름에 주어진 문자열이 포함되는 Swift 타입들을 찾아 넘겨주는 역할을 합니다. 이 방식은 enum, struct, class 등의 모든 타입을 찾아내기 위에 사용할 수 있습니다.
이를 이용하면, 타입 메타데이터를 스캔하는 기능을 만들어낼 수 있습니다.
참고자료
Swift Testing
Displaying all SwiftUI Previews in a Storybook app
 
eure/Storybook-ios
GitHub
 
minsone/DIContainer
p-x9/MachOKit

[Swift] Type Scanner (2) - Swift Testing을 분석하여 Test 타입 찾기

댓글