| layout | title | url | previous | next |
|---|---|---|---|---|
default |
gem 이름짓기 |
/name-your-gem |
/gems-with-extensions |
/publishing |
gem의 이름에서 "_"와 "-"의 사용에 관한 권고
이름짓기에 대한 권고 사항의 예를 몇 가지 들어 보겠습니다.
| Gem 이름 | Require 문 | 메인 클래스나 모듈 |
|---|---|---|
ruby_parser |
require 'ruby_parser' |
RubyParser |
rdoc-data |
require 'rdoc/data' |
RDoc::Data |
net-http-persistent |
require 'net/http/persistent' |
Net::HTTP::Persistent |
net-http-digest_auth |
require 'net/http/digest_auth' |
Net::HTTP::DigestAuth |
이런 권고의 목적은 gem에서 파일을 어떻게 require 하는지에 대한 힌트를 사용자에게 주기 위해서입니다. 이런 관례에 따르면 Bundler에서 추가 설정 없이 gem을 require 할 수도 있습니다.
rubygems.org에 gem을 배포할 때, 불쾌한 이름이거나, 지적 재산권을 어기거나 gem의 내용물이 기준에 해당하면 삭제될 수도 있습니다. 이런 gem이 있다면 RubyGems Support 사이트에서 신고하실 수 있습니다.
클래스나 모듈이 여러 단어를 사용한다면, 밑줄을 사용해 단어를 구분하세요. 이 단어는 require할 파일명과 같아서, 사용자가 gem을 사용하기 쉽게합니다.
다른 gem에 기능을 추가하였다면, 대시를 사용하세요. 이것은 보통 require 문 안에서
/에(따라서 gem의 디렉터리 구조에) 메인 클래스나 모듈에서는 ::에 대응합니다.
클래스나 모듈에서 여러 단어를 사용하고 다른 gem에도 기능을 추가하였다면, 위에
있는 두 가지 규칙를 따르세요. 예를 들어, net-http-digest_auth는
HTTP digest authentication을 net/http에 넣습니다.
사용자는 (Net::HTTP::DigestAuth 클래스에 있는) 확장기능을 사용할 때
require 'net/http/digest_auth'라고 하면 될 것입니다.
OS X와 Windows는 기본적으로 대소문자 구별하지 않는 파일시스템을 채용하고 있습니다. 사용자는 실수로 gem을 대문자를 사용해 require할 수 있고, 이는 windows나 OS X가 아닌 시스템에서 호환성이 없습니다. 이는 대부분 초보자가 하는 실수가 되겠지만, 필요 이상으로 초보를 혼란스럽게 할 필요는 없을 것 같습니다.
이 가이드는 Eric Hodel 님의 How to Name Gems를 바탕으로 만들었습니다.