การจัดการข้อความและข้อมูลที่มีโครงสร้าง

slugifier.slugify("Ruby for Java Developers")
# => "ruby-for-java-developers"

(1..5).to_a

EMAIL_REGEX = /\A[^\s@]+@[^\s@]+\.[^\s@]+\z/

text.downcase.strip
    .gsub(/\s+/, "-")
    .gsub(/[^a-z0-9-]/, "")

# EXAMPLE CODE
# Topic: topic_04_strings_symbols_ranges_regex
#
# Purpose:
# - This file demonstrates reference implementation for the concept.
# - It should pass tests from the beginning.
# - Read and understand it before solving exercises.

class Validator
  EMAIL_REGEX = /\A[^\s@]+@[^\s@]+\.[^\s@]+\z/

  def valid_email?(value)
    !!(value =~ EMAIL_REGEX)
  end
end

# STUDENT TASK (BASIC)
# Topic: topic_04_strings_symbols_ranges_regex
#
# What to do:
# - Implement or improve the class/methods in this file.
# - Read tests in tests/topic_04_strings_symbols_ranges_regex_spec.rb under the "basic exercise" examples.
# - Make tests pass without breaking the example/advanced sections.
#
# Expected outcome:
# - You can run this topic tests and see all examples green after implementation.

class RangeBuilder
  def inclusive(a, b)
    (a..b).to_a
  end
end

# STUDENT TASK (ADVANCED)
# Topic: topic_04_strings_symbols_ranges_regex
#
# Academic purpose:
# - Practice a realistic text-normalization task rather than isolated string syntax.
# - Learn how Ruby can express a multi-step text transformation compactly and readably.
#
# Real-world use case:
# - Slugs appear in blog platforms, CMS tools, documentation systems, and admin panels.
# - Teams use them to convert human-readable titles into URL-friendly identifiers.
# - This is exactly the sort of small but common feature where Ruby feels elegant.
#
# Why Ruby is beautiful here:
# - String methods chain naturally.
# - Each transformation step reflects a concrete formatting decision.
# - The code is short enough to scan but still close to the product need.
#
# What to do:
# - Complete the challenge behavior requested by the guide.
# - Be able to explain what each `gsub` removes or reshapes.
# - Use tests in tests/topic_04_strings_symbols_ranges_regex_spec.rb under the "advanced exercise" examples.
#
# Expected outcome:
# - Advanced tests pass and you can connect the implementation to a web-facing use case.

class Slugifier
  def slugify(text)
    text.downcase.strip.gsub(/\s+/, "-").gsub(/[^a-z0-9-]/, "")
  end
end

# ANSWER KEY (BASIC)
# Topic: topic_04_strings_symbols_ranges_regex
#
# Solution idea:
# - Ruby ranges are inclusive with `..`.
# - Convert the range to an array because the tests want the concrete sequence.

class RangeBuilder
  def inclusive(a, b)
    (a..b).to_a
  end
end

# ANSWER KEY (ADVANCED)
# Topic: topic_04_strings_symbols_ranges_regex
#
# Solution idea:
# - Normalize case first.
# - Remove surrounding whitespace.
# - Collapse internal whitespace into hyphens.
# - Strip any remaining characters that are not slug-safe for this exercise.

class Slugifier
  def slugify(text)
    text.downcase.strip.gsub(/\s+/, "-").gsub(/[^a-z0-9-]/, "")
  end
end

# This spec is your learning companion for topic_04_strings_symbols_ranges_regex.
#
# How to use this file:
# 1) Run tests and observe failures/successes.
# 2) Keep EXAMPLE specs green from the beginning.
# 3) Implement BASIC exercise until BASIC specs pass.
# 4) Implement ADVANCED exercise and pass edge cases.
#
# Expected final result:
# - All examples in this file pass.
# - You understand both the concept and the implementation tradeoffs.

require_relative "../example"
require_relative "../basic_exercise"
require_relative "../adv_exercise"

RSpec.describe "topic_04_strings_symbols_ranges_regex" do
  describe "EXAMPLE purpose: understand the reference implementation" do
      it "validates email formats" do
        v = Validator.new
        expect(v.valid_email?("a@b.com")).to eq(true)
        expect(v.valid_email?("x y@z.com")).to eq(false)
      end
  end

  describe "BASIC EXERCISE purpose: implement the comparable task" do
      it "creates inclusive ranges" do
        expect(RangeBuilder.new.inclusive(1, 3)).to eq([1, 2, 3])
      end
  end

  describe "ADVANCED EXERCISE purpose: solve challenge and edge cases" do
      it "slugifies text" do
        expect(Slugifier.new.slugify(" Hello Ruby 3.4! ")).to eq("hello-ruby-34")
      end
  end
end

#!/usr/bin/env bash
set -euo pipefail

SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
ROOT_DIR="$(cd "${SCRIPT_DIR}/.." && pwd)"

exec "${ROOT_DIR}/run_tests.sh" "$(basename "${SCRIPT_DIR}")"