.NET 바인딩 추가

[christian289]

개요

Rust 기반 Braillify 라이브러리의 .NET 바인딩을 추가합니다. FFI/P/Invoke를 통해 네이티브 Rust 라이브러리를 .NET에서 사용할 수 있습니다.

NuGet 패키지

패키지	설명	타겟 프레임워크
BraillifyNet	라이브러리	netstandard2.0, netcoreapp3.1, net5.0~net10.0
Braillify	CLI 도구	net10.0

지원 플랫폼

• .NET Standard 2.0
• .NET Core 3.1
• .NET 5.0, 6.0, 7.0, 8.0, 9.0, 10.0
• .NET Framework 4.7.2 (테스트 지원)

주요 구현

프로젝트 구조

packages/dotnet/
├── Cargo.toml                # Rust FFI 크레이트 설정
├── src/lib.rs                # C ABI 노출 함수
├── Braillify.slnx            # .NET 10 솔루션 파일 (slnx 형식)
├── BraillifyNet/             # .NET 클래스 라이브러리
│   ├── Braillify.cs          # 공개 API (Encode, EncodeToUnicode, EncodeToBrailleFont)
│   ├── NativeMethods.cs      # P/Invoke 선언 (버전별 전처리)
│   ├── NativeLibraryLoader.cs # 플랫폼별 네이티브 라이브러리 로딩
│   └── BraillifyException.cs  # 예외 클래스
├── Braillify/                # CLI 도구
│   └── Program.cs            # System.CommandLine 기반 CLI
├── Braillify.Tests/          # xUnit 테스트 (멀티타겟팅)
└── Braillify.Tests.NetFramework/ # MSTest (.NET Framework 4.7.2)

버전별 P/Invoke 구현 차이

버전	P/Invoke 방식	포인터 타입	UTF-8 마샬링
.NET 7+	LibraryImport (소스 생성기)	nint/nuint	StringMarshalling.Utf8
.NET 5-6	DllImport	nint/nuint	LPUTF8Str
.NET Core 3.1	DllImport	IntPtr/UIntPtr	LPUTF8Str
.NET Standard 2.0	DllImport	IntPtr/UIntPtr	수동 UTF-8 변환

네이티브 라이브러리 로딩

• .NET Core 3.1+: NativeLibrary.SetDllImportResolver 사용
• AppContext.BaseDirectory 사용 (NativeAOT 호환)
• 런타임 식별자(RID) 기반 경로 탐색: runtimes/{rid}/native/{lib}

CLI 사용법

# 글로벌 설치
dotnet tool install -g Braillify

# 설치 없이 실행 (.NET 10+)
dnx braillify "안녕하세요"

# 텍스트 변환
braillify "안녕하세요"
# 출력: ⠣⠒⠉⠻⠚⠠⠝⠬

# 파이프 입력
echo "안녕하세요" | braillify

# REPL 모드
braillify

라이브러리 사용법

using Braillify;

// 텍스트를 점자 유니코드로 변환
string braille = Braillify.EncodeToUnicode("안녕하세요");
// 결과: "⠣⠒⠉⠻⠚⠠⠝⠬"

// 텍스트를 점자 바이트 배열로 변환
byte[] bytes = Braillify.Encode("안녕하세요");

// 텍스트를 점자 폰트 문자열로 변환
string font = Braillify.EncodeToBrailleFont("안녕하세요");

테스트 결과

모든 72개 테스트 통과 (8개 프레임워크 × 9개 테스트)

빌드 명령어

# 네이티브 라이브러리 빌드
cargo build --release -p dotnet

# .NET 패키지 빌드
cd packages/dotnet && dotnet build -c Release

# 테스트 실행
cd packages/dotnet && dotnet test

---

🤖 Generated with Claude Code

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

[github-actions]

Changepacks

[owjs3901]

해당 dll 파일은 gitignore 되어야 하는 것 아닌지 문의드립니다 (각 플랫폼 마다 별도로 생성되어야 하는 것으로 보입니다.)

[christian289]

아하 그렇습니다. 테스트하다가 빼먹었나보네요 ㅎㅎ... 다시 업데이트 하겠습니다.

[owjs3901]

넵, 감사합니다!

주신 구조를 기반으로 changepacks 가 C#을 지원하도록 업데이트 하여 매끄럽게 C#프로젝트도 배포가 될 수 있도록 하겠습니다.

기여 정말 감사드립니다.