add post

Author: minsOne

.ruby-version

@@ -0,0 +1 @@
+3.2.2

Gemfile

@@ -1,6 +1,7 @@
 source 'https://rubygems.org/'
 
 gem 'github-pages', group: :jekyll_plugins
+gem 'webrick'
 
 group :jekyll_plugins do
   gem "jekyll-mermaid"

Gemfile.lock

@@ -251,6 +251,7 @@ GEM
     tzinfo (2.0.6)
       concurrent-ruby (~> 1.0)
     unicode-display_width (1.8.0)
+    webrick (1.9.2)
     zeitwerk (2.6.15)
 
 PLATFORMS
@@ -259,6 +260,7 @@ PLATFORMS
 DEPENDENCIES
   github-pages
   jekyll-mermaid
+  webrick
 
 BUNDLED WITH
    2.2.31

README.md

@@ -1,5 +1,29 @@
 # minsone.github.io
 
-## License
+## 로컬 개발 환경 설정 (Mac)
+
+이 프로젝트는 Jekyll을 사용하여 구축되었습니다. 로컬에서 서버를 띄워 포스팅을 미리 보려면 아래 단계를 따르세요.
+
+### 1. 자동 설정 스크립트 실행
+프로젝트 루트에 포함된 `setup_jekyll.sh` 스크립트를 사용하면 `rbenv`, `Ruby`, `Bundler` 및 필요한 모든 라이브러리를 한 번에 설치하고 서버를 실행합니다.
+
+```bash
+# 실행 권한 부여 (필요한 경우)
+chmod +x setup_jekyll.sh
+
+# 환경 설정 및 서버 실행
+./setup_jekyll.sh
+```
 
+### 2. 수동 서버 실행
+설치가 이미 완료된 상태에서 서버만 다시 띄우고 싶을 때는 아래 명령어를 사용하세요.
+
+```bash
+# 초안(Drafts) 포함 및 증분 빌드(--incremental)로 서버 실행
+bundle exec jekyll serve --drafts --incremental
+```
+
+---
+
+## License
 MIT

_config.yml

@@ -1,6 +1,5 @@
 plugins:
   - jekyll-mermaid
-gems: [jekyll-mermaid]
 
 # This is the default format. 
 # For more see: http://jekyllrb.com/docs/permalinks/

_posts/2026/02/2026-02-13-conditional-swift-macros-generating-development-code-vs-production-dummy-macros.md

@@ -0,0 +1,88 @@
+---
+layout: post
+title: "[Swift][Macro] 환경별 Swift 매크로 분기 처리: 환경에 따라 다른 매크로 호출"
+tags: [Swift, Macro, Conditional Compilation, Build Configuration]
+---
+{% include JB/setup %}
+
+Swift 매크로를 사용하다보면 개발 환경에서 생성된 코드가 운영 환경에서는 불필요한 경우가 발생할 수 있습니다. 특정 Protocol을 구현한 Mock 객체를 생성하는 매크로를 사용한다고 가정해봅시다. [swift-spyable](https://github.com/Matejkob/swift-spyable), [Mockable](https://github.com/Kolos65/Mockable) 등의 매크로를 이용해서 Mock 객체를 쉽게 생성할 수 있습니다.
+
+이들 매크로의 코드는 전처리기를 이용해서 `#if DEBUG ... #endif` 구문을 사용해서 개발 환경에서만 생성되도록 할 수 있습니다.
+
+```swift
+@Mockable
+protocol MyService {
+    func doSomething()
+}
+
+#if DEBUG
+final class MyServiceMock: MyService {
+    var doSomethingCallCount = 0
+    func doSomething() {
+        doSomethingCallCount += 1
+    }
+}
+#endif
+```
+
+하지만 이러한 방식은 생성된 매크로 코드를 다른 모듈에서 인식을 할 수 없는 단점이 있습니다.(예: Mock 객체를 다른 모듈에서 사용해야 하는 경우, 인식이 되지 않음. 단순 코드 작성하면 동작하나, 자동완성이 되지 않음.)
+
+개발 환경에서는 생성된 코드를 통해 테스트를 진행하고, 운영 환경에서는 코드가 생성되지 않도록 하는 방법은 없을까요?
+
+## 매크로 인터페이스 분기 처리
+
+매크로 템플릿을 통해 생성하면 기본 매크로인 `stringify` 를 만들 수 있습니다.
+
+```swift
+@freestanding(expression)
+public macro stringify<T>(_ value: T) -> (T, String) =
+    #externalMacro(module: "MyMacroMacros", type: "StringifyMacro")
+```
+
+외부에서는 매크로를 호출하지만, 실제로는 매크로 모듈의 매크로를 호출하는 방식입니다. 즉, 여기서는 매크로 모듈에 전처리기를 이용해서 분기 처리를 할 수 있습니다.
+
+```swift
+#if DEBUG
+
+@freestanding(expression)
+public macro stringify<T>(_ value: T) -> (T, String) = 
+    #externalMacro(module: "MyMacroMacros", type: "StringifyMacro")
+
+#else
+
+@freestanding(expression)
+public macro stringify<T>(_ value: T) -> (T, String) = 
+    #externalMacro(module: "MyMacroMacros", type: "DummyMacro")
+
+#endif
+```
+
+이와 같이 매크로 인터페이스를 분기 처리하면, 환경에 관계없이 동일하게 매크로를 호출할 수 있습니다.
+
+### DummyMacro의 역할
+
+여기서 `DummyMacro`는 운영 환경에서 매크로가 불필요한 작업을 수행하지 않도록 설계합니다. 예를 들어, `stringify` 매크로의 경우 `DummyMacro`는 단순히 입력받은 값을 그대로 반환하기만 하도록 구현할 수 있습니다.
+
+```swift
+// MyMacroMacros/DummyMacro.swift
+public struct DummyMacro: ExpressionMacro {
+    public static func expansion(
+        of node: some FreestandingMacroExpansionSyntax,
+        in context: some MacroExpansionContext
+    ) -> ExprSyntax {
+        // 단순히 입력 인자를 그대로 반환하거나 결과값만 전달
+        return "\(node.argumentList.first!.expression)"
+    }
+}
+```
+
+이렇게 하면 운영 환경의 바이너리에는 복잡한 Mock 생성 로직이나 디버깅용 코드가 포함되지 않으며, 매크로 확장으로 인한 빌드 시간 오버헤드도 최소화할 수 있습니다.
+
+## 결론: 관심사의 분리와 깔끔한 코드
+
+이 방식의 핵심 이점은 다음과 같습니다.
+
+1. **관심사의 분리**: 매크로를 사용하는 쪽에서 `#if DEBUG`를 일일이 관리할 필요가 없습니다. 환경에 따른 동작 결정은 매크로 인터페이스 정의 단계에서 한 번만 처리됩니다.
+2. **깨끗한 코드**: 호출부 코드가 복잡해지지 않아 가독성이 높아지고 유지보수가 쉬워집니다.
+3. **DX(개발 경험) 향상**: 모듈 간 참조 시 발생하는 인식 문제나 자동완성 누락 문제를 매크로 수준에서 해결하여 더 쾌적한 개발 환경을 제공합니다.
+

setup_jekyll.sh

@@ -0,0 +1,39 @@
+#!/bin/zsh
+
+# 1. Homebrew 확인
+if ! command -v brew &> /dev/null; then
+    echo "❌ Homebrew가 설치되어 있지 않습니다. https://brew.sh/ 에서 먼저 설치해주세요."
+    exit 1
+fi
+
+# 2. rbenv 및 ruby-build 설치
+echo "📂 rbenv 및 ruby-build 설치 중..."
+brew install rbenv ruby-build
+
+# 3. .zshrc 설정 (이미 있으면 중복 추가 안 함)
+if ! grep -q 'rbenv init' ~/.zshrc; then
+    echo 'export PATH="$HOME/.rbenv/bin:$PATH"' >> ~/.zshrc
+    echo 'eval "$(rbenv init -)"' >> ~/.zshrc
+    echo "✅ ~/.zshrc에 rbenv 설정이 추가되었습니다. 새 터미널을 열거나 source ~/.zshrc를 실행하세요."
+fi
+
+# 현재 쉘 세션에 rbenv 바로 적용
+export PATH="$HOME/.rbenv/bin:$PATH"
+eval "$(rbenv init -)"
+
+# 4. 루비 설치 (3.2.2 버전 기준, 필요시 변경 가능)
+RUBY_VERSION="3.2.2"
+echo "💎 Ruby $RUBY_VERSION 설치 중... (시간이 다소 소요될 수 있습니다)"
+rbenv install $RUBY_VERSION --skip-existing
+rbenv local $RUBY_VERSION
+
+# 5. Bundler 설치
+echo "📦 Bundler 2.2.31 설치 중..."
+gem install bundler -v 2.2.31
+
+# 6. 프로젝트 의존성 설치
+echo "📥 프로젝트 라이브러리 설치 중..."
+bundle install
+
+echo "🚀 모든 설정이 완료되었습니다! Jekyll 서버를 실행합니다."
+bundle exec jekyll serve --drafts