[Review] 숫자에서 한글금액 표기 변환 라이브러리

시나리오 : 숫자를 한글금액 표기로 변환하는 라이브러리 리뷰 (필자가 만든 라이브러리🙇‍♂️) 

요즘 오픈소스 개발에 관심이 많아져서 개발을 진행하고 있는 것도 있지만 

프로젝트에서 필요하면 항상 공통으로 만들어서 사용을 했기 때문에 필요한 분들께 많은 도움이 되면 좋겠다.

 

 

한줄요약:

텍스트필드 입력 받은 값을 간편하게 한글금액 표기법으로 변환하여 준다.

 

 

설치방법

SPM을 지원하고 있다. 

엑스코드를 실행하고 상단에서 

파일 > Swift Packages > Add Package Dependency 에서 아래의 링크를 검색하고 추가해 주면 된다. 

https://github.com/PotatoArtie/KoreanCurrencyKit.git

 

1.Next Major with 0.0.3

2.brach로 선택하면 main 

3.exact version == 0.0.3

 

방식 중 메인 브랜치 또는 릴리즈된 0.0.3 버전(2023.05.01 기준)을 사용하면 된다.

 

사용법 

간단하게 사용할 수 있도록 Extension으로 추가해두었기 때문에 

패키지가 다운로드 된후 코드에서 문자열에서 바로 테스트 해볼 수 있다. 

// 숫자 + 한글 표기 
[요청]
"123456780".toKorean 
[출력]
1억 2,345만 6,780원

// 한글 표기 
[요청]
"123456780".spellOut 
[출력]
일억 이천삼백사십오만 육천칠백팔십

// 숫자 표기 
[요청]
"123456780".decimal 
[출력]
123,456,780

// 원화 표기
[요청]
"123456780".currency 
[출력]
₩123,456,780

// 서수 표기 
[요청]
"123456780".ordinal
[출력]
123,456,780번째

// 퍼센트 표기 
[요청]
"123456780".percent
[출력]
12,345,678,000%

 

Quick Help를 통해서 표기되는 형식을 간단하게 알 수 있도록 지원했다. 

 

 

 

 

오픈소스로 제작하는 만큼 다양한 환경에 노출되어도 버그없이 잘 사용되기 위해서 테스트코드 작성하여 

커버리지 90퍼센트를 유지하고 있다. 

제가 놓친 테스트케이스가 있다면 언제든 PR를 통해서 알려주세요~(컨트리뷰터 별거 없어요 ㅎㅎ) 

 

 

 

현재 회사에서도 모듈화를 진행하면서 이렇게 만들어둔 패키지를 잘 적용 및 사용하고 있다. 

개발자로서 뿌-듯한 일 중 하나이다 😎

 

 

 

마무리 : 

우리나라에서도 오픈소스 개발 활성화가 되면 좋겠고,

오픈소스개발을 함으로서 개발실력 향샹에 도움이 많이되니 시도해보길 바란다.

 

도움이 되셨다면 깃헙에서 스타하나 꾸-욱 눌러주세요 :)

오픈소스 개발을 진행하는데 많은 도움이 됩니다. 미리 감사의 말씀드립니다❤️

 

 

***코드리뷰 및 PR을 통해서 버그 및 개선사항이 있다면 언제든 환영입니다. ***

 

[Korea iOS Open Source] KIOS 오거나이저 모집하고 있습니다. 

오픈소스 개발 및 분석 및 리뷰의 관심이 있으시다면 언제든 지원 부탁드립니다.

 

 

참조 : 

https://github.com/PotatoArtie/KoreanCurrencyKit

GitHub - PotatoArtie/KoreanCurrencyKit