본문으로 건너뛰기

Ruby

「언어별 가이드」로 돌아가기 · 문서 목록으로

생성되는 것​

<Path>/
  <AccessorName>.rb                접근자 — 여기서 나머지를 전부 require합니다
  tables/<table>_table.rb          테이블당 하나
  enums/<enum>.rb                  enum당 하나
  constants/<set>.rb               상수 세트당 하나
  tabbit/tcb_reader.rb   바이너리 리더 (함께 생성됩니다)
  tabbit/updater.rb              데이터 갱신 (WriteUpdater를 켰을 때만)

필요한 것​

항목값
Ruby3.2로 검증
gem없음

recipe 설정​

"Targets": [
  {
    "Type": "ruby",
    "Path": "lib/gamedata",
    "ModuleName": "GameData",       // 감싸는 모듈
    "AccessorName": "Tables",       // 접근자 타입. 파일은 tables.rb
    "BinaryTableFileExtension": ".tcb",
    "WriteUpdater": false,          // CDN에서 데이터를 갱신할 거라면 true
    "Sweep": true,
    "TargetSide": "s"
  }
]

쓰는 법​

접근자 파일 하나만 require하면 나머지는 따라옵니다.

require_relative 'lib/gamedata/tables'

tables = GameData::Tables.new
tables.read_all('./data')

sword = tables.item.find_by_index(1)
if sword
  # 참조는 로드 후 실제 레코드로 연결됩니다.
  puts "#{sword.name} / #{sword.category_id.name}"
end

tables.item.records.each { |row| }

확장자는 기본 인자입니다.

tables.read_all('./data', '.bytes')

데이터만 갱신하기 (WriteUpdater)​

recipe에 "WriteUpdater": true를 적으면 tabbit/updater.rb가 함께 나옵니다. CDN이나 버킷에 올려둔 데이터를 받아 로컬 사본을 최신으로 유지하는 코드이고, 배포를 다시 하지 않고 데이터만 패치하기 위한 것입니다. 기본값이 false인 이유는 네트워크를 쓰기 때문입니다.

gem은 여전히 필요 없습니다. 표준 라이브러리만 씁니다 — 전송은 net/http, 해시 검증은 digest.

require_relative 'gamedata/tabbit/updater'

result = Tabbit.update('https://cdn.example.com/data', './data',
                         Tabbit::UpdateOptions.new(log: ->(m) { puts m }))

if result.succeeded
  tables.read_all(result.local_path)
else
  # 이전 데이터가 그대로 있습니다. 그것으로 계속해도 됩니다.
  warn result.error
end

예외를 throw하지 않습니다. 네트워크·디스크·손상된 파일은 모두 호출한 쪽이 다뤄야 할 상황이지 결함이 아니기 때문입니다. 실패하면 result.error에 이유가 들어있고, 디스크의 이전 데이터는 손대지 않은 상태입니다.

주의사항​

오토로더가 없습니다. Ruby에는 이 상황에서 쓸 오토로더가 없으므로 접근자가 모든 조각을 require_relative합니다. 그래서 소비자는 파일 하나만 require하면 됩니다.

테이블 파일은 enum을 require하지 않습니다. Ruby의 enum은 정수 상수로 생성되므로 테이블 파일이 enum 타입을 이름 부르지 않습니다 — 그래서 테이블의 require 목록은 테이블 리더 하나뿐입니다.

멤버 이름은 snake_case입니다. Ruby 키워드도 거의 소문자라 충돌 가능성이 가장 높은 언어 중 하나입니다. 부딪히면 이스케이프됩니다.

트러블슈팅​

증상원인과 조치
cannot load such filerequire_relative는 부르는 파일 기준입니다. 절대 경로나 $LOAD_PATH를 쓰세요
uninitialized constant GameData::Tables접근자 파일을 require하지 않았습니다. 조각 파일 하나만 require해도 나머지는 안 따라옵니다
참조가 nilread_all 대신 테이블 하나만 읽었거나, 시트가 그 셀에 0을 넣었습니다