From a01b18bede9eec162a54ae110878df040150a9d1 Mon Sep 17 00:00:00 2001 From: Shia Date: Thu, 29 Dec 2022 13:22:26 +0900 Subject: [PATCH 01/14] Copy en/news/_posts/2022-12-25-ruby-3-2-0-released.md --- .../_posts/2022-12-25-ruby-3-2-0-released.md | 671 ++++++++++++++++++ 1 file changed, 671 insertions(+) create mode 100644 ko/news/_posts/2022-12-25-ruby-3-2-0-released.md diff --git a/ko/news/_posts/2022-12-25-ruby-3-2-0-released.md b/ko/news/_posts/2022-12-25-ruby-3-2-0-released.md new file mode 100644 index 0000000000..41e1a35005 --- /dev/null +++ b/ko/news/_posts/2022-12-25-ruby-3-2-0-released.md @@ -0,0 +1,671 @@ +--- +layout: news_post +title: "Ruby 3.2.0 Released" +author: "naruse" +translator: +date: 2022-12-25 00:00:00 +0000 +lang: en +--- + +{% assign release = site.data.releases | where: "version", "3.2.0" | first %} + +We are pleased to announce the release of Ruby {{ release.version }}. Ruby 3.2 adds many features and performance improvements. + + +## WASI based WebAssembly support + +This is an initial port of WASI based WebAssembly support. This enables a CRuby binary to be available on a Web browser, a Serverless Edge environment, or other kinds of WebAssembly/WASI embedders. Currently this port passes basic and bootstrap test suites not using the Thread API. + +![](https://i.imgur.com/opCgKy2.png) + +### Background + +[WebAssembly (Wasm)](https://webassembly.org/) was originally introduced to run programs safely and fast in web browsers. But its objective - running programs efficiently with security on various environment - is long wanted not only for web but also by general applications. + +[WASI (The WebAssembly System Interface)](https://wasi.dev/) is designed for such use cases. Though such applications need to communicate with operating systems, WebAssembly runs on a virtual machine which didn't have a system interface. WASI standardizes it. + +WebAssembly/WASI support in Ruby intends to leverage those projects. It enables Ruby developers to write applications which run on such promised platforms. + +### Use case + +This support encourages developers to utilize CRuby in a WebAssembly environment. An example use case is [TryRuby playground](https://try.ruby-lang.org/playground/)'s CRuby support. Now you can try original CRuby in your web browser. + +### Technical points + +Today’s WASI and WebAssembly itself is missing some features to implement Fiber, exception, and GC because it’s still evolving, and also for security reasons. So CRuby fills the gap by using Asyncify, which is a binary transformation technique to control execution in userland. + +In addition, we built [a VFS on top of WASI](https://github.com/kateinoigakukun/wasi-vfs/wiki/Getting-Started-with-CRuby) so that we can easily pack Ruby apps into a single .wasm file. This makes distribution of Ruby apps a bit easier. + +### Related links + +* [Add WASI based WebAssembly support #5407](https://github.com/ruby/ruby/pull/5407) +* [An Update on WebAssembly/WASI Support in Ruby](https://itnext.io/final-report-webassembly-wasi-support-in-ruby-4aface7d90c9) + + +## Production-ready YJIT + +![](https://i.imgur.com/X9ulfac.png) + +* YJIT is no longer experimental + * Has been tested on production workloads for over a year and proven to be quite stable. +* YJIT now supports both x86-64 and arm64/aarch64 CPUs on Linux, MacOS, BSD and other UNIX platforms. + * This release brings support for Apple M1/M2, AWS Graviton, Raspberry Pi 4 and more. +* Building YJIT now requires Rust 1.58.0+. [[Feature #18481]] + * In order to ensure that CRuby is built with YJIT, please install `rustc` >= 1.58.0 + before running the `./configure` script. + * Please reach out to the YJIT team should you run into any issues. +* The YJIT 3.2 release is faster than 3.1, and has about 1/3 as much memory overhead. + * Overall YJIT is 41% faster (geometric mean) than the Ruby interpreter on [yjit-bench](https://github.com/Shopify/yjit-bench). + * Physical memory for JIT code is lazily allocated. Unlike Ruby 3.1, + the RSS of a Ruby process is minimized because virtual memory pages + allocated by `--yjit-exec-mem-size` will not be mapped to physical + memory pages until actually utilized by JIT code. + * Introduce Code GC that frees all code pages when the memory consumption + by JIT code reaches `--yjit-exec-mem-size`. + * `RubyVM::YJIT.runtime_stats` returns Code GC metrics in addition to + existing `inline_code_size` and `outlined_code_size` keys: + `code_gc_count`, `live_page_count`, `freed_page_count`, and `freed_code_size`. +* Most of the statistics produced by `RubyVM::YJIT.runtime_stats` are now available in release builds. + * Simply run ruby with `--yjit-stats` to compute and dump stats (incurs some run-time overhead). +* YJIT is now optimized to take advantage of object shapes. [[Feature #18776]] +* Take advantage of finer-grained constant invalidation to invalidate less code when defining new constants. [[Feature #18589]] +* The default `--yjit-exec-mem-size` is changed to 64 (MiB). +* The default `--yjit-call-threshold` is changed to 30. + +## Regexp improvements against ReDoS + +It is known that Regexp matching may take unexpectedly long. If your code attempts to match a possibly inefficient Regexp against an untrusted input, an attacker may exploit it for efficient Denial of Service (so-called Regular expression DoS, or ReDoS). + +We have introduced two improvements that significantly mitigate ReDoS. + +### Improved Regexp matching algorithm + +Since Ruby 3.2, Regexp's matching algorithm has been greatly improved by using a memoization technique. + +``` +# This match takes 10 sec. in Ruby 3.1, and 0.003 sec. in Ruby 3.2 + +/^a*b?a*$/ =~ "a" * 50000 + "x" +``` + +![](https://cache.ruby-lang.org/pub/media/ruby320_regex_1.png) +![](https://cache.ruby-lang.org/pub/media/ruby320_regex_2.png) + +The improved matching algorithm allows most Regexp matching (about 90% in our experiments) to be completed in linear time. + +This optimization may consume memory proportional to the input length for each match. We expect no practical problems to arise because this memory allocation is usually delayed, and a normal Regexp match should consume at most 10 times as much memory as the input length. If you run out of memory when matching Regexps in a real-world application, please report it. + +The original proposal is + +### Regexp timeout + +The optimization above cannot be applied to some kind of regular expressions, such as those including advanced features (e.g., back-references or look-around), or with a huge fixed number of repetitions. As a fallback measure, a timeout feature for Regexp matches is also introduced. + +```ruby +Regexp.timeout = 1.0 + +/^a*b?a*()\1$/ =~ "a" * 50000 + "x" +#=> Regexp::TimeoutError is raised in one second +``` + +Note that `Regexp.timeout` is a global configuration. If you want to use different timeout settings for some special Regexps, you may want to use the `timeout` keyword for `Regexp.new`. + +```ruby +Regexp.timeout = 1.0 + +# This regexp has no timeout +long_time_re = Regexp.new('^a*b?a*()\1$', timeout: Float::INFINITY) + +long_time_re =~ "a" * 50000 + "x" # never interrupted +``` + +The original proposal is . + +## Other Notable New Features + +### SyntaxSuggest + +* The feature of `syntax_suggest` (formerly `dead_end`) is integrated into Ruby. This helps you find the position of errors such as missing or superfluous `end`s, to get you back on your way faster, such as in the following example: + + ``` + Unmatched `end', missing keyword (`do', `def`, `if`, etc.) ? + + 1 class Dog + > 2 defbark + > 3 end + 4 end + ``` + + [[Feature #18159]] + + +### ErrorHighlight + +* Now it points at the relevant argument(s) for TypeError and ArgumentError + +``` +test.rb:2:in `+': nil can't be coerced into Integer (TypeError) + +sum = ary[0] + ary[1] + ^^^^^^ +``` + +### Language + +* Anonymous rest and keyword rest arguments can now be passed as + arguments, instead of just used in method parameters. + [[Feature #18351]] + + ```ruby + def foo(*) + bar(*) + end + def baz(**) + quux(**) + end + ``` + +* A proc that accepts a single positional argument and keywords will + no longer autosplat. [[Bug #18633]] + + ```ruby + proc{|a, **k| a}.call([1, 2]) + # Ruby 3.1 and before + # => 1 + # Ruby 3.2 and after + # => [1, 2] + ``` + +* Constant assignment evaluation order for constants set on explicit + objects has been made consistent with single attribute assignment + evaluation order. With this code: + + ```ruby + foo::BAR = baz + ``` + + `foo` is now called before `baz`. Similarly, for multiple assignments + to constants, left-to-right evaluation order is used. With this + code: + + ```ruby + foo1::BAR1, foo2::BAR2 = baz1, baz2 + ``` + + The following evaluation order is now used: + + 1. `foo1` + 2. `foo2` + 3. `baz1` + 4. `baz2` + + [[Bug #15928]] + +* The find pattern is no longer experimental. + [[Feature #18585]] + +* Methods taking a rest parameter (like `*args`) and wishing to delegate keyword + arguments through `foo(*args)` must now be marked with `ruby2_keywords` + (if not already the case). In other words, all methods wishing to delegate + keyword arguments through `*args` must now be marked with `ruby2_keywords`, + with no exception. This will make it easier to transition to other ways of + delegation once a library can require Ruby 3+. Previously, the `ruby2_keywords` + flag was kept if the receiving method took `*args`, but this was a bug and an + inconsistency. A good technique to find potentially missing `ruby2_keywords` + is to run the test suite, find the last method which must + receive keyword arguments for each place where the test suite fails, and use `puts nil, caller, nil` there. Then check that each + method/block on the call chain which must delegate keywords is correctly marked + with `ruby2_keywords`. [[Bug #18625]] [[Bug #16466]] + + ```ruby + def target(**kw) + end + + # Accidentally worked without ruby2_keywords in Ruby 2.7-3.1, ruby2_keywords + # needed in 3.2+. Just like (*args, **kwargs) or (...) would be needed on + # both #foo and #bar when migrating away from ruby2_keywords. + ruby2_keywords def bar(*args) + target(*args) + end + + ruby2_keywords def foo(*args) + bar(*args) + end + + foo(k: 1) + ``` + +## Performance improvements + +### MJIT + +* The MJIT compiler is re-implemented in Ruby as `ruby_vm/mjit/compiler`. +* MJIT compiler is executed under a forked process instead of + doing it in a native thread called MJIT worker. [[Feature #18968]] + * As a result, Microsoft Visual Studio (MSWIN) is no longer supported. +* MinGW is no longer supported. [[Feature #18824]] +* Rename `--mjit-min-calls` to `--mjit-call-threshold`. +* Change default `--mjit-max-cache` back from 10000 to 100. + +### PubGrub + +* Bundler 2.4 now uses [PubGrub](https://github.com/jhawthorn/pub_grub) resolver instead of [Molinillo](https://github.com/CocoaPods/Molinillo). + + * PubGrub is the next generation solving algorithm used by `pub` package manager for the Dart programming language. + * You may get different resolution result after this change. Please report such cases to [RubyGems/Bundler issues](https://github.com/rubygems/rubygems/issues) + +* RubyGems still uses Molinillo resolver in Ruby 3.2. We plan to replace it with PubGrub in the future. + +## Other notable changes since 3.1 + +* Data + * New core class to represent simple immutable value object. The class is + similar to Struct and partially shares an implementation, but has more + lean and strict API. [[Feature #16122]] + + ```ruby + Measure = Data.define(:amount, :unit) + distance = Measure.new(100, 'km') #=> # + weight = Measure.new(amount: 50, unit: 'kg') #=> # + weight.with(amount: 40) #=> # + weight.amount #=> 50 + weight.amount = 40 #=> NoMethodError: undefined method `amount=' + ``` + +* Hash + * `Hash#shift` now always returns nil if the hash is + empty, instead of returning the default value or + calling the default proc. [[Bug #16908]] + +* MatchData + * `MatchData#byteoffset` has been added. [[Feature #13110]] + +* Module + * `Module.used_refinements` has been added. [[Feature #14332]] + * `Module#refinements` has been added. [[Feature #12737]] + * `Module#const_added` has been added. [[Feature #17881]] + +* Proc + * `Proc#dup` returns an instance of subclass. [[Bug #17545]] + * `Proc#parameters` now accepts lambda keyword. [[Feature #15357]] + +* Refinement + * `Refinement#refined_class` has been added. [[Feature #12737]] + +* RubyVM::AbstractSyntaxTree + * Add `error_tolerant` option for `parse`, `parse_file` and `of`. [[Feature #19013]] + With this option + 1. SyntaxError is suppressed + 2. AST is returned for invalid input + 3. `end` is complemented when a parser reaches to the end of input but `end` is insufficient + 4. `end` is treated as keyword based on indent + + ```ruby + # Without error_tolerant option + root = RubyVM::AbstractSyntaxTree.parse(<<~RUBY) + def m + a = 10 + if + end + RUBY + # => :33:in `parse': syntax error, unexpected `end' (SyntaxError) + + # With error_tolerant option + root = RubyVM::AbstractSyntaxTree.parse(<<~RUBY, error_tolerant: true) + def m + a = 10 + if + end + RUBY + p root # => # + + # `end` is treated as keyword based on indent + root = RubyVM::AbstractSyntaxTree.parse(<<~RUBY, error_tolerant: true) + module Z + class Foo + foo. + end + + def bar + end + end + RUBY + p root.children[-1].children[-1].children[-1].children[-2..-1] + # => [#, #] + ``` + + * Add `keep_tokens` option for `parse`, `parse_file` and `of`. [[Feature #19070]] + + ```ruby + root = RubyVM::AbstractSyntaxTree.parse("x = 1 + 2", keep_tokens: true) + root.tokens # => [[0, :tIDENTIFIER, "x", [1, 0, 1, 1]], [1, :tSP, " ", [1, 1, 1, 2]], ...] + root.tokens.map{_1[2]}.join # => "x = 1 + 2" + ``` + +* Set + * Set is now available as a builtin class without the need for `require "set"`. [[Feature #16989]] + It is currently autoloaded via the `Set` constant or a call to `Enumerable#to_set`. + +* String + * `String#byteindex` and `String#byterindex` have been added. [[Feature #13110]] + * Update Unicode to Version 15.0.0 and Emoji Version 15.0. [[Feature #18639]] + (also applies to Regexp) + * `String#bytesplice` has been added. [[Feature #18598]] + +* Struct + * A Struct class can also be initialized with keyword arguments + without `keyword_init: true` on `Struct.new` [[Feature #16806]] + + ```ruby + Post = Struct.new(:id, :name) + Post.new(1, "hello") #=> # + # From Ruby 3.2, the following code also works without keyword_init: true. + Post.new(id: 1, name: "hello") #=> # + ``` + +## Compatibility issues + +Note: Excluding feature bug fixes. + +### Removed constants + +The following deprecated constants are removed. + +* `Fixnum` and `Bignum` [[Feature #12005]] +* `Random::DEFAULT` [[Feature #17351]] +* `Struct::Group` +* `Struct::Passwd` + +### Removed methods + +The following deprecated methods are removed. + +* `Dir.exists?` [[Feature #17391]] +* `File.exists?` [[Feature #17391]] +* `Kernel#=~` [[Feature #15231]] +* `Kernel#taint`, `Kernel#untaint`, `Kernel#tainted?` + [[Feature #16131]] +* `Kernel#trust`, `Kernel#untrust`, `Kernel#untrusted?` + [[Feature #16131]] + +## Stdlib compatibility issues + +### No longer bundle 3rd party sources + +* We no longer bundle 3rd party sources like `libyaml`, `libffi`. + + * libyaml source has been removed from psych. You may need to install `libyaml-dev` with Ubuntu/Debian platform. The package name is different for each platform. + + * Bundled libffi source is also removed from `fiddle` + +* Psych and fiddle supported static builds with specific versions of libyaml and libffi sources. You can build psych with libyaml-0.2.5 like this: + + ```bash + $ ./configure --with-libyaml-source-dir=/path/to/libyaml-0.2.5 + ``` + + And you can build fiddle with libffi-3.4.4 like this: + + ```bash + $ ./configure --with-libffi-source-dir=/path/to/libffi-3.4.4 + ``` + + [[Feature #18571]] + +## C API updates + +### Updated C APIs + +The following APIs are updated. + +* PRNG update + * `rb_random_interface_t` updated and versioned. + Extension libraries which use this interface and built for older versions. + Also `init_int32` function needs to be defined. + +### Removed C APIs + +The following deprecated APIs are removed. + +* `rb_cData` variable. +* "taintedness" and "trustedness" functions. [[Feature #16131]] + +## Standard library updates + +* Bundler + + * Add --ext=rust support to bundle gem for creating simple gems with Rust extensions. + [[GH-rubygems-6149]] + * Make cloning git repos faster [[GH-rubygems-4475]] + +* RubyGems + + * Add mswin support for cargo builder. [[GH-rubygems-6167]] + +* ERB + + * `ERB::Util.html_escape` is made faster than `CGI.escapeHTML`. + * It no longer allocates a String object when no character needs to be escaped. + * It skips calling `#to_s` method when an argument is already a String. + * `ERB::Escape.html_escape` is added as an alias to `ERB::Util.html_escape`, + which has not been monkey-patched by Rails. + +* IRB + + * debug.gem integration commands have been added: `debug`, `break`, `catch`, + `next`, `delete`, `step`, `continue`, `finish`, `backtrace`, `info` + * They work even if you don't have `gem "debug"` in your Gemfile. + * See also: [What's new in Ruby 3.2's IRB?](https://st0012.dev/whats-new-in-ruby-3-2-irb) + * More Pry-like commands and features have been added. + * `edit` and `show_cmds` (like Pry's `help`) are added. + * `ls` takes `-g` or `-G` option to filter out outputs. + * `show_source` is aliased from `$` and accepts unquoted inputs. + * `whereami` is aliased from `@`. + +* The following default gems are updated. + + * RubyGems 3.4.1 + * abbrev 0.1.1 + * benchmark 0.2.1 + * bigdecimal 3.1.3 + * bundler 2.4.1 + * cgi 0.3.6 + * csv 3.2.6 + * date 3.3.3 + * delegate 0.3.0 + * did_you_mean 1.6.3 + * digest 3.1.1 + * drb 2.1.1 + * english 0.7.2 + * erb 4.0.2 + * error_highlight 0.5.1 + * etc 1.4.2 + * fcntl 1.0.2 + * fiddle 1.1.1 + * fileutils 1.7.0 + * forwardable 1.3.3 + * getoptlong 0.2.0 + * io-console 0.6.0 + * io-nonblock 0.2.0 + * io-wait 0.3.0 + * ipaddr 1.2.5 + * irb 1.6.2 + * json 2.6.3 + * logger 1.5.3 + * mutex_m 0.1.2 + * net-http 0.3.2 + * net-protocol 0.2.1 + * nkf 0.1.2 + * open-uri 0.3.0 + * open3 0.1.2 + * openssl 3.1.0 + * optparse 0.3.1 + * ostruct 0.5.5 + * pathname 0.2.1 + * pp 0.4.0 + * pstore 0.1.2 + * psych 5.0.1 + * racc 1.6.2 + * rdoc 6.5.0 + * readline-ext 0.1.5 + * reline 0.3.2 + * resolv 0.2.2 + * resolv-replace 0.1.1 + * securerandom 0.2.2 + * set 1.0.3 + * stringio 3.0.4 + * strscan 3.0.5 + * syntax_suggest 1.0.2 + * syslog 0.1.1 + * tempfile 0.1.3 + * time 0.2.1 + * timeout 0.3.1 + * tmpdir 0.1.3 + * tsort 0.1.1 + * un 0.2.1 + * uri 0.12.0 + * weakref 0.1.2 + * win32ole 1.8.9 + * yaml 0.2.1 + * zlib 3.0.0 + +* The following bundled gems are updated. + + * minitest 5.16.3 + * power_assert 2.0.3 + * test-unit 3.5.7 + * net-ftp 0.2.0 + * net-imap 0.3.3 + * net-pop 0.1.2 + * net-smtp 0.3.3 + * rbs 2.8.2 + * typeprof 0.21.3 + * debug 1.7.1 + +See GitHub releases like [GitHub Releases of logger](https://github.com/ruby/logger/releases) or changelog for details of the default gems or bundled gems. + +See [NEWS](https://github.com/ruby/ruby/blob/{{ release.tag }}/NEWS.md) +or [commit logs](https://github.com/ruby/ruby/compare/v3_1_0...{{ release.tag }}) +for more details. + +With those changes, [{{ release.stats.files_changed }} files changed, {{ release.stats.insertions }} insertions(+), {{ release.stats.deletions }} deletions(-)](https://github.com/ruby/ruby/compare/v3_1_0...{{ release.tag }}#file_bucket) +since Ruby 3.1.0! + +Merry Christmas, Happy Holidays, and enjoy programming with Ruby 3.2! + +## Download + +* <{{ release.url.gz }}> + + SIZE: {{ release.size.gz }} + SHA1: {{ release.sha1.gz }} + SHA256: {{ release.sha256.gz }} + SHA512: {{ release.sha512.gz }} + +* <{{ release.url.xz }}> + + SIZE: {{ release.size.xz }} + SHA1: {{ release.sha1.xz }} + SHA256: {{ release.sha256.xz }} + SHA512: {{ release.sha512.xz }} + +* <{{ release.url.zip }}> + + SIZE: {{ release.size.zip }} + SHA1: {{ release.sha1.zip }} + SHA256: {{ release.sha256.zip }} + SHA512: {{ release.sha512.zip }} + +## What is Ruby + +Ruby was first developed by Matz (Yukihiro Matsumoto) in 1993, +and is now developed as Open Source. It runs on multiple platforms +and is used all over the world especially for web development. + +[Feature #12005]: https://bugs.ruby-lang.org/issues/12005 +[Feature #12084]: https://bugs.ruby-lang.org/issues/12084 +[Feature #12655]: https://bugs.ruby-lang.org/issues/12655 +[Feature #12737]: https://bugs.ruby-lang.org/issues/12737 +[Feature #13110]: https://bugs.ruby-lang.org/issues/13110 +[Feature #14332]: https://bugs.ruby-lang.org/issues/14332 +[Feature #15231]: https://bugs.ruby-lang.org/issues/15231 +[Feature #15357]: https://bugs.ruby-lang.org/issues/15357 +[Bug #15928]: https://bugs.ruby-lang.org/issues/15928 +[Feature #16122]: https://bugs.ruby-lang.org/issues/16122 +[Feature #16131]: https://bugs.ruby-lang.org/issues/16131 +[Bug #16466]: https://bugs.ruby-lang.org/issues/16466 +[Feature #16663]: https://bugs.ruby-lang.org/issues/16663 +[Feature #16806]: https://bugs.ruby-lang.org/issues/16806 +[Bug #16889]: https://bugs.ruby-lang.org/issues/16889 +[Bug #16908]: https://bugs.ruby-lang.org/issues/16908 +[Feature #16989]: https://bugs.ruby-lang.org/issues/16989 +[Feature #17351]: https://bugs.ruby-lang.org/issues/17351 +[Feature #17391]: https://bugs.ruby-lang.org/issues/17391 +[Bug #17545]: https://bugs.ruby-lang.org/issues/17545 +[Bug #17767]: https://bugs.ruby-lang.org/issues/17767 +[Feature #17837]: https://bugs.ruby-lang.org/issues/17837 +[Feature #17881]: https://bugs.ruby-lang.org/issues/17881 +[Feature #18033]: https://bugs.ruby-lang.org/issues/18033 +[Feature #18159]: https://bugs.ruby-lang.org/issues/18159 +[Feature #18239]: https://bugs.ruby-lang.org/issues/18239#note-17 +[Feature #18351]: https://bugs.ruby-lang.org/issues/18351 +[Feature #18367]: https://bugs.ruby-lang.org/issues/18367 +[Bug #18435]: https://bugs.ruby-lang.org/issues/18435 +[Feature #18462]: https://bugs.ruby-lang.org/issues/18462 +[Feature #18481]: https://bugs.ruby-lang.org/issues/18481 +[Bug #18487]: https://bugs.ruby-lang.org/issues/18487 +[Feature #18564]: https://bugs.ruby-lang.org/issues/18564 +[Feature #18571]: https://bugs.ruby-lang.org/issues/18571 +[Feature #18585]: https://bugs.ruby-lang.org/issues/18585 +[Feature #18589]: https://bugs.ruby-lang.org/issues/18589 +[Feature #18595]: https://bugs.ruby-lang.org/issues/18595 +[Feature #18598]: https://bugs.ruby-lang.org/issues/18598 +[Bug #18625]: https://bugs.ruby-lang.org/issues/18625 +[Feature #18630]: https://bugs.ruby-lang.org/issues/18630 +[Bug #18633]: https://bugs.ruby-lang.org/issues/18633 +[Feature #18639]: https://bugs.ruby-lang.org/issues/18639 +[Feature #18685]: https://bugs.ruby-lang.org/issues/18685 +[Bug #18729]: https://bugs.ruby-lang.org/issues/18729 +[Bug #18751]: https://bugs.ruby-lang.org/issues/18751 +[Feature #18774]: https://bugs.ruby-lang.org/issues/18774 +[Feature #18776]: https://bugs.ruby-lang.org/issues/18776 +[Bug #18782]: https://bugs.ruby-lang.org/issues/18782 +[Feature #18788]: https://bugs.ruby-lang.org/issues/18788 +[Feature #18798]: https://bugs.ruby-lang.org/issues/18798 +[Feature #18809]: https://bugs.ruby-lang.org/issues/18809 +[Feature #18821]: https://bugs.ruby-lang.org/issues/18821 +[Feature #18822]: https://bugs.ruby-lang.org/issues/18822 +[Feature #18824]: https://bugs.ruby-lang.org/issues/18824 +[Feature #18832]: https://bugs.ruby-lang.org/issues/18832 +[Feature #18875]: https://bugs.ruby-lang.org/issues/18875 +[Feature #18925]: https://bugs.ruby-lang.org/issues/18925 +[Feature #18944]: https://bugs.ruby-lang.org/issues/18944 +[Feature #18949]: https://bugs.ruby-lang.org/issues/18949 +[Feature #18968]: https://bugs.ruby-lang.org/issues/18968 +[Feature #19008]: https://bugs.ruby-lang.org/issues/19008 +[Feature #19013]: https://bugs.ruby-lang.org/issues/19013 +[Feature #19026]: https://bugs.ruby-lang.org/issues/19026 +[Feature #19036]: https://bugs.ruby-lang.org/issues/19036 +[Feature #19060]: https://bugs.ruby-lang.org/issues/19060 +[Feature #19070]: https://bugs.ruby-lang.org/issues/19070 +[Feature #19071]: https://bugs.ruby-lang.org/issues/19071 +[Feature #19078]: https://bugs.ruby-lang.org/issues/19078 +[Bug #19087]: https://bugs.ruby-lang.org/issues/19087 +[Bug #19100]: https://bugs.ruby-lang.org/issues/19100 +[Feature #19104]: https://bugs.ruby-lang.org/issues/19104 +[Feature #19135]: https://bugs.ruby-lang.org/issues/19135 +[Feature #19138]: https://bugs.ruby-lang.org/issues/19138 +[Feature #19194]: https://bugs.ruby-lang.org/issues/19194 +[Molinillo]: https://github.com/CocoaPods/Molinillo +[PubGrub]: https://github.com/jhawthorn/pub_grub +[GH-net-protocol-14]: https://github.com/ruby/net-protocol/pull/14 +[GH-pathname-20]: https://github.com/ruby/pathname/pull/20 +[GH-6791]: https://github.com/ruby/ruby/pull/6791 +[GH-6868]: https://github.com/ruby/ruby/pull/6868 +[GH-rubygems-4475]: https://github.com/rubygems/rubygems/pull/4475 +[GH-rubygems-6149]: https://github.com/rubygems/rubygems/pull/6149 +[GH-rubygems-6167]: https://github.com/rubygems/rubygems/pull/6167 +[sec-156615]: https://hackerone.com/reports/156615 +[CVE-2021-33621]: https://www.ruby-lang.org/en/news/2022/11/22/http-response-splitting-in-cgi-cve-2021-33621/ +[wasm/README.md]: https://github.com/ruby/ruby/blob/master/wasm/README.md +[ruby.wasm]: https://github.com/ruby/ruby.wasm From 181d921e055178a262247272e58a9c1329629fb4 Mon Sep 17 00:00:00 2001 From: Shia Date: Thu, 29 Dec 2022 15:35:11 +0900 Subject: [PATCH 02/14] Translate Ruby 3.2.0 released to ko --- .../_posts/2022-12-25-ruby-3-2-0-released.md | 353 +++++++++--------- 1 file changed, 174 insertions(+), 179 deletions(-) diff --git a/ko/news/_posts/2022-12-25-ruby-3-2-0-released.md b/ko/news/_posts/2022-12-25-ruby-3-2-0-released.md index 41e1a35005..7c88658c88 100644 --- a/ko/news/_posts/2022-12-25-ruby-3-2-0-released.md +++ b/ko/news/_posts/2022-12-25-ruby-3-2-0-released.md @@ -1,89 +1,88 @@ --- layout: news_post -title: "Ruby 3.2.0 Released" -author: "naruse" +title: "Ruby 3.2.0 릴리스" +author: "shia" translator: date: 2022-12-25 00:00:00 +0000 -lang: en +lang: ko --- {% assign release = site.data.releases | where: "version", "3.2.0" | first %} -We are pleased to announce the release of Ruby {{ release.version }}. Ruby 3.2 adds many features and performance improvements. +Ruby {{ release.version }} 릴리스를 알리게 되어 기쁩니다. Ruby 3.2는 많은 기능과 성능 향상을 포함하고 있습니다. -## WASI based WebAssembly support +## WASI 기반 웹어셈블리 지원 -This is an initial port of WASI based WebAssembly support. This enables a CRuby binary to be available on a Web browser, a Serverless Edge environment, or other kinds of WebAssembly/WASI embedders. Currently this port passes basic and bootstrap test suites not using the Thread API. +WASI에 기반해 웹어셈블리를 지원하는 첫 이식판입니다. 이를 통해 CRuby 바이너리는 웹 브라우저, 서버리스 엣지 환경, 그 이외의 웹어셈블리/WASI를 사용 가능한 환경에서 동작할 수 있습니다. 현재 이 이식판은 스레드 API를 사용하지 않는 기본적인 테스트와 부트스트랩 테스트 스위트를 통과합니다. ![](https://i.imgur.com/opCgKy2.png) -### Background +### 배경 -[WebAssembly (Wasm)](https://webassembly.org/) was originally introduced to run programs safely and fast in web browsers. But its objective - running programs efficiently with security on various environment - is long wanted not only for web but also by general applications. +[웹어셈블리(Wasm)](https://webassembly.org/)는 본래 웹 브라우저에서 프로그램을 안전하고 빠르게 실행하기 위해서 만들어졌습니다. 하지만 그 목적 중 하나인 프로그램을 다양한 환경에서 안전하고 효율적으로 실행하는 것은 웹뿐만이 아니라 일반적인 애플리케이션도 바라던 것입니다. -[WASI (The WebAssembly System Interface)](https://wasi.dev/) is designed for such use cases. Though such applications need to communicate with operating systems, WebAssembly runs on a virtual machine which didn't have a system interface. WASI standardizes it. +[WASI(The WebAssembly System Interface)](https://wasi.dev/)는 이러한 용도를 위해 설계되었습니다. 이러한 애플리케이션은 운영체제와 통신해야 합니다만, 웹어셈블리는 시스템 인터페이스를 가지지 않는 가상 머신 위에서 동작합니다. WASI는 이 인터페이스를 표준화합니다. -WebAssembly/WASI support in Ruby intends to leverage those projects. It enables Ruby developers to write applications which run on such promised platforms. +Ruby의 웹어셈블리/WASI 지원은 이러한 프로젝트들을 활용하기 위함입니다. 이를 통해 Ruby 개발자들이 약속한 플랫폼에서 움직이는 애플리케이션을 작성할 수 있습니다. -### Use case +### 사용 예시 -This support encourages developers to utilize CRuby in a WebAssembly environment. An example use case is [TryRuby playground](https://try.ruby-lang.org/playground/)'s CRuby support. Now you can try original CRuby in your web browser. +이는 개발자가 웹어셈블리 환경에서 CRuby를 활용할 수 있도록 돕습니다. 하나의 예로, [TryRuby playground](https://try.ruby-lang.org/playground/)의 CRuby 지원이 있습니다. 이제 CRuby를 웹 브라우저 상에서 직접 사용해볼 수 있습니다. -### Technical points +### 기술적인 부분 -Today’s WASI and WebAssembly itself is missing some features to implement Fiber, exception, and GC because it’s still evolving, and also for security reasons. So CRuby fills the gap by using Asyncify, which is a binary transformation technique to control execution in userland. +현재 WASI와 웹어셈블리 자체에는 Fiber, 예외 처리, GC를 구현하기 위한 일부 기능이 부족합니다. 이는 여전히 개발중이라는 점도 있지만, 보안 때문이기도 합니다. 그래서 CRuby는 사용자 공간에서의 실행을 제어하기 위한 바이너리 변환 기술인 Asyncify를 사용해 그 차이를 메꿉니다. -In addition, we built [a VFS on top of WASI](https://github.com/kateinoigakukun/wasi-vfs/wiki/Getting-Started-with-CRuby) so that we can easily pack Ruby apps into a single .wasm file. This makes distribution of Ruby apps a bit easier. +나아가서 Ruby 앱을 간단하게 단일 .wasm 파일로 패키징할 수 있도록 [WASI 상에 VFS](https://github.com/kateinoigakukun/wasi-vfs/wiki/Getting-Started-with-CRuby)를 구현했습니다. 이는 Ruby 앱의 배포를 쉽게 해줄 것입니다. -### Related links +### 관련 링크 * [Add WASI based WebAssembly support #5407](https://github.com/ruby/ruby/pull/5407) * [An Update on WebAssembly/WASI Support in Ruby](https://itnext.io/final-report-webassembly-wasi-support-in-ruby-4aface7d90c9) -## Production-ready YJIT +## 실용화 단계인 YJIT ![](https://i.imgur.com/X9ulfac.png) -* YJIT is no longer experimental - * Has been tested on production workloads for over a year and proven to be quite stable. -* YJIT now supports both x86-64 and arm64/aarch64 CPUs on Linux, MacOS, BSD and other UNIX platforms. - * This release brings support for Apple M1/M2, AWS Graviton, Raspberry Pi 4 and more. -* Building YJIT now requires Rust 1.58.0+. [[Feature #18481]] - * In order to ensure that CRuby is built with YJIT, please install `rustc` >= 1.58.0 - before running the `./configure` script. - * Please reach out to the YJIT team should you run into any issues. -* The YJIT 3.2 release is faster than 3.1, and has about 1/3 as much memory overhead. - * Overall YJIT is 41% faster (geometric mean) than the Ruby interpreter on [yjit-bench](https://github.com/Shopify/yjit-bench). - * Physical memory for JIT code is lazily allocated. Unlike Ruby 3.1, - the RSS of a Ruby process is minimized because virtual memory pages - allocated by `--yjit-exec-mem-size` will not be mapped to physical - memory pages until actually utilized by JIT code. - * Introduce Code GC that frees all code pages when the memory consumption - by JIT code reaches `--yjit-exec-mem-size`. - * `RubyVM::YJIT.runtime_stats` returns Code GC metrics in addition to - existing `inline_code_size` and `outlined_code_size` keys: - `code_gc_count`, `live_page_count`, `freed_page_count`, and `freed_code_size`. -* Most of the statistics produced by `RubyVM::YJIT.runtime_stats` are now available in release builds. - * Simply run ruby with `--yjit-stats` to compute and dump stats (incurs some run-time overhead). -* YJIT is now optimized to take advantage of object shapes. [[Feature #18776]] -* Take advantage of finer-grained constant invalidation to invalidate less code when defining new constants. [[Feature #18589]] -* The default `--yjit-exec-mem-size` is changed to 64 (MiB). -* The default `--yjit-call-threshold` is changed to 30. - -## Regexp improvements against ReDoS - -It is known that Regexp matching may take unexpectedly long. If your code attempts to match a possibly inefficient Regexp against an untrusted input, an attacker may exploit it for efficient Denial of Service (so-called Regular expression DoS, or ReDoS). - -We have introduced two improvements that significantly mitigate ReDoS. - -### Improved Regexp matching algorithm - -Since Ruby 3.2, Regexp's matching algorithm has been greatly improved by using a memoization technique. +* YJIT은 이제 정식 기능입니다. + * 1년 이상의 기간에 실제 환경의 부하로 테스트되었으며, 안정적임이 증명되었습니다. +* YJIT은 x86-64와 arm64/aarch64 CPU에서 움직이는 Linux, MacOS, BSD와 같은 UNIX 환경을 지원합니다. + * 이번 릴리스는 Apple M1/M2, AWS Graviton, Raspberry Pi 4등을 추가로 지원합니다. +* YJIT을 빌드하기 위해서는 Rst 1.58.0 이상을 요구합니다. [[Feature #18481]] + * CRuby를 YJIT과 함께 빌드하기 위해서는 `./configure` 스크립트를 실행하기 전에 1.58.0 이상의 `rustc`를 설치해주세요. + * 문제에 빠진 경우에는 YJIT 팀에 연락해주세요. +* YJIT 3.2 릴리스는 3.1보다 빠르며, 메모리 오버헤드는 약 1/3이 되었습니다. + * [yjit-bench](https://github.com/Shopify/yjit-bench)에서 YJIT을 사용하면 그렇지 않은 Ruby 인터프리터보다 41% 빠릅니다. + * JIT 코드의 물리 메모리는 지연되어 할당됩니다. Ruby 3.1과는 다르게, + `--yjit-exec-mem-size`는 JIT 코드에 의해서 실제로 최적화될 때까지 + 물리 메모리 페이지에 할당되지 않기 때문에 Ruby 프로세스의 RSS는 + 최소화됩니다. + * JIT 코드로 인한 메모리 소비가 `--yjit-exec-mem-size`에 도달했을 때 + 모든 코드 페이지를 해방하는 코드 GC를 도입했습니다. + * `RubyVM::YJIT.runtime_stats`는 기존의 `inline_code_size`, `outlined_code_size`에 + 더해 코드 GC 정보인 `code_gc_count`, `live_page_count`, `freed_page_count`, + `freed_code_size`를 반환합니다. +* `RubyVM::YJIT.runtime_stats`가 제공하는 통계 정보가 이번 릴리스부터 이용가능합니다. + * 통계 정보를 계산하고 얻기 위해서는 Ruby를 `--yjit-stats`와 함께 실행하세요(약간의 실행시간 오버헤드가 발생합니다). +* YJIT은 Object shape를 이용해 최적화합니다. [[Feature #18776]] +* 정수를 유효화하는 단위를 작게하여 새 정수를 정의할 때 더 적은 코드를 무효화합니다. [[Feature #18589]] +* `--yjit-exec-mem-size`의 기본값이 64(MiB)로 변경됩니다. +* `--yjit-call-threshold`의 기본값이 30으로 변경됩니다. + +## ReDoS에 대한 정규표현식 개선 + +정규표현식 일치는 기대와는 다르게 시간이 오래 걸리는 경우가 있습니다. 신뢰할 수 없는 입력에 대해서 비효율적일 가능성이 있는 정규표현식을 일치시키고 있다면, 공격자는 이를 이용해 효율적으로 서비스 거부 공격(이를 정규표현식 DoS, 또는 ReDoS라고 부릅니다)이 가능합니다. + +ReDoS의 위협을 현저하게 완화할 수 있는 2개의 개선을 도입했습니다. + +### 개선된 정규표현식 일치 알고리즘 + +Ruby 3.2부터 정규표현식 일치 알고리즘이 메모이제이션 기술에 의해 매우 개선됩니다. ``` -# This match takes 10 sec. in Ruby 3.1, and 0.003 sec. in Ruby 3.2 +# Ruby 3.1에서 10초가 걸리지만, Ruby 3.2에서는 0.003초가 걸립니다. /^a*b?a*$/ =~ "a" * 50000 + "x" ``` @@ -91,15 +90,15 @@ Since Ruby 3.2, Regexp's matching algorithm has been greatly improved by using a ![](https://cache.ruby-lang.org/pub/media/ruby320_regex_1.png) ![](https://cache.ruby-lang.org/pub/media/ruby320_regex_2.png) -The improved matching algorithm allows most Regexp matching (about 90% in our experiments) to be completed in linear time. +이 개선된 알고리즘은 대부분의 정규표현식 일치(실험에서는 약 90%)가 선형 시간으로 완료됩니다. -This optimization may consume memory proportional to the input length for each match. We expect no practical problems to arise because this memory allocation is usually delayed, and a normal Regexp match should consume at most 10 times as much memory as the input length. If you run out of memory when matching Regexps in a real-world application, please report it. +이 최적화는 각 일치마다 입력의 길이에 비례하여 메모리를 소비할 수 있습니다. 이 메모리 확보는 필요할 때까지 발생하지 않으며, 일반적인 정규표현식 일치는 입력 길이에 비해 최대 10배 소비할 뿐이므로, 실상황에서 문제는 없을 것이라고 예상합니다. 만약 실제 애플리케이션에서 정규표현식 일치로 인한 메모리 부족이 발생하는 경우에는 보고해주세요. -The original proposal is +기능 제안 티켓은 입니다. -### Regexp timeout +### 정규표현식 타임아웃 -The optimization above cannot be applied to some kind of regular expressions, such as those including advanced features (e.g., back-references or look-around), or with a huge fixed number of repetitions. As a fallback measure, a timeout feature for Regexp matches is also introduced. +위에서 설명한 최적화는 고급 기능(e.g. 역참조나 전후방탐색)이나 매우 큰 고정 회수 반복을 포함하는 정규표현식에서는 적용할 수 없습니다. 이러한 경우를 위한 방법으로, 정규표현식 일치에 타임아웃 기능이 추가되었습니다. ```ruby Regexp.timeout = 1.0 @@ -108,24 +107,24 @@ Regexp.timeout = 1.0 #=> Regexp::TimeoutError is raised in one second ``` -Note that `Regexp.timeout` is a global configuration. If you want to use different timeout settings for some special Regexps, you may want to use the `timeout` keyword for `Regexp.new`. +`Regexp.timeout`은 전역 설정임에 주의하세요. 일부의 특수한 정규표현식에 대해서만 다른 타임아웃 설정을 사용하고 싶다면, `Regexp.new` 의 `timeout` 키워드를 사용할 수 있습니다. ```ruby Regexp.timeout = 1.0 -# This regexp has no timeout +# 이 정규표현식은 타임아웃 설정이 없습니다. long_time_re = Regexp.new('^a*b?a*()\1$', timeout: Float::INFINITY) -long_time_re =~ "a" * 50000 + "x" # never interrupted +long_time_re =~ "a" * 50000 + "x" # 타임아웃이 발생하지 않습니다. ``` -The original proposal is . +기능 제안 티켓은 입니다. -## Other Notable New Features +## 그 이외의 주목할 만한 새 기능 ### SyntaxSuggest -* The feature of `syntax_suggest` (formerly `dead_end`) is integrated into Ruby. This helps you find the position of errors such as missing or superfluous `end`s, to get you back on your way faster, such as in the following example: +* `syntax_suggest`(구 `dead_end`)의 기능이 Ruby에 통합됩니다. 이는 `end`가 빠져있거나, 하나 더 있을 때 발생하는 에러의 위치를 찾고 개발에 집중할 수 있도록 돕습니다. 예를 들어 다음과 같은 에러를 찾아줍니다. ``` Unmatched `end', missing keyword (`do', `def`, `if`, etc.) ? @@ -141,7 +140,7 @@ The original proposal is . ### ErrorHighlight -* Now it points at the relevant argument(s) for TypeError and ArgumentError +* TypeError와 ArgumentError의 인수를 가리킬 수 있습니다. ``` test.rb:2:in `+': nil can't be coerced into Integer (TypeError) @@ -150,11 +149,10 @@ sum = ary[0] + ary[1] ^^^^^^ ``` -### Language +### 언어 -* Anonymous rest and keyword rest arguments can now be passed as - arguments, instead of just used in method parameters. - [[Feature #18351]] +* 익명 나머지 인수, 익명 나머지 키워드 인수가 파라미터로서뿐만 아니라, + 인수로서도 사용할 수 있게 됩니다. [[Feature #18351]] ```ruby def foo(*) @@ -165,8 +163,8 @@ sum = ary[0] + ary[1] end ``` -* A proc that accepts a single positional argument and keywords will - no longer autosplat. [[Bug #18633]] +* 1개의 인수와 나머지를 키워드로 받는 프록은 인수를 자동으로 전개하지 + 않습니다. [[Bug #18633]] ```ruby proc{|a, **k| a}.call([1, 2]) @@ -176,23 +174,21 @@ sum = ary[0] + ary[1] # => [1, 2] ``` -* Constant assignment evaluation order for constants set on explicit - objects has been made consistent with single attribute assignment - evaluation order. With this code: +* 정수 대입에서의 정수 평가 순서가 단일 대입시의 평가 순서와 + 일관성을 가지게 됩니다. 다음 코드의 경우, ```ruby foo::BAR = baz ``` - `foo` is now called before `baz`. Similarly, for multiple assignments - to constants, left-to-right evaluation order is used. With this - code: + `foo`는 이제 `baz`보다 먼저 호출됩니다. 마찬가지로 정수의 다중 대입에서도 + 왼쪽에서 오른쪽으로 평가됩니다. 다음 코드의 경우, ```ruby foo1::BAR1, foo2::BAR2 = baz1, baz2 ``` - The following evaluation order is now used: + 아래와 같은 순서로 평가됩니다. 1. `foo1` 2. `foo2` @@ -201,7 +197,7 @@ sum = ary[0] + ary[1] [[Bug #15928]] -* The find pattern is no longer experimental. +* 검색 패턴은 이제 정식 기능입니다. [[Feature #18585]] * Methods taking a rest parameter (like `*args`) and wishing to delegate keyword @@ -235,33 +231,32 @@ sum = ary[0] + ary[1] foo(k: 1) ``` -## Performance improvements +## 성능 향상 ### MJIT -* The MJIT compiler is re-implemented in Ruby as `ruby_vm/mjit/compiler`. -* MJIT compiler is executed under a forked process instead of - doing it in a native thread called MJIT worker. [[Feature #18968]] - * As a result, Microsoft Visual Studio (MSWIN) is no longer supported. -* MinGW is no longer supported. [[Feature #18824]] -* Rename `--mjit-min-calls` to `--mjit-call-threshold`. -* Change default `--mjit-max-cache` back from 10000 to 100. +* MJIT 컴파일러는 `ruby_vm/mjit/compiler`라는 이름으로 Ruby를 사용해 재구현되었습니다. +* MJIT 컴파일러는 MJIT 워커에 의해 실행된 네이티브 스레드 대신 + 포크된 프로세스에서 실행됩니다. [[Feature #18968]] + * 이 영향으로 Microsoft Visual Studio (MSWIN)이 더이상 지원되지 않습니다. +* MinGW는 더이상 지원되지 않습니다. [[Feature #18824]] +* `--mjit-min-calls`를 `--mjit-call-threshold`로 변경했습니다. +* `--mjit-max-cache`의 기본값을 10000에서 100으로 되돌렸습니다. ### PubGrub -* Bundler 2.4 now uses [PubGrub](https://github.com/jhawthorn/pub_grub) resolver instead of [Molinillo](https://github.com/CocoaPods/Molinillo). +* Bundler 2.4는 [Molinillo](https://github.com/CocoaPods/Molinillo) 대신에 [PubGrub](https://github.com/jhawthorn/pub_grub) 의존해결기를 사용합니다. + * PubGrub은 Dart 프로그래밍 언어의 `pub` 패키지 매니저에서 사용하고 있는 차세대 의존성 해결 알고리즘입니다. + * 이 변경으로 지금과는 다른 해결 결과를 얻을 수 있습니다. 그런 경우에는 [RubyGems/Bundler issues](https://github.com/rubygems/rubygems/issues)에 보고해주세요. - * PubGrub is the next generation solving algorithm used by `pub` package manager for the Dart programming language. - * You may get different resolution result after this change. Please report such cases to [RubyGems/Bundler issues](https://github.com/rubygems/rubygems/issues) +* RubyGems는 Ruby 3.2에서도 Molinillo를 그대로 사용합니다. 미래에 PubGrub으로 변경할 계획입니다. -* RubyGems still uses Molinillo resolver in Ruby 3.2. We plan to replace it with PubGrub in the future. - -## Other notable changes since 3.1 +## 3.1 이후로 주목할 만한 변경 * Data - * New core class to represent simple immutable value object. The class is - similar to Struct and partially shares an implementation, but has more - lean and strict API. [[Feature #16122]] + * 단순하며 변경불가능한 값 객체를 표현하기 위한 새 주요 클래스입니다. + 이 클래스는 Struct와 비슷하며, 부분적으로 구현을 공유하고 있습니다만, + 더 간결하며 한정적인 API를 제공합니다. [[Feature #16122]] ```ruby Measure = Data.define(:amount, :unit) @@ -273,35 +268,35 @@ sum = ary[0] + ary[1] ``` * Hash - * `Hash#shift` now always returns nil if the hash is - empty, instead of returning the default value or - calling the default proc. [[Bug #16908]] + * `Hash#shift`는 이제 해시가 비어있다면 + 기본 값이나 기본 프록을 호출한 결과 값을 반환하는 대신 + 언제나 nil을 반환합니다. [[Bug #16908]] * MatchData - * `MatchData#byteoffset` has been added. [[Feature #13110]] + * `MatchData#byteoffset`이 추가되었습니다. [[Feature #13110]] * Module - * `Module.used_refinements` has been added. [[Feature #14332]] - * `Module#refinements` has been added. [[Feature #12737]] - * `Module#const_added` has been added. [[Feature #17881]] + * `Module.used_refinements`가 추가되었습니다. [[Feature #14332]] + * `Module#refinements`가 추가되었습니다. [[Feature #12737]] + * `Module#const_added`가 추가되었습니다. [[Feature #17881]] * Proc - * `Proc#dup` returns an instance of subclass. [[Bug #17545]] - * `Proc#parameters` now accepts lambda keyword. [[Feature #15357]] + * `Proc#dup`은 서브클래스의 인스턴스를 반환합니다. [[Bug #17545]] + * `Proc#parameters`는 이제 람다 키워드를 받습니다. [[Feature #15357]] * Refinement - * `Refinement#refined_class` has been added. [[Feature #12737]] + * `Refinement#refined_class`가 추가되었습니다. [[Feature #12737]] * RubyVM::AbstractSyntaxTree - * Add `error_tolerant` option for `parse`, `parse_file` and `of`. [[Feature #19013]] - With this option - 1. SyntaxError is suppressed - 2. AST is returned for invalid input - 3. `end` is complemented when a parser reaches to the end of input but `end` is insufficient - 4. `end` is treated as keyword based on indent + * `parse`, `parse_file`, `of`에 `error_tolerant` 옵션이 추가되었습니다. [[Feature #19013]] + 이 옵션을 사용하면, + 1. SyntaxError가 발생하지 않습니다 + 2. 올바르지 않은 입력에 대해서도 AST가 반환됩니다 + 3. 파서가 입력의 마지막에 도달했지만 `end`가 부족한 상태일 경우, 부족한 `end`를 추가합니다. + 4. 들여쓰기를 참고해 `end`를 키워드로 취급합니다. ```ruby - # Without error_tolerant option + # error_tolerant 옵션을 사용하지 않은 경우 root = RubyVM::AbstractSyntaxTree.parse(<<~RUBY) def m a = 10 @@ -310,7 +305,7 @@ sum = ary[0] + ary[1] RUBY # => :33:in `parse': syntax error, unexpected `end' (SyntaxError) - # With error_tolerant option + # error_tolerant 옵션을 사용한 경우 root = RubyVM::AbstractSyntaxTree.parse(<<~RUBY, error_tolerant: true) def m a = 10 @@ -319,7 +314,7 @@ sum = ary[0] + ary[1] RUBY p root # => # - # `end` is treated as keyword based on indent + # `end` 는 들여쓰기를 참고해 키워드로 취급됩니다 root = RubyVM::AbstractSyntaxTree.parse(<<~RUBY, error_tolerant: true) module Z class Foo @@ -334,7 +329,7 @@ sum = ary[0] + ary[1] # => [#, #] ``` - * Add `keep_tokens` option for `parse`, `parse_file` and `of`. [[Feature #19070]] + * `parse`, `parse_file`, `of`에 `keep_tokens` 옵션이 추가되었습니다. [[Feature #19070]] ```ruby root = RubyVM::AbstractSyntaxTree.parse("x = 1 + 2", keep_tokens: true) @@ -343,18 +338,18 @@ sum = ary[0] + ary[1] ``` * Set - * Set is now available as a builtin class without the need for `require "set"`. [[Feature #16989]] - It is currently autoloaded via the `Set` constant or a call to `Enumerable#to_set`. + * Set은 이제 `require "set"`할 필요 없이 사용 가능한 내장 클래스입니다. [[Feature #16989]] + 현재는 `Set` 상수를 사용하거나 `Enumerable#to_set`을 호출하면 자동으로 로드됩니다. * String - * `String#byteindex` and `String#byterindex` have been added. [[Feature #13110]] - * Update Unicode to Version 15.0.0 and Emoji Version 15.0. [[Feature #18639]] - (also applies to Regexp) - * `String#bytesplice` has been added. [[Feature #18598]] + * `String#byteindex`와 `String#byterindex`가 추가되었습니다. [[Feature #13110]] + * 유니코드 버전이 15.0.0, 에모지 버전이 15.0으로 갱신되었습니다. [[Feature #18037]] + (이는 정규표현식에도 적용됩니다) + * `String#bytesplice`가 추가되었습니다. [[Feature #18598]] * Struct - * A Struct class can also be initialized with keyword arguments - without `keyword_init: true` on `Struct.new` [[Feature #16806]] + * `keyword_init: true` 없이 `Struct.new`에 키워드 인수를 넘겨 + Struct 클래스를 초기화할 수 있습니다. [[Feature #16806]] ```ruby Post = Struct.new(:id, :name) @@ -363,22 +358,22 @@ sum = ary[0] + ary[1] Post.new(id: 1, name: "hello") #=> # ``` -## Compatibility issues +## 호환성 문제 -Note: Excluding feature bug fixes. +주의: 기능 개선, 버그 수정은 포함되어 있지 않습니다. -### Removed constants +### 삭제된 정수 -The following deprecated constants are removed. +폐기 예정이었던 정수가 삭제됩니다. * `Fixnum` and `Bignum` [[Feature #12005]] * `Random::DEFAULT` [[Feature #17351]] * `Struct::Group` * `Struct::Passwd` -### Removed methods +### 삭제된 메소드 -The following deprecated methods are removed. +폐기 예정이었던 메소드가 삭제됩니다. * `Dir.exists?` [[Feature #17391]] * `File.exists?` [[Feature #17391]] @@ -388,23 +383,23 @@ The following deprecated methods are removed. * `Kernel#trust`, `Kernel#untrust`, `Kernel#untrusted?` [[Feature #16131]] -## Stdlib compatibility issues +## Stdlib 호환성 문제 -### No longer bundle 3rd party sources +### 서드파티 소스 코드의 동봉을 폐기 -* We no longer bundle 3rd party sources like `libyaml`, `libffi`. +* `libyaml`, `libffi`와 같은 서드파티 라이브러리의 소스 코드를 더이상 포함하지 않습니다. - * libyaml source has been removed from psych. You may need to install `libyaml-dev` with Ubuntu/Debian platform. The package name is different for each platform. + * libyaml의 소스 코드는 psych로부터 제거되었습니다. Ubuntu/Debian 환경에서는 `libyaml-dev`가 필요합니다. 패키지 이름은 각 환경별로 다를 수 있습니다. - * Bundled libffi source is also removed from `fiddle` + * 동봉된 libffi 소스 코드도 `fiddle`로부터 제거되었습니다. -* Psych and fiddle supported static builds with specific versions of libyaml and libffi sources. You can build psych with libyaml-0.2.5 like this: +* Psych와 fiddle이 특정 버전의 libyaml과 libffi 소스코드와 함께 정적 빌드를 할 수 있게 됩니다. 다음과 같이 psych를 libyml-0.2.5와 함께 빌드할 수 있습니다. ```bash $ ./configure --with-libyaml-source-dir=/path/to/libyaml-0.2.5 ``` - And you can build fiddle with libffi-3.4.4 like this: + 그리고 다음과 같이 fiddle를 libffi-3.4.4와 함께 빌드할 수 있습니다. ```bash $ ./configure --with-libffi-source-dir=/path/to/libffi-3.4.4 @@ -412,57 +407,57 @@ The following deprecated methods are removed. [[Feature #18571]] -## C API updates +## C API 변경 -### Updated C APIs +### 갱신된 C API -The following APIs are updated. +다음 API가 갱신됩니다. -* PRNG update - * `rb_random_interface_t` updated and versioned. - Extension libraries which use this interface and built for older versions. - Also `init_int32` function needs to be defined. +* PRNG 갱신 + * `rb_random_interface_t`가 갱신되어 새 버전이 되었습니다. + 이 인터페이스를 구버전으로 사용하고 있다면 새 인터페이스를 사용해야합니다. + 또한 `init_int32` 함수를 정의할 필요가 있습니다. -### Removed C APIs +### 삭제된 C API -The following deprecated APIs are removed. +다음 폐기 예정인 API가 삭제됩니다. -* `rb_cData` variable. -* "taintedness" and "trustedness" functions. [[Feature #16131]] +* `rb_cData` 변수. +* "taintedness"와 "trustedness" 함수. [[Feature #16131]] -## Standard library updates +## 표준 라이브러리 갱신 * Bundler - * Add --ext=rust support to bundle gem for creating simple gems with Rust extensions. + * Rust 확장을 사용하는 젬을 위한 젬 생성 명령에 --ext=rust 옵션을 추가했습니다. [[GH-rubygems-6149]] - * Make cloning git repos faster [[GH-rubygems-4475]] + * Git 저장소 클론이 빨라집니다. [[GH-rubygems-4475]] * RubyGems - * Add mswin support for cargo builder. [[GH-rubygems-6167]] + * Cargo 빌더를 위한 mswin 지원이 추가됩니다. [[GH-rubygems-6167]] * ERB - * `ERB::Util.html_escape` is made faster than `CGI.escapeHTML`. - * It no longer allocates a String object when no character needs to be escaped. - * It skips calling `#to_s` method when an argument is already a String. - * `ERB::Escape.html_escape` is added as an alias to `ERB::Util.html_escape`, - which has not been monkey-patched by Rails. + * `ERB::Util.html_escape`가 `CGI.escapeHTML`보다 빨라졌습니다. + * 이스케이프가 필요한 문자열이 없는 경우, String 객체를 생성하지 않습니다. + * 인수가 String 객체일 경우, `#to_s` 메소드를 호출하지 않습니다. + * `ERB::Util.html_escape`의 별명으로 `ERB::Escape.html_escape`가 추가됩니다. + 더이상 Rails에서 몽키패치를 할 필요가 없습니다. * IRB - * debug.gem integration commands have been added: `debug`, `break`, `catch`, + * debug.gem 통합 명령이 추가됩니다. `debug`, `break`, `catch`, `next`, `delete`, `step`, `continue`, `finish`, `backtrace`, `info` - * They work even if you don't have `gem "debug"` in your Gemfile. - * See also: [What's new in Ruby 3.2's IRB?](https://st0012.dev/whats-new-in-ruby-3-2-irb) - * More Pry-like commands and features have been added. - * `edit` and `show_cmds` (like Pry's `help`) are added. - * `ls` takes `-g` or `-G` option to filter out outputs. - * `show_source` is aliased from `$` and accepts unquoted inputs. - * `whereami` is aliased from `@`. + * 이 명령들은 Gemfile에 `gem "debug"`가 없어도 동작합니다. + * [What's new in Ruby 3.2's IRB?](https://st0012.dev/whats-new-in-ruby-3-2-irb)를 참고하세요. + * Pry와 비슷한 명령과 기능이 추가됩니다. + * `edit`와 `show_cmds`(Pry의 `help`)가 추가됩니다. + * `ls` 명령이 출력을 필터링하기 위한 `-g`, `-G` 옵션이 추가됩니다. + * `show_source`의 별명으로 `$`가 추가되었으며, 이제 인수를 이스케이프하지 않아도 됩니다. + * `whereami`의 별명으로 `@`가 추가됩니다. -* The following default gems are updated. +* 다음 기본 젬이 갱신되었습니다. * RubyGems 3.4.1 * abbrev 0.1.1 @@ -529,7 +524,7 @@ The following deprecated APIs are removed. * yaml 0.2.1 * zlib 3.0.0 -* The following bundled gems are updated. +* 다음 내장 젬이 갱신되었습니다. * minitest 5.16.3 * power_assert 2.0.3 @@ -542,18 +537,18 @@ The following deprecated APIs are removed. * typeprof 0.21.3 * debug 1.7.1 -See GitHub releases like [GitHub Releases of logger](https://github.com/ruby/logger/releases) or changelog for details of the default gems or bundled gems. +기본 젬과 내정 젬의 상세한 설명은 [logger의 GitHub 릴리스](https://github.com/ruby/logger/releases)와 같은 GitHub 릴리스 또는 Changelog를 참조해주세요. -See [NEWS](https://github.com/ruby/ruby/blob/{{ release.tag }}/NEWS.md) -or [commit logs](https://github.com/ruby/ruby/compare/v3_1_0...{{ release.tag }}) -for more details. +더 자세한 내용은 [NEWS](https://github.com/ruby/ruby/blob/{{ release.tag }}/NEWS.md)나 +[커밋 로그](https://github.com/ruby/ruby/compare/v3_1_0...{{ release.tag }})를 +확인해주세요. -With those changes, [{{ release.stats.files_changed }} files changed, {{ release.stats.insertions }} insertions(+), {{ release.stats.deletions }} deletions(-)](https://github.com/ruby/ruby/compare/v3_1_0...{{ release.tag }}#file_bucket) -since Ruby 3.1.0! +이러한 변경사항에 따라, Ruby 3.1.0 이후로 [파일 {{ release.stats.files_changed }}개 수정, {{ release.stats.insertions }}줄 추가(+), {{ release.stats.deletions }}줄 삭제(-)](https://github.com/ruby/ruby/compare/v3_1_0...{{ release.tag }}#file_bucket) +가 이루어졌습니다! -Merry Christmas, Happy Holidays, and enjoy programming with Ruby 3.2! +메리 크리스마스, 해피 홀리데이, 그리고 Ruby 3.2과 함께 프로그래밍을 즐겨보세요! -## Download +## 다운로드 * <{{ release.url.gz }}> @@ -576,11 +571,11 @@ Merry Christmas, Happy Holidays, and enjoy programming with Ruby 3.2! SHA256: {{ release.sha256.zip }} SHA512: {{ release.sha512.zip }} -## What is Ruby +## Ruby는 -Ruby was first developed by Matz (Yukihiro Matsumoto) in 1993, -and is now developed as Open Source. It runs on multiple platforms -and is used all over the world especially for web development. +Ruby는 1993년에 Matz(마츠모토 유키히로) 씨가 처음 개발했고, +현재는 오픈 소스로서 개발되고 있습니다. 여러 플랫폼에서 동작하며, +특히 웹 개발에서 전 세계적으로 이용되고 있습니다. [Feature #12005]: https://bugs.ruby-lang.org/issues/12005 [Feature #12084]: https://bugs.ruby-lang.org/issues/12084 From 550677b315c8969d125bc57ecc88e4316f2debb5 Mon Sep 17 00:00:00 2001 From: Shia Date: Fri, 30 Dec 2022 09:18:34 +0900 Subject: [PATCH 03/14] Update ko/news/_posts/2022-12-25-ruby-3-2-0-released.md Co-authored-by: Chayoung You --- ko/news/_posts/2022-12-25-ruby-3-2-0-released.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/ko/news/_posts/2022-12-25-ruby-3-2-0-released.md b/ko/news/_posts/2022-12-25-ruby-3-2-0-released.md index 7c88658c88..7fb3104198 100644 --- a/ko/news/_posts/2022-12-25-ruby-3-2-0-released.md +++ b/ko/news/_posts/2022-12-25-ruby-3-2-0-released.md @@ -1,8 +1,8 @@ --- layout: news_post title: "Ruby 3.2.0 릴리스" -author: "shia" -translator: +author: "naruse" +translator: "shia" date: 2022-12-25 00:00:00 +0000 lang: ko --- From 983db11920000e51e8d6abaf03c3cb53e6b8c20b Mon Sep 17 00:00:00 2001 From: Shia Date: Fri, 30 Dec 2022 09:25:28 +0900 Subject: [PATCH 04/14] =?UTF-8?q?s/=EC=A0=AC/gem/g?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Chayoung You --- ko/news/_posts/2022-12-25-ruby-3-2-0-released.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/ko/news/_posts/2022-12-25-ruby-3-2-0-released.md b/ko/news/_posts/2022-12-25-ruby-3-2-0-released.md index 7fb3104198..1d315ec2c5 100644 --- a/ko/news/_posts/2022-12-25-ruby-3-2-0-released.md +++ b/ko/news/_posts/2022-12-25-ruby-3-2-0-released.md @@ -457,7 +457,7 @@ sum = ary[0] + ary[1] * `show_source`의 별명으로 `$`가 추가되었으며, 이제 인수를 이스케이프하지 않아도 됩니다. * `whereami`의 별명으로 `@`가 추가됩니다. -* 다음 기본 젬이 갱신되었습니다. +* 다음 기본 gem이 갱신되었습니다. * RubyGems 3.4.1 * abbrev 0.1.1 @@ -524,7 +524,7 @@ sum = ary[0] + ary[1] * yaml 0.2.1 * zlib 3.0.0 -* 다음 내장 젬이 갱신되었습니다. +* 다음 내장 gem이 갱신되었습니다. * minitest 5.16.3 * power_assert 2.0.3 @@ -537,7 +537,7 @@ sum = ary[0] + ary[1] * typeprof 0.21.3 * debug 1.7.1 -기본 젬과 내정 젬의 상세한 설명은 [logger의 GitHub 릴리스](https://github.com/ruby/logger/releases)와 같은 GitHub 릴리스 또는 Changelog를 참조해주세요. +기본 gem과 내장 gem의 상세한 설명은 [logger의 GitHub 릴리스](https://github.com/ruby/logger/releases)와 같은 GitHub 릴리스 또는 Changelog를 참조해주세요. 더 자세한 내용은 [NEWS](https://github.com/ruby/ruby/blob/{{ release.tag }}/NEWS.md)나 [커밋 로그](https://github.com/ruby/ruby/compare/v3_1_0...{{ release.tag }})를 From ba0a3267e06e9ea960fc2188ef393fe691171619 Mon Sep 17 00:00:00 2001 From: Shia Date: Fri, 30 Dec 2022 09:27:06 +0900 Subject: [PATCH 05/14] =?UTF-8?q?s/=EC=A0=95=EC=88=98/=EC=83=81=EC=88=98/g?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Chayoung You --- ko/news/_posts/2022-12-25-ruby-3-2-0-released.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/ko/news/_posts/2022-12-25-ruby-3-2-0-released.md b/ko/news/_posts/2022-12-25-ruby-3-2-0-released.md index 1d315ec2c5..11904c9b05 100644 --- a/ko/news/_posts/2022-12-25-ruby-3-2-0-released.md +++ b/ko/news/_posts/2022-12-25-ruby-3-2-0-released.md @@ -67,7 +67,7 @@ Ruby의 웹어셈블리/WASI 지원은 이러한 프로젝트들을 활용하기 * `RubyVM::YJIT.runtime_stats`가 제공하는 통계 정보가 이번 릴리스부터 이용가능합니다. * 통계 정보를 계산하고 얻기 위해서는 Ruby를 `--yjit-stats`와 함께 실행하세요(약간의 실행시간 오버헤드가 발생합니다). * YJIT은 Object shape를 이용해 최적화합니다. [[Feature #18776]] -* 정수를 유효화하는 단위를 작게하여 새 정수를 정의할 때 더 적은 코드를 무효화합니다. [[Feature #18589]] +* 상수를 무효화하는 단위를 작게 하여 새 상수를 정의할 때 더 적은 코드를 무효화합니다. [[Feature #18589]] * `--yjit-exec-mem-size`의 기본값이 64(MiB)로 변경됩니다. * `--yjit-call-threshold`의 기본값이 30으로 변경됩니다. @@ -174,14 +174,14 @@ sum = ary[0] + ary[1] # => [1, 2] ``` -* 정수 대입에서의 정수 평가 순서가 단일 대입시의 평가 순서와 +* 상수 대입에서의 상수 평가 순서가 단일 속성 대입 시의 평가 순서와 일관성을 가지게 됩니다. 다음 코드의 경우, ```ruby foo::BAR = baz ``` - `foo`는 이제 `baz`보다 먼저 호출됩니다. 마찬가지로 정수의 다중 대입에서도 + `foo`는 이제 `baz`보다 먼저 호출됩니다. 마찬가지로 상수의 다중 대입에서도 왼쪽에서 오른쪽으로 평가됩니다. 다음 코드의 경우, ```ruby @@ -362,9 +362,9 @@ sum = ary[0] + ary[1] 주의: 기능 개선, 버그 수정은 포함되어 있지 않습니다. -### 삭제된 정수 +### 삭제된 상수 -폐기 예정이었던 정수가 삭제됩니다. +폐기 예정이었던 상수가 삭제됩니다. * `Fixnum` and `Bignum` [[Feature #12005]] * `Random::DEFAULT` [[Feature #17351]] From 517ff4ddcfccc389c1d4daf20edd21355a979fe2 Mon Sep 17 00:00:00 2001 From: Shia Date: Fri, 30 Dec 2022 09:29:05 +0900 Subject: [PATCH 06/14] Improve translations Co-authored-by: Chayoung You --- .../_posts/2022-12-25-ruby-3-2-0-released.md | 38 +++++++++---------- 1 file changed, 19 insertions(+), 19 deletions(-) diff --git a/ko/news/_posts/2022-12-25-ruby-3-2-0-released.md b/ko/news/_posts/2022-12-25-ruby-3-2-0-released.md index 11904c9b05..bf385e9825 100644 --- a/ko/news/_posts/2022-12-25-ruby-3-2-0-released.md +++ b/ko/news/_posts/2022-12-25-ruby-3-2-0-released.md @@ -32,7 +32,7 @@ Ruby의 웹어셈블리/WASI 지원은 이러한 프로젝트들을 활용하기 ### 기술적인 부분 -현재 WASI와 웹어셈블리 자체에는 Fiber, 예외 처리, GC를 구현하기 위한 일부 기능이 부족합니다. 이는 여전히 개발중이라는 점도 있지만, 보안 때문이기도 합니다. 그래서 CRuby는 사용자 공간에서의 실행을 제어하기 위한 바이너리 변환 기술인 Asyncify를 사용해 그 차이를 메꿉니다. +현재 WASI와 웹어셈블리 자체에는 Fiber, 예외 처리, GC를 구현하기 위한 일부 기능이 부족합니다. 이는 여전히 개발 중이라는 점도 있지만, 보안 때문이기도 합니다. 그래서 CRuby는 사용자 공간에서의 실행을 제어하기 위한 바이너리 변환 기술인 Asyncify를 사용해 그 차이를 메꿉니다. 나아가서 Ruby 앱을 간단하게 단일 .wasm 파일로 패키징할 수 있도록 [WASI 상에 VFS](https://github.com/kateinoigakukun/wasi-vfs/wiki/Getting-Started-with-CRuby)를 구현했습니다. 이는 Ruby 앱의 배포를 쉽게 해줄 것입니다. @@ -48,23 +48,23 @@ Ruby의 웹어셈블리/WASI 지원은 이러한 프로젝트들을 활용하기 * YJIT은 이제 정식 기능입니다. * 1년 이상의 기간에 실제 환경의 부하로 테스트되었으며, 안정적임이 증명되었습니다. -* YJIT은 x86-64와 arm64/aarch64 CPU에서 움직이는 Linux, MacOS, BSD와 같은 UNIX 환경을 지원합니다. - * 이번 릴리스는 Apple M1/M2, AWS Graviton, Raspberry Pi 4등을 추가로 지원합니다. +* YJIT은 x86-64와 arm64/aarch64 CPU에서 동작하는 Linux, MacOS, BSD, 그 외 UNIX 환경을 지원합니다. + * 이번 릴리스는 Apple M1/M2, AWS Graviton, Raspberry Pi 4 등을 추가로 지원합니다. * YJIT을 빌드하기 위해서는 Rst 1.58.0 이상을 요구합니다. [[Feature #18481]] * CRuby를 YJIT과 함께 빌드하기 위해서는 `./configure` 스크립트를 실행하기 전에 1.58.0 이상의 `rustc`를 설치해주세요. - * 문제에 빠진 경우에는 YJIT 팀에 연락해주세요. + * 문제가 생긴 경우에는 YJIT 팀에 연락해주세요. * YJIT 3.2 릴리스는 3.1보다 빠르며, 메모리 오버헤드는 약 1/3이 되었습니다. - * [yjit-bench](https://github.com/Shopify/yjit-bench)에서 YJIT을 사용하면 그렇지 않은 Ruby 인터프리터보다 41% 빠릅니다. + * [yjit-bench](https://github.com/Shopify/yjit-bench)에서 YJIT을 사용하면 그렇지 않은 Ruby 인터프리터보다 41% 빠릅니다(기하 평균). * JIT 코드의 물리 메모리는 지연되어 할당됩니다. Ruby 3.1과는 다르게, `--yjit-exec-mem-size`는 JIT 코드에 의해서 실제로 최적화될 때까지 물리 메모리 페이지에 할당되지 않기 때문에 Ruby 프로세스의 RSS는 최소화됩니다. * JIT 코드로 인한 메모리 소비가 `--yjit-exec-mem-size`에 도달했을 때 - 모든 코드 페이지를 해방하는 코드 GC를 도입했습니다. + 모든 코드 페이지를 할당 해제하는 코드 GC를 도입했습니다. * `RubyVM::YJIT.runtime_stats`는 기존의 `inline_code_size`, `outlined_code_size`에 더해 코드 GC 정보인 `code_gc_count`, `live_page_count`, `freed_page_count`, `freed_code_size`를 반환합니다. -* `RubyVM::YJIT.runtime_stats`가 제공하는 통계 정보가 이번 릴리스부터 이용가능합니다. +* `RubyVM::YJIT.runtime_stats`가 제공하는 통계 정보가 이번 릴리스부터 이용 가능합니다. * 통계 정보를 계산하고 얻기 위해서는 Ruby를 `--yjit-stats`와 함께 실행하세요(약간의 실행시간 오버헤드가 발생합니다). * YJIT은 Object shape를 이용해 최적화합니다. [[Feature #18776]] * 상수를 무효화하는 단위를 작게 하여 새 상수를 정의할 때 더 적은 코드를 무효화합니다. [[Feature #18589]] @@ -140,7 +140,7 @@ long_time_re =~ "a" * 50000 + "x" # 타임아웃이 발생하지 않습니다. ### ErrorHighlight -* TypeError와 ArgumentError의 인수를 가리킬 수 있습니다. +* TypeError와 ArgumentError가 발생한 인수를 가리킵니다. ``` test.rb:2:in `+': nil can't be coerced into Integer (TypeError) @@ -163,7 +163,7 @@ sum = ary[0] + ary[1] end ``` -* 1개의 인수와 나머지를 키워드로 받는 프록은 인수를 자동으로 전개하지 +* 1개의 위치 인수와 나머지를 키워드로 받는 프록은 인수를 자동으로 전개하지 않습니다. [[Bug #18633]] ```ruby @@ -238,14 +238,14 @@ sum = ary[0] + ary[1] * MJIT 컴파일러는 `ruby_vm/mjit/compiler`라는 이름으로 Ruby를 사용해 재구현되었습니다. * MJIT 컴파일러는 MJIT 워커에 의해 실행된 네이티브 스레드 대신 포크된 프로세스에서 실행됩니다. [[Feature #18968]] - * 이 영향으로 Microsoft Visual Studio (MSWIN)이 더이상 지원되지 않습니다. + * 이 영향으로 Microsoft Visual Studio(MSWIN)가 더이상 지원되지 않습니다. * MinGW는 더이상 지원되지 않습니다. [[Feature #18824]] * `--mjit-min-calls`를 `--mjit-call-threshold`로 변경했습니다. * `--mjit-max-cache`의 기본값을 10000에서 100으로 되돌렸습니다. ### PubGrub -* Bundler 2.4는 [Molinillo](https://github.com/CocoaPods/Molinillo) 대신에 [PubGrub](https://github.com/jhawthorn/pub_grub) 의존해결기를 사용합니다. +* Bundler 2.4는 [Molinillo](https://github.com/CocoaPods/Molinillo) 대신에 [PubGrub](https://github.com/jhawthorn/pub_grub) 의존성 해결기를 사용합니다. * PubGrub은 Dart 프로그래밍 언어의 `pub` 패키지 매니저에서 사용하고 있는 차세대 의존성 해결 알고리즘입니다. * 이 변경으로 지금과는 다른 해결 결과를 얻을 수 있습니다. 그런 경우에는 [RubyGems/Bundler issues](https://github.com/rubygems/rubygems/issues)에 보고해주세요. @@ -254,7 +254,7 @@ sum = ary[0] + ary[1] ## 3.1 이후로 주목할 만한 변경 * Data - * 단순하며 변경불가능한 값 객체를 표현하기 위한 새 주요 클래스입니다. + * 단순한 불변 값 객체를 표현하기 위한 새 주요 클래스입니다. 이 클래스는 Struct와 비슷하며, 부분적으로 구현을 공유하고 있습니다만, 더 간결하며 한정적인 API를 제공합니다. [[Feature #16122]] @@ -290,8 +290,8 @@ sum = ary[0] + ary[1] * RubyVM::AbstractSyntaxTree * `parse`, `parse_file`, `of`에 `error_tolerant` 옵션이 추가되었습니다. [[Feature #19013]] 이 옵션을 사용하면, - 1. SyntaxError가 발생하지 않습니다 - 2. 올바르지 않은 입력에 대해서도 AST가 반환됩니다 + 1. SyntaxError가 발생하지 않습니다. + 2. 올바르지 않은 입력에 대해서도 AST가 반환됩니다. 3. 파서가 입력의 마지막에 도달했지만 `end`가 부족한 상태일 경우, 부족한 `end`를 추가합니다. 4. 들여쓰기를 참고해 `end`를 키워드로 취급합니다. @@ -314,7 +314,7 @@ sum = ary[0] + ary[1] RUBY p root # => # - # `end` 는 들여쓰기를 참고해 키워드로 취급됩니다 + # `end`는 들여쓰기를 참고해 키워드로 취급됩니다 root = RubyVM::AbstractSyntaxTree.parse(<<~RUBY, error_tolerant: true) module Z class Foo @@ -360,7 +360,7 @@ sum = ary[0] + ary[1] ## 호환성 문제 -주의: 기능 개선, 버그 수정은 포함되어 있지 않습니다. +주의: 기능 버그 수정은 포함되어 있지 않습니다. ### 삭제된 상수 @@ -414,7 +414,7 @@ sum = ary[0] + ary[1] 다음 API가 갱신됩니다. * PRNG 갱신 - * `rb_random_interface_t`가 갱신되어 새 버전이 되었습니다. + * `rb_random_interface_t`가 갱신되어 이제 버전을 가집니다. 이 인터페이스를 구버전으로 사용하고 있다면 새 인터페이스를 사용해야합니다. 또한 `init_int32` 함수를 정의할 필요가 있습니다. @@ -543,8 +543,8 @@ sum = ary[0] + ary[1] [커밋 로그](https://github.com/ruby/ruby/compare/v3_1_0...{{ release.tag }})를 확인해주세요. -이러한 변경사항에 따라, Ruby 3.1.0 이후로 [파일 {{ release.stats.files_changed }}개 수정, {{ release.stats.insertions }}줄 추가(+), {{ release.stats.deletions }}줄 삭제(-)](https://github.com/ruby/ruby/compare/v3_1_0...{{ release.tag }}#file_bucket) -가 이루어졌습니다! +이러한 변경사항에 따라, Ruby 3.1.0 이후로 [파일 {{ release.stats.files_changed }}개 수정, {{ release.stats.insertions }}줄 추가(+), {{ release.stats.deletions }}줄 삭제(-)](https://github.com/ruby/ruby/compare/v3_1_0...{{ release.tag }}#file_bucket)가 +이루어졌습니다! 메리 크리스마스, 해피 홀리데이, 그리고 Ruby 3.2과 함께 프로그래밍을 즐겨보세요! From 80559ea51d50f3e9f54d4715c03510a91df43b15 Mon Sep 17 00:00:00 2001 From: Shia Date: Fri, 30 Dec 2022 09:30:22 +0900 Subject: [PATCH 07/14] Fix up wrong translation Co-authored-by: Chayoung You --- ko/news/_posts/2022-12-25-ruby-3-2-0-released.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/ko/news/_posts/2022-12-25-ruby-3-2-0-released.md b/ko/news/_posts/2022-12-25-ruby-3-2-0-released.md index bf385e9825..687853be01 100644 --- a/ko/news/_posts/2022-12-25-ruby-3-2-0-released.md +++ b/ko/news/_posts/2022-12-25-ruby-3-2-0-released.md @@ -454,8 +454,8 @@ sum = ary[0] + ary[1] * Pry와 비슷한 명령과 기능이 추가됩니다. * `edit`와 `show_cmds`(Pry의 `help`)가 추가됩니다. * `ls` 명령이 출력을 필터링하기 위한 `-g`, `-G` 옵션이 추가됩니다. - * `show_source`의 별명으로 `$`가 추가되었으며, 이제 인수를 이스케이프하지 않아도 됩니다. - * `whereami`의 별명으로 `@`가 추가됩니다. + * `$`의 별명으로 `show_source`가 추가되었으며, 이제 인수를 따옴표로 감싸지 않아도 됩니다. + * `@`의 별명으로 `whereami`가 추가됩니다. * 다음 기본 gem이 갱신되었습니다. From 28c87a444a9f556d2f79a17be8d86286cc23c647 Mon Sep 17 00:00:00 2001 From: Shia Date: Fri, 30 Dec 2022 09:30:42 +0900 Subject: [PATCH 08/14] Fix typo(Rst -> Rust) Co-authored-by: Chayoung You --- ko/news/_posts/2022-12-25-ruby-3-2-0-released.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/ko/news/_posts/2022-12-25-ruby-3-2-0-released.md b/ko/news/_posts/2022-12-25-ruby-3-2-0-released.md index 687853be01..e7e3a45ac7 100644 --- a/ko/news/_posts/2022-12-25-ruby-3-2-0-released.md +++ b/ko/news/_posts/2022-12-25-ruby-3-2-0-released.md @@ -50,7 +50,7 @@ Ruby의 웹어셈블리/WASI 지원은 이러한 프로젝트들을 활용하기 * 1년 이상의 기간에 실제 환경의 부하로 테스트되었으며, 안정적임이 증명되었습니다. * YJIT은 x86-64와 arm64/aarch64 CPU에서 동작하는 Linux, MacOS, BSD, 그 외 UNIX 환경을 지원합니다. * 이번 릴리스는 Apple M1/M2, AWS Graviton, Raspberry Pi 4 등을 추가로 지원합니다. -* YJIT을 빌드하기 위해서는 Rst 1.58.0 이상을 요구합니다. [[Feature #18481]] +* YJIT을 빌드하기 위해서는 Rust 1.58.0 이상을 요구합니다. [[Feature #18481]] * CRuby를 YJIT과 함께 빌드하기 위해서는 `./configure` 스크립트를 실행하기 전에 1.58.0 이상의 `rustc`를 설치해주세요. * 문제가 생긴 경우에는 YJIT 팀에 연락해주세요. * YJIT 3.2 릴리스는 3.1보다 빠르며, 메모리 오버헤드는 약 1/3이 되었습니다. From ea21a81c273a9feeb3b82232fe87a00800e464d1 Mon Sep 17 00:00:00 2001 From: Shia Date: Fri, 30 Dec 2022 09:31:12 +0900 Subject: [PATCH 09/14] =?UTF-8?q?s/=EB=A9=94=EC=86=8C=EB=93=9C/=EB=A9=94?= =?UTF-8?q?=EC=84=9C=EB=93=9C/g?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Chayoung You --- ko/news/_posts/2022-12-25-ruby-3-2-0-released.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/ko/news/_posts/2022-12-25-ruby-3-2-0-released.md b/ko/news/_posts/2022-12-25-ruby-3-2-0-released.md index e7e3a45ac7..9d00d43489 100644 --- a/ko/news/_posts/2022-12-25-ruby-3-2-0-released.md +++ b/ko/news/_posts/2022-12-25-ruby-3-2-0-released.md @@ -371,9 +371,9 @@ sum = ary[0] + ary[1] * `Struct::Group` * `Struct::Passwd` -### 삭제된 메소드 +### 삭제된 메서드 -폐기 예정이었던 메소드가 삭제됩니다. +폐기 예정이었던 메서드가 삭제됩니다. * `Dir.exists?` [[Feature #17391]] * `File.exists?` [[Feature #17391]] @@ -441,7 +441,7 @@ sum = ary[0] + ary[1] * `ERB::Util.html_escape`가 `CGI.escapeHTML`보다 빨라졌습니다. * 이스케이프가 필요한 문자열이 없는 경우, String 객체를 생성하지 않습니다. - * 인수가 String 객체일 경우, `#to_s` 메소드를 호출하지 않습니다. + * 인수가 String 객체일 경우, `#to_s` 메서드를 호출하지 않습니다. * `ERB::Util.html_escape`의 별명으로 `ERB::Escape.html_escape`가 추가됩니다. 더이상 Rails에서 몽키패치를 할 필요가 없습니다. From fd7fc0b0e2cd22de8ff1f150ac5d6f08bca351dc Mon Sep 17 00:00:00 2001 From: Shia Date: Fri, 30 Dec 2022 09:32:01 +0900 Subject: [PATCH 10/14] Specify the commend which affected Co-authored-by: Chayoung You --- ko/news/_posts/2022-12-25-ruby-3-2-0-released.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/ko/news/_posts/2022-12-25-ruby-3-2-0-released.md b/ko/news/_posts/2022-12-25-ruby-3-2-0-released.md index 9d00d43489..d2cd55e014 100644 --- a/ko/news/_posts/2022-12-25-ruby-3-2-0-released.md +++ b/ko/news/_posts/2022-12-25-ruby-3-2-0-released.md @@ -429,7 +429,7 @@ sum = ary[0] + ary[1] * Bundler - * Rust 확장을 사용하는 젬을 위한 젬 생성 명령에 --ext=rust 옵션을 추가했습니다. + * Rust 확장을 사용하는 gem 생성을 위해 bundle gem 명령에 --ext=rust 옵션을 추가했습니다. [[GH-rubygems-6149]] * Git 저장소 클론이 빨라집니다. [[GH-rubygems-4475]] From 81c095dff405092f0060465783e108ed7b619812 Mon Sep 17 00:00:00 2001 From: Shia Date: Fri, 30 Dec 2022 10:59:14 +0900 Subject: [PATCH 11/14] Translate missed text --- .../_posts/2022-12-25-ruby-3-2-0-released.md | 29 +++++++++---------- 1 file changed, 14 insertions(+), 15 deletions(-) diff --git a/ko/news/_posts/2022-12-25-ruby-3-2-0-released.md b/ko/news/_posts/2022-12-25-ruby-3-2-0-released.md index d2cd55e014..2b57c544e7 100644 --- a/ko/news/_posts/2022-12-25-ruby-3-2-0-released.md +++ b/ko/news/_posts/2022-12-25-ruby-3-2-0-released.md @@ -200,26 +200,25 @@ sum = ary[0] + ary[1] * 검색 패턴은 이제 정식 기능입니다. [[Feature #18585]] -* Methods taking a rest parameter (like `*args`) and wishing to delegate keyword - arguments through `foo(*args)` must now be marked with `ruby2_keywords` - (if not already the case). In other words, all methods wishing to delegate - keyword arguments through `*args` must now be marked with `ruby2_keywords`, - with no exception. This will make it easier to transition to other ways of - delegation once a library can require Ruby 3+. Previously, the `ruby2_keywords` - flag was kept if the receiving method took `*args`, but this was a bug and an - inconsistency. A good technique to find potentially missing `ruby2_keywords` - is to run the test suite, find the last method which must - receive keyword arguments for each place where the test suite fails, and use `puts nil, caller, nil` there. Then check that each - method/block on the call chain which must delegate keywords is correctly marked - with `ruby2_keywords`. [[Bug #18625]] [[Bug #16466]] +* `*args`와 같은 나머지 인수를 받는 메서드에서 `foo(*args)`를 통해 키워드 인수를 + 위임하고 싶은 경우, 반드시 `ruby2_keywords`를 사용해야 합니다. 다르게 말하면, + `*args`를 사용해 키워드 인수를 위임하고 싶은 모든 메서드는 예외 없이 + `ruby2_keywords`를 사용해야 합니다. 이 변경으로 라이브러리가 Ruby 3 이상을 + 요구하게 되었을 때 다른 위임 방식으로의 마이그레이션이 간단해집니다. + 지금까지 메서드가 `*args`를 넘겨받았을 때, `ruby2_keywords` 플래그가 유지되었습니다만, + 이는 의도치 않은 동작이었으며, 일관성이 없었습니다. 빠져있었던 `ruby2_keywords`를 + 찾아내기 위한 좋은 방법 중 한 가지로 테스트를 실행한 뒤, 실패하는 각각의 테스트에서 + 키워드 인수를 받는 마지막 메서드를 찾고, 그곳에서 `puts nil, caller, nil`를 사용하세요. + 그리고 나서 호출 체인의 각 메서드/블록이 키워드를 위임할 때 `ruby2_keywords`를 + 올바르게 사용하고 있는지 확인하세요. [[Bug #18625]] [[Bug #16466]] ```ruby def target(**kw) end - # Accidentally worked without ruby2_keywords in Ruby 2.7-3.1, ruby2_keywords - # needed in 3.2+. Just like (*args, **kwargs) or (...) would be needed on - # both #foo and #bar when migrating away from ruby2_keywords. + # 의도치 않게 Ruby 2.7-3.1에서 ruby2_keywords 없이 동작했습니다만, + # Ruby 3.2+에서는 ruby2_keywords가 필요합니다. ruby2_keywords를 사용하지 않는 경우, + # #foo, #bar 양쪽에 (*args, &&kwargs)나 (...)이 필요합니다. ruby2_keywords def bar(*args) target(*args) end From 94c3114d75592ec22b13f1b66c86a4b3e2fabf26 Mon Sep 17 00:00:00 2001 From: Shia Date: Fri, 30 Dec 2022 11:03:58 +0900 Subject: [PATCH 12/14] Fix up wrong translation Co-authored-by: Chayoung You --- ko/news/_posts/2022-12-25-ruby-3-2-0-released.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/ko/news/_posts/2022-12-25-ruby-3-2-0-released.md b/ko/news/_posts/2022-12-25-ruby-3-2-0-released.md index 2b57c544e7..b89fe3b524 100644 --- a/ko/news/_posts/2022-12-25-ruby-3-2-0-released.md +++ b/ko/news/_posts/2022-12-25-ruby-3-2-0-released.md @@ -442,7 +442,7 @@ sum = ary[0] + ary[1] * 이스케이프가 필요한 문자열이 없는 경우, String 객체를 생성하지 않습니다. * 인수가 String 객체일 경우, `#to_s` 메서드를 호출하지 않습니다. * `ERB::Util.html_escape`의 별명으로 `ERB::Escape.html_escape`가 추가됩니다. - 더이상 Rails에서 몽키패치를 할 필요가 없습니다. + 이 함수는 Rails에서 몽키패치를 하지 않았습니다. * IRB From 4717b0fdffc65aa229d41fb1ac925ca33302473f Mon Sep 17 00:00:00 2001 From: Shia Date: Fri, 30 Dec 2022 11:18:06 +0900 Subject: [PATCH 13/14] Update ko/news/_posts/2022-12-25-ruby-3-2-0-released.md --- ko/news/_posts/2022-12-25-ruby-3-2-0-released.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/ko/news/_posts/2022-12-25-ruby-3-2-0-released.md b/ko/news/_posts/2022-12-25-ruby-3-2-0-released.md index b89fe3b524..d5e7c01915 100644 --- a/ko/news/_posts/2022-12-25-ruby-3-2-0-released.md +++ b/ko/news/_posts/2022-12-25-ruby-3-2-0-released.md @@ -365,7 +365,7 @@ sum = ary[0] + ary[1] 폐기 예정이었던 상수가 삭제됩니다. -* `Fixnum` and `Bignum` [[Feature #12005]] +* `Fixnum`, `Bignum` [[Feature #12005]] * `Random::DEFAULT` [[Feature #17351]] * `Struct::Group` * `Struct::Passwd` From ba393dd61967d5580f364622874a4788c554cee7 Mon Sep 17 00:00:00 2001 From: Shia Date: Fri, 30 Dec 2022 14:13:32 +0900 Subject: [PATCH 14/14] Apply suggestions from code review Co-authored-by: Chayoung You --- ko/news/_posts/2022-12-25-ruby-3-2-0-released.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/ko/news/_posts/2022-12-25-ruby-3-2-0-released.md b/ko/news/_posts/2022-12-25-ruby-3-2-0-released.md index d5e7c01915..aa625822cc 100644 --- a/ko/news/_posts/2022-12-25-ruby-3-2-0-released.md +++ b/ko/news/_posts/2022-12-25-ruby-3-2-0-released.md @@ -200,7 +200,7 @@ sum = ary[0] + ary[1] * 검색 패턴은 이제 정식 기능입니다. [[Feature #18585]] -* `*args`와 같은 나머지 인수를 받는 메서드에서 `foo(*args)`를 통해 키워드 인수를 +* `*args`와 같은 나머지 파라미터를 받는 메서드에서 `foo(*args)`를 통해 키워드 인수를 위임하고 싶은 경우, 반드시 `ruby2_keywords`를 사용해야 합니다. 다르게 말하면, `*args`를 사용해 키워드 인수를 위임하고 싶은 모든 메서드는 예외 없이 `ruby2_keywords`를 사용해야 합니다. 이 변경으로 라이브러리가 Ruby 3 이상을 @@ -218,7 +218,7 @@ sum = ary[0] + ary[1] # 의도치 않게 Ruby 2.7-3.1에서 ruby2_keywords 없이 동작했습니다만, # Ruby 3.2+에서는 ruby2_keywords가 필요합니다. ruby2_keywords를 사용하지 않는 경우, - # #foo, #bar 양쪽에 (*args, &&kwargs)나 (...)이 필요합니다. + # #foo, #bar 양쪽에 (*args, **kwargs)나 (...)이 필요합니다. ruby2_keywords def bar(*args) target(*args) end