C/C++ 프로젝트를 Zig로 패키징하는 'All Your Codebase' 프로젝트

C와 C++ 프로젝트를 빌드하고 배포해 본 사람이라면 시스템 전역에 흩어진 의존성과 툴체인 설정 때문에 곤란을 겪은 경험이 있을 것이다. 'All Your Codebase(AYC)'는 바로 이 지점을 겨냥한 커뮤니티 프로젝트로, 기존 C/C++ 프로젝트를 Zig 빌드 시스템에 맞게 다시 포장한다. 목표는 단순하다. Zig 컴파일러 툴체인만 있으면 별도의 시스템 준비 없이 안정적으로 컴파일하고, 나아가 크로스 컴파일까지 손쉽게 할 수 있도록 만드는 것이다.

왜 Zig 빌드 시스템인가

AYC가 내세우는 핵심 논리는 일종의 의존성 교환이다. 프로젝트에 Zig에 대한 의존성을 하나 추가하는 대신, 그동안 알게 모르게 붙어 있던 여러 시스템 차원의 의존성을 걷어낸다. 더 일반화하면 Zig는 시스템 전역 설정에 대한 의존을 제거하되, 필요할 때는 사용자가 직접 opt-in 방식으로 시스템 라이브러리를 끌어다 쓸 수 있는 여지를 남긴다. 즉 기본값은 자립적이고 재현 가능한 빌드이고, 시스템 통합은 선택 사항이 된다.

이 접근의 부수 효과도 뚜렷하다. AYC가 만들어 놓은 build.zig 파일은 그 자체로 하나의 참고 예시가 된다. 원래 프로젝트를 관리하는 메인테이너 입장에서는 '내 프로젝트의 build.zig는 이렇게 생기면 되는구나' 하는 실제 사례를 볼 수 있다. 복잡한 Makefile이나 CMake 스크립트 대신 build.zig와 build.zig.zon 두 파일만으로 빌드가 성립한다는 점을 눈으로 확인시켜 주는 셈이다.

원저작자에게 되돌려주는 구조

AYC의 성격에서 흥미로운 대목은 이 패키징이 영구적인 포크를 지향하지 않는다는 점이다. 프로젝트 측은 '우리가 가져왔지만 기꺼이 돌려주겠다'는 태도를 명확히 한다. 만약 원본 프로젝트의 메인테이너가 자신의 빌드 파이프라인을 Zig 기반으로 개선하기로 결정하면, AYC 저장소에서 필요한 것을 그대로 업스트림으로 가져갈 수 있다. 이렇게 업스트림 통합이 완료되면 AYC는 해당 저장소를 아카이브 처리하고 사람들을 원본 저장소로 안내한다. 다운스트림 포크를 무한정 유지하는 대신, 원래 자리로 코드를 흘려보내는 것을 정상적인 종착점으로 삼는 구조다.

다만 여기에는 조건이 하나 붙는다. 업스트림 쪽의 통합이 AYC 버전보다 더 많은 시스템 의존성을 추가해서는 안 된다는 것이다. 예를 들어 AYC가 zstd를 allyourcodebase/zstd 패키지를 통해 의존하고 있다면, 메인테이너는 그 build.zig가 업스트림될 때까지 같은 방식으로 의존을 유지하거나, 아니면 시스템 라이브러리 통합(System Library Integration)을 이용해 사용자가 선택할 수 있게 열어 두어야 한다. 이 조건을 지켜야만 AYC가 안심하고 저장소를 아카이브할 수 있다는 논리다. 물론 다른 패키지 의존을 유지할 계획이 없더라도 빌드 코드를 자유롭게 업스트림하는 것은 언제든 환영이며, 이 경우 AYC는 다운스트림 포크를 계속 유지하겠다고 밝히고 있다.

실무자가 얻는 것과 유의할 점

실무적으로 보면 AYC는 두 부류의 사용자에게 각각 다른 가치를 준다. Zig 툴체인을 쓰는 개발자에게는 검증된 build.zig가 붙은 C/C++ 라이브러리를 바로 끌어다 쓸 수 있다는 편의가 있다. 반면 원본 프로젝트 메인테이너에게는 업그레이드 경로가 열린다. 저장소를 이미 이런 방식으로 정리한 경우라면 build.zig와 build.zig.zon 두 파일만 있으면 되지만, 기존의 다른 빌드 스크립트를 정리하고 Zig 빌드 스크립트를 다듬는 일은 메인테이너의 몫으로 남는다. 반대로 AYC가 더 꼼꼼하게 작업을 마쳐 둔 저장소라면 업스트림 작업이 한결 수월하지만, 그만큼 통합 시 주의 깊게 살펴봐야 할 부분이 있다.

프로젝트에 기여하려는 사람을 위한 절차도 명시돼 있다. 기여자는 kristoff에게 연락해 조직에 추가를 요청하고, 정해진 기본 규칙과 체크리스트를 따라야 한다. 저장소 작업을 마친 뒤에는 zig, zig-package 같은 태그를 붙여 검색성을 높이도록 권한다. 또한 통합 방식이 궁금하거나 보조 빌드 단계가 구현되지 않은 경우처럼 막히는 지점이 있으면 각 저장소의 Issue를 통해 질문할 수 있게 창구를 열어 두었다.

정리하면 AYC는 단순한 패키지 저장소를 넘어, C/C++ 생태계가 Zig 빌드 시스템으로 이행하는 과정을 매끄럽게 다리 놓는 역할을 자처한다. 재현 가능한 빌드와 크로스 컴파일이라는 실질적 이점을 제공하면서도, 최종적으로는 코드를 원저작자에게 돌려주는 것을 원칙으로 삼는다는 점이 특징이다. 다만 이는 어디까지나 Zig 툴체인 채택을 전제로 한 접근이므로, 기존 빌드 체계에 만족하거나 Zig 도입 여력이 없는 팀에는 당장의 실익이 제한적일 수 있다는 점은 감안해야 한다.