0Pricing
Ruby Academy · 강의

테스트와 버전 관리

품질과 semver를 다룹니다

테스트와 버전 관리은(는) CoddyKit의 무료 Ruby Academy 강의입니다. 이것은 4개 중 3번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 Ruby Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. Ruby Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

젬을 테스트하는 이유

젬은 많은 프로젝트에서 사용되므로 버그 하나가 모든 사용자에게 영향을 줍니다. 자동화된 테스트를 사용하면 안심하고 코드를 변경하고 젬이 계속 제대로 작동하는지 확인할 수 있습니다.

  • 테스트는 예상되는 동작을 문서화합니다.
  • 출시 전에 회귀 문제를 찾아냅니다.
  • 신중한 사용자는 젬을 도입하기 전에 테스트를 요구합니다.

프레임워크 선택

널리 사용되는 두 가지 선택지는 미니테스트(루비와 함께 제공되며 가벼움)와 알스펙(기능이 풍부한 DSL이며 매우 널리 사용됨)입니다. 어느 쪽이든 괜찮으므로 하나를 골라 젬 사양 파일에 개발 의존성으로 추가하십시오.

미니테스트 예제

미니테스트 테스트는 단언 메서드를 사용하는 일반 클래스입니다. 다음은 젬의 로직을 실행하고 결과를 확인하는 독립 실행형 예제입니다.

require "minitest/autorun"

def greet(name)
  "Hi, " + name
end

class GreetTest < Minitest::Test
  def test_greet
    assert_equal "Hi, Sam", greet("Sam")
  end
end

일반적인 단언

유용한 미니테스트 단언:

  • assert_equal expected, actual
  • assert obj 및 refute obj
  • assert_nil value
  • assert_raises(Error) { ... }

각 테스트는 하나의 명확한 동작을 확인해야 합니다.

require "minitest/autorun"

class MathTest < Minitest::Test
  def test_addition
    assert_equal 4, 2 + 2
  end

  def test_truth
    refute_nil 5
  end
end

테스트 실행과 자동화

일반적으로 레이크 작업을 추가하여 rake test가 전체 테스트 모음을 실행하도록 합니다. 그러면 지속적 통합 시스템이 여러 루비 버전에서 모든 푸시마다 같은 작업을 실행하여 문제를 조기에 찾아냅니다.

시맨틱 버전 관리란 무엇인가요

시맨틱 버전 관리(semver)는 버전 번호 MAJOR.MINOR.PATCH에 의미를 부여합니다:

  • MAJOR: 호환되지 않는 인터페이스 변경입니다.
  • MINOR: 이전 버전과 호환되는 새 기능입니다.
  • PATCH: 이전 버전과 호환되는 버그 수정입니다.

사용자는 이를 바탕으로 안전하게 업그레이드합니다.

버전 읽기

2.4.1이 주어졌다면 주 버전은 2, 부 버전은 4, 수정 버전은 1입니다. 문자열을 나누면 각 부분을 확인할 수 있습니다.

version = "2.4.1"
major, minor, patch = version.split(".")
puts "Major: " + major
puts "Minor: " + minor
puts "Patch: " + patch

각 부분의 버전을 올리는 시점

판단 규칙:

  • 인터페이스를 변경하지 않고 버그를 수정했나요? 수정 버전을 올립니다.
  • 기능을 추가했고 기존 코드가 여전히 작동하나요? 부 버전을 올리고 수정 버전을 0으로 설정합니다.
  • 기존 동작을 제거하거나 변경했나요? 주 버전을 올리고 부 버전과 수정 버전을 0으로 설정합니다.
def bump_minor(version)
  major, minor, _patch = version.split(".").map(&:to_i)
  major.to_s + "." + (minor + 1).to_s + ".0"
end

puts bump_minor("1.3.5")

버전 제약 조건

사용자는 젬 파일에서 연산자를 사용해 젬 버전을 고정합니다:

  • '~> 1.4'는 1.4 이상 2.0 미만을 허용합니다(보수적 제약).
  • '>= 1.4'는 더 새로운 모든 버전을 허용합니다.
  • '= 1.4.2'는 정확히 한 버전으로 고정합니다.

보수적 제약인 ~>는 업데이트와 안정성 사이의 균형을 이루므로 가장 흔히 사용됩니다.

변경 기록 유지

각 버전에서 변경된 내용을 나열하는 CHANGELOG.md를 관리하십시오. 이 파일은 새로 추가된 내용, 문제가 발생한 변경 사항, 마이그레이션 방법을 사용자에게 알려 줍니다. 버전을 올릴 때마다 변경 기록 항목도 추가하십시오.

출시 전 버전

2.0.0.beta1과 같은 버전은 안정되지 않은 미리 보기임을 나타냅니다. 사용자가 명시적으로 선택해야 설치되므로, 일반적인 설치에 영향을 주지 않고 테스트를 위한 초기 버전을 출시할 수 있습니다.

version = "2.0.0.beta1"
puts "Pre-release? " + version.include?("beta").to_s

빠른 확인

버전 관리에 대한 이해도를 확인해 보십시오.

복습: 테스트와 버전 관리

젬의 신뢰성을 유지하는 방법을 배웠습니다:

  • 미니테스트 또는 알스펙으로 테스트를 작성하고, 레이크와 지속적 통합으로 자동화합니다.
  • 시맨틱 버전 관리 규칙을 따릅니다: MAJOR.MINOR.PATCH.
  • 수정, 기능 추가, 호환성을 깨는 변경에 맞는 부분의 버전을 올립니다.
  • ~> 제약 조건을 사용하고 변경 기록을 유지합니다.

다음으로 젬을 RubyGems에 게시하겠습니다.

자주 묻는 질문

“테스트와 버전 관리” 강의는 무료인가요?

네 — “테스트와 버전 관리” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 Ruby Academy 강의 전체를 잠금 해제할 수 있습니다. Ruby Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

“테스트와 버전 관리”에서 뭘 배우나요?

품질과 semver를 다룹니다 브라우저에서 직접 실행하는 실습 코드로 Ruby Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.

Ruby Academy을(를) 시작하는 데 경험이 필요한가요?

사전 경험은 필요하지 않습니다. CoddyKit의 Ruby Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 3번째 강의입니다.

“테스트와 버전 관리” 강의는 얼마나 걸리나요?

대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.

이 Ruby Academy 강의에서 코드를 작성하고 실행할 수 있나요?

네. 모든 Ruby Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.

이 강의의 모든 강의

  1. Gem 구조
  2. 코드 작성
  3. 테스트와 버전 관리
  4. RubyGems에 게시
← Ruby Academy(으)로 돌아가기