1.9.0

Breaking

stdlib

• (numeric) Handle NaNs when comparing Big* numbers against Float (#13293, #13294, #13350, #13554, thanks @HertzDevil)
• (llvm) Remove most LLVM::DIBuilder functions from llvm_ext.cc (#13448, thanks @HertzDevil)

Features

lang

• (macros) Add warning macro (#13262, thanks @Blacksmoke16)
• (macros) Add print macro (#13336, thanks @jkthorne)

stdlib

• (collection) Add Enumerable#in_slices_of (#13108, thanks @pricelessrabbit)
• (collection) Add support for dash separator to Enum.parse (#13508, thanks @straight-shoota)
• (collection) Add Enum#to_i128 and #to_u128 (#13576, thanks @meatball133)
• (collection) Add Enumerable#partition overload with type filter (#13572, thanks @baseballlover723)
• (concurrency) Support asynchronous IO.pipe on Windows (#13362, thanks @HertzDevil)
• (files) [deprecation] Add File::MatchOptions to control Dir.glob's behavior (#13550, thanks @HertzDevil)
• (networking) Implement Socket#reuse_port on Windows (#13326, thanks @stakach)
• (networking) Add multicast support to UDPSocket on Windows (#13325, thanks @stakach)
• (networking) HTTP Server should allow custom concurrency models (#13428, thanks @stakach)
• (networking) Add Socket::IPaddress.v4, .v6, .v4_mapped_v6 (#13422, thanks @HertzDevil)
• (networking) Add URI::Params#merge, #merge! and URI#update_query_params (#13415, thanks @skinnyjames)
• (networking) Support Unix sockets on Windows (#13493, thanks @HertzDevil)
• (networking) Add HTTP::Request#form_params (#13418, thanks @threez)
• (numeric) Add BigDecimal#% (#13255, thanks @MattAlp)
• (numeric) Improve conversions from BigInt to Int::Primitive (#13562, thanks @HertzDevil)
• (runtime) Print error if unable to delay-load DLL on Windows (#13475, thanks @HertzDevil)
• (runtime) Add default interrupt handlers (#13568, thanks @straight-shoota)
• (serialization) Add ignore_serialize for YAML::Serializable (#13556, thanks @meatball133)
• (specs) Add a testcase line number to the output of JUnitFormatter (#13468, thanks @nobodywasishere)
• (specs) Publish the assert_prints spec helper (#13599, thanks @HertzDevil)
• (system) Implement Process.exec on Windows (#13374, thanks @HertzDevil)
• (system) Add File::BadExecutableError (#13491, thanks @HertzDevil)
• (text) Add inspection of Regex options support (#13354, thanks @straight-shoota)
• (text) Add Regex.literal (#13339, thanks @straight-shoota)
• (text) Implement #match! for Regex (#13285, thanks @devnote-dev)
• (text) Add parameters for Regex::MatchOptions to matching methods (#13353, thanks @straight-shoota)
• (text) Add Char#titlecase for correct mixed-case transformations (#13539, thanks @HertzDevil)
• (time) Add start_day parameter to Time#at_beginning_of_week (#13446, thanks @DanielGilchrist)
• (time) Map IANA time zone identifiers to Windows time zones (#13517, thanks @HertzDevil)
• (time) Add Time.unix_ns and #to_unix_ns (#13359, thanks @garymardell)

compiler

• Add message about non-release mode to crystal --version (#13254, thanks @will)
• Respect %CC% on Windows (#13376, thanks @HertzDevil)
• Support DLL delay-loading on Windows (#13436, thanks @HertzDevil)
• Support -static and -dynamic .lib suffixes on Windows (#13473, #13645, thanks @HertzDevil)
• Make compiler aware of output extension when building programs (#13370, thanks @HertzDevil)
• Support CRYSTAL_LIBRARY_RPATH for adding dynamic library lookup paths (#13499, thanks @HertzDevil)
• Add compiler command crystal clear_cache (#13553, thanks @baseballlover723)
• (codegen) Support LLVM 16 (#13181, thanks @HertzDevil)
• (semantic) Correctly ignore nested deprecation warnings (#13513, thanks @straight-shoota)

tools

• (docs-generator) Add dark mode to docs (#13512, thanks @GeopJr)
• (docs-generator) Add mobile support to docs (#13515, thanks @GeopJr)
• (formatter) [security] Formatter: escape bi-directional control characters within strings (#13067, thanks @HertzDevil)

Bugfixes

stdlib

• (collection) Fix Array#flatten to discard Iterator::Stop (#13388, thanks @straight-shoota)
• (collection) Fix return type of Iterator#chunk and Enumerable#chunks without Drop (#13506, thanks @straight-shoota)
• (collection) Fix Iterator#with_index(offset) with non-Int32 offset (#13612, thanks @HertzDevil)
• (concurrency) Fix preview_mt infinite loop on Windows (#13419, thanks @HertzDevil)
• (concurrency) Fix Atomic#max and #min for signed enums (#13524, thanks @HertzDevil)
• (concurrency) Fix timeout events getting lost on Windows (#13525, thanks @HertzDevil)
• (concurrency) Support Atomic(T)#compare_and_set when T is a reference union (#13565, thanks @HertzDevil)
• (files) Fix Dir#info on Windows (#13395, thanks @HertzDevil)
• (files) Windows: open standard streams in binary mode (#13397, thanks @HertzDevil)
• (files) Fix File.info(File::NULL) on Windows (#13421, thanks @HertzDevil)
• (files) Allow File.delete to remove read-only files on Windows (#13462, thanks @HertzDevil)
• (files) Make fcntl defined on all platforms (#13495, thanks @HertzDevil)
• (files) Allow Dir.delete to remove read-only directories on Windows (#13626, thanks @HertzDevil)
• (files) Use current directory's root for Dir.glob("/...") on Windows (#13628, thanks @HertzDevil)
• (llvm) Fix LLVM.default_target_triple to normalize aarch64 darwin target (#13597, thanks @straight-shoota)
• (log) Fix Log::Builder append BroadcastBackend to itself (#13405, thanks @straight-shoota)
• (macros) Fix error message for calling record macro with kwargs (#13367, thanks @a-alhusaini)
• (networking) Remove double URL escape in HTTP::Server::Response.redirect (#13321, thanks @threez)
• (networking) Fix WebSocket capitalization in docs (#13331, thanks @joshrickard)
• (networking) Fix TCPSocket#tcp_keepalive_idle on Windows (#13364, thanks @HertzDevil)
• (networking) Fix client-side TCPSocket#remote_address on ...

1.8.2

Standard Library

Collection

• Fix codegen bug with Iterator::ChainIterator (#13412, thanks @straight-shoota)

Log

• Fix Log::Metadata#dup crash with 2+ entries (#13369, thanks @HertzDevil)

Serialization

• Fixup for JSON::Serializable on certain recursively defined types (#13430, thanks @kostya)

Text

• Fix String#scan with empty Regex match at multibyte char (#13387, thanks @HertzDevil)
• (performance) Check subject UTF-8 validity just once for String#gsub, #scan, #split (#13406, thanks @HertzDevil)

Compiler

Codegen

• Always use 0 for offset of StaticArray's @buffer (#13319, thanks @HertzDevil)

Other

• Backport bugfixes to release/1.8 for release 1.8.2 (#3435, thanks @straight-shoota)

1.8.1

Standard Library

Serialization

• Fix JSON::Serializable on certain recursively defined types (#13344, thanks @HertzDevil)

Text

• Fix String#gsub with empty match at multibyte char (#13342, thanks @straight-shoota)
• Fix PCRE2 Regex with more than 127 named capture groups (#13349, thanks @HertzDevil)

1.8.0

Language

• The compiler uses PCRE2 to validate regex literals (#13084, thanks @straight-shoota)
• Fill docs for TupleLiteral (#12927, thanks @straight-shoota)
• Allow namespaced Paths as type names for lib (#12903, thanks @HertzDevil)

Standard Library

• Fix SyntaxHighlighter::HTML to escape identifier values (#13212, thanks @straight-shoota)
• Add workaround for Value#not_nil! copying the receiver (#13264, thanks @HertzDevil)
• Fix Pointer#copy_to overflow on unsigned size and different target type (#13269, thanks @HertzDevil)
• Docs: Added note about imports where necessary (#13026, #13066, thanks @Tamnac, @straight-shoota)
• Suppress compiler output in compile_file spec helper (#13228, thanks @straight-shoota)
• Define equality for Process::Status and OAuth::RequestToken (#13014, thanks @HertzDevil)
• Fix some Linux glibc bindings (#13242, #13249, thanks @ysbaddaden, @HertzDevil)

Collection

• (breaking-change) Fix Enum#includes? to require all bits set (#13229, thanks @straight-shoota)
• (breaking-change) Deprecate Enum.flags (#12900, thanks @straight-shoota)
• (breaking-change) Remove compile-time error for Range#size, #each, #sample (#13278, thanks @straight-shoota)
• (breaking-change) Docs: Require all Indexables to be stable (#13061, thanks @HertzDevil)
• Add Enum.[] convenience constructor (#12900, thanks @straight-shoota)
• Rename internal Iterator::Slice type to not conflict with ::Slice (#12983, thanks @Blacksmoke16)
• Fix Array#replace on shifted arrays (#13256, thanks @HertzDevil)
• Add Tuple#to_static_array (#12930, thanks @straight-shoota)
• Add Enum#inspect (#13004, thanks @straight-shoota)
• Add Slice#+(Slice) and Slice.join (#12081, thanks @HertzDevil)
• Add Enumerable#min(count) and #max(count) (#13057, thanks @nthiad)
• Fix Array(T)#[]=(Int, Int, Array(T)) on shifted arrays (#13275, thanks @HertzDevil)

Concurrency

• Fix: Make sure to dup Array in Channel.select_impl (#12827, #12962, thanks @straight-shoota)
• Add memory barriers on lock/unlock of SpinLock (#13050, thanks @bcardiff)
• (performance) Avoid Array allocation in Channel.select(Tuple) (#12960, thanks @straight-shoota)

Files

• (breaking-change) Deprecate Termios (#12940, thanks @HertzDevil)
• (breaking-change) Windows: make File.delete remove symlink directories, not Dir.delete (#13224, thanks @HertzDevil)
• Leverage fileapi for opening files on windows (#13178, thanks @Blacksmoke16)
• Windows: fix error condition when File.open fails (#13235, thanks @HertzDevil)
• Skip eacces spec for superuser (#13227, thanks @straight-shoota)
• Improve File.symlink on Windows (#13141, thanks @HertzDevil)
• Implement File.readlink on Windows (#13195, thanks @HertzDevil)

LLVM

• (breaking-change) Drop support for LLVM < 8 (#12906, thanks @straight-shoota)
• (breaking-change) Support LLVM 15 (#13173, thanks @HertzDevil)
• Error when find-llvm-config is unsuccessful (#13045, thanks @straight-shoota)
• Remove LibLLVM.has_constant?(:AttributeRef) checks (#13162, thanks @HertzDevil)
• Refactor LLVM::Attribute#each_kind to use Enum#each (#13234, thanks @straight-shoota)

Networking

• Fix socket specs when network not available (#12961, thanks @straight-shoota)
• Fix wrong default address when binding sockets (#13006, thanks @etra0)
• Clarify WebSocket documentation (#13096, thanks @j8r)
• Add Socket::IPAddress#link_local? (#13204, thanks @GeopJr)
• Clean up back\slash.txt in HTTP::StaticFileHandler specs (#12984, thanks @HertzDevil)
• Add MIME::Multipart.parse(HTTP::Client::Response, &) (#12890, thanks @straight-shoota)
• Replace LibC.ntohs and htons with native code (#13027, thanks @HertzDevil)
• Add OAuth2::Client#make_token_request returning HTTP response (#12921, thanks @cyangle)
• Use exhaustive case in HTTP::WebSocket#run (#13097, thanks @j8r)
• Increase time drift for HTTP::StaticFileHandler's gzip check (#13138, thanks @HertzDevil)
• OpenSSL: use Windows' system root certificate store (#13187, thanks @HertzDevil)
• Handle Range requests in HTTP::StaticFileHandler (#12886, thanks @jgaskins, @straight-shoota)
• Skip hostname spec if hostname command fails (#12987, thanks @Blacksmoke16)
• Fix Socket#tty? to false on Windows (#13175, thanks @Blacksmoke16)
• Fix HTTP::Server::Response#reset for status_message (#13282, thanks @straight-shoota)

Numeric

• Define Math.pw2ceil for all integer types (#13127, thanks @HertzDevil)
• Workaround for more Int128-and-float methods on Windows with LLVM 14+ (#13218, thanks @HertzDevil)
• Fix Int128-and-float conversion overflow checks on Windows LLVM 14+ (#13222, thanks @HertzDevil)
• Add Char.to_i128 and .to_u128 (#12958, thanks @meatball133)
• Docs: Add references to Number collection convenience constructors (#13020, thanks @straight-shoota)
• Docs: Fix examples for #byte_swap with different int types (#13154, #13180, thanks @pan, @Blacksmoke16)
• Make BigRational.new(BigFloat) exact (#13295, thanks @HertzDevil)

Runtime

• Increase timeout for slow specs (#13043, thanks @straight-shoota)
• Use Crystal::System.print_error instead of LibC.printf (#13161, thanks @HertzDevil)
• Windows: detect stack overflows on non-main Fibers (#13220, thanks @HertzDevil)
• Add missing require for Crystal::ThreadLocalValue (#13092, thanks @Sija)

Serialization

• Remove obsolete error handling in XPathContext (#13038, thanks @straight-shoota)
• Fix JSON, YAML use_*_discriminator for recursive Serializable::Strict types (#13238, thanks @HertzDevil)
• Add more specs for YAML::Any#[] and #[]? (#11646, thanks @straight-shoota)
• Add from_json for 128-bit integers (#13041, thanks @straight-shoota)
• Reduce JSON, YAML serializable test types (#13042, thanks @straight-shoota)

Specs

• Format spec results with pretty inspect (#11635, thanks @JamesGood626)
• Spec: Add --color option to spec runner ([#12932](https://github.com/crysta...

1.7.3

Standard Library

Text

• Do not use @[ThreadLocal] for PCRE2's JIT stack (#13056, thanks @HertzDevil)
• Fix libpcre2 bindings with arch-dependent types (SizeT) (#13088, thanks @straight-shoota)
• Fix libpcre2 bindings function pointers (#13090, thanks @straight-shoota)
• Fix PCRE2 do not allocate JIT stack if unavailable (#13100, thanks @straight-shoota)
• Backport PCRE2 fixes to 1.7 (#13136, thanks @straight-shoota)
• Fix MatchData#[] named capture with identical prefix (#13147, thanks @straight-shoota)
• Fix Regex::Option behaviour for unnamed members (#13155, thanks @straight-shoota)
• (performance) Improve PCRE2 match performance for JIT and interpreted (#13146, thanks @straight-shoota)

Compiler

Generics

• Explicitly treat unbound type vars in generic class methods as free variables (#13125, thanks @HertzDevil)

Other

• [CI] Fix add PCRE2 to GHA cache for win job (#13089, thanks @straight-shoota)
• [CI] Pin use_pcre in build environments where PCRE2 is not yet available (#13102, thanks @straight-shoota)

1.7.2

Runtime

• Fix: Add Nil return type restrictions to load_debug_info (#12992, thanks @straight-shoota)

Compiler

Codegen

• Add error handling to compiler when linker is unavailable (#12899, thanks @straight-shoota)

Parser

• Revert "Parser: Fix restrict grammar for name and supertype in type def (#12622)" (#12977, thanks @straight-shoota)

Other

• Update VERSION to 1.7.2-dev (#12993, thanks @straight-shoota)

1.7.1

Tools

Playground

• Fix baked-in path in playground to resolve at runtime (#12948, thanks @straight-shoota)

Other

• Update VERSION to 1.7.1-dev (#12950, thanks @straight-shoota)

1.7.0

Language

• Add lib functions earlier so that they are visible in top-level macros (#12848, thanks @asterite)

Standard Library

• Improve Benchmark docs (#12782, thanks @r00ster91, @straight-shoota)
• Improve documentation for Object#to_s and #inspect (#9974, thanks @straight-shoota)
• Add methods to manipulate semantic versions (#12834, thanks @gabriel-ss)
• Add types to methods with defaults (#12837, thanks @caspiano)
• examples: fix (2022-10) (#12665, thanks @maiha)
• Fix documentation for Pointer#move_to (#12677, thanks @TheEEs)
• (performance) Eliminate nil from many predicate methods (#12702, thanks @HertzDevil)
• examples: fix (2022-12) (#12870, thanks @maiha)

Collection

• Fix missed elements in Hash#select!(keys : Enumerable) (#12739, thanks @caspiano)
• Add missing docs for Indexable combinations methods (#10548, thanks @keidax)
• (performance) Optimize Range#sample(n) for integers and floats (#12535, thanks @straight-shoota)
• Add Iterable#each_cons_pair (#12726, thanks @caspiano)
• Add links to equivalent Iterator methods in Iterable (#12727, thanks @caspiano)
• (performance) Optimize Hash#select(Enumerable) and #merge!(Hash, &) (#12737, thanks @HertzDevil)
• Add Indexable#rindex! method variant (#12759, thanks @Sija)
• (performance) Use mutating collection methods (#12644, thanks @caspiano)
• Fix Enum#to_s for flag enum containing named and unnamed members (#12895, thanks @straight-shoota)

Concurrency

• Allow the EventLoop implementation to be detected at runtime (#12656, thanks @lbguilherme)
• (performance) Optimize uniqueness filter in Channel.select_impl (#12814, thanks @straight-shoota)
• Implement multithreading primitives on Windows (#11647, thanks @HertzDevil)

Crypto

• (breaking-change) Implement Digest class in Digest::CRC32 and Digest::Adler32 (#11535, thanks @BlobCodes)
• Fix OpenSSL::SSL::Context::Client#alpn_protocol= (#12724, thanks @jaclarke)
• Fix HTTP::Client certificate validation error on FQDN (host with trailing dot) (#12778, thanks @compumike)
• Enable arc4random(3) on all supported BSDs and macOS/Darwin (#12608, thanks @dmgk)

Files

• Fix: Read UInt in zip directory header (#12822, thanks @pbrumm)
• Add File.executable? for Windows (#9677, thanks @nof1000)

Macros

• Fix TypeNode#nilable? for root types (#12354, thanks @HertzDevil)
• Add argless #annotations overload (#9326, thanks @Blacksmoke16)
• Add specs for addition between ArrayLiteral and TupleLiteral (#12639, thanks @caspiano)
• Add ArrayLiteral#-(other) and TupleLiteral#-(other) (#12646, #12916 thanks @caspiano, @straight-shoota)

Networking

• (breaking-change) Add HTTP::Headers#serialize (#12765, thanks @straight-shoota)
• Ensure HTTP::Client closes response when breaking out of block (#12749, thanks @straight-shoota)
• Add HTTP::Server::Response#redirect (#12526, thanks @straight-shoota)
• (performance) Websocket: write masked data to temporary buffer before sending it (#12613, thanks @asterite)
• Validate cookie name prefixes (#10648, thanks @Blacksmoke16)
• IPAddress#loopback? should consider ::ffff:127.0.0.1/104 loopback too (#12783, thanks @carlhoerberg)

Numeric

• Support new SI prefixes in Number#humanize (#12761, thanks @HertzDevil)
• Fix BigInt#% for unsigned integers (#12773, thanks @straight-shoota)
• [WASM] Add missing __powisf2 and __powidf2 compiler-rt functions (#12569, thanks @lbguilherme)
• Add docs for Int#downto (#12468, thanks @yb66)
• Upgrade the Dragonbox algorithm (#12767, thanks @HertzDevil)
• Support scientific notation in BigDecimal#to_s (#10805, thanks @HertzDevil)
• Add #bit_reverse and #byte_swap for primitive integers (#12865, thanks @HertzDevil)
• Fix Number comparison operator docs (#12880, thanks @fdocr)

Runtime

• Exception::CallStack: avoid allocations in LibC.dl_iterate_phdr (#12625, thanks @dmgk)
• Fix explicit type conversion to u64 for GC::Stats (#12779, thanks @straight-shoota)
• Add custom message parameter to #not_nil! (#12797, thanks @straight-shoota)
• Refactor specs for Enum#to_s using assert_prints (#12882, thanks @straight-shoota)

Serialization

• (performance) Leverage GC.malloc_atomic for XML (#12692, thanks @HertzDevil)
• Refactor libXML error handling to remove global state (#12663, #12795, thanks @straight-shoota)
• Use qualified type reference YAML::Any (#12688, thanks @zw963)
• Automatically cast Int to Float for {JSON,YAML}::Any#as_f (#12835, thanks @compumike)

Specs

• Print seed info at start and end of spec output (#12755, thanks @straight-shoota)

System

• (breaking) Rename File.real_path to .realpath (#12552, thanks @straight-shoota)
• (breaking-change) Drop FreeBSD 11 compatibility code (#12612, thanks @dmgk)
• Trap when trying to raise wasm32 exceptions (#12572, thanks @lbguilherme)
• Use single helper method to pass UTF-16 strings to Windows (#12695, #12747, thanks @HertzDevil, @straight-shoota)
• Implement flock_* fiber-aware, without blocking the thread (#12861, #12728, thanks @straight-shoota)
• Implement flock_* for Win32 (#12766, thanks @straight-shoota)
• Add docs to ENV#has_key? (#12781, thanks @straight-shoota)
• Improve specs by removing absolute path references (#12776, thanks @straight-shoota)
• Update FreeBSD LibC types (#12651, thanks @dmgk)
• Organize Process specs (#12889, thanks @straight-shoota)
• Add tests for Process::Status (#12881, thanks @straight-shoota)

Text

• Raise IndexError on unmatched subpattern for MatchData#begin and #end (#12810, thanks @straight-shoota)
• Swap documentation for String#split array and block versions (#12808, thanks @hugopl)
• Add String#index/rindex! methods (#12730, thanks @Sija)
• Re-organize and enhance specs for Regex and Regex::MatchData (#12788, [#12789](https://github.com/crystal-lang/...

1.6.2

Language

• Fix VirtualMetaclassType#implements? to ignore base type (#12632, thanks @straight-shoota)

Compiler

• Compiler: handle yield expressions without a type (#12679, thanks @asterite)
• Partial revert "Compiler: refactor and slightly optimize merging two types (#12436)" (#12709, thanks @caspiano)

Semantic

• Compiler: ignore type filters when accepting cast for obj and to (#12668, thanks @asterite)

Other

• (security) CI: Update to OpenSSL 3.0.7 for bundled lib on Windows (#12712, thanks @beta-ziliani)

1.6.1

Compiler

Interpreter

• Interpreter (repl): migrate types even if their size remains the same (#12581, thanks @asterite)
• Unbreak the interpreter on FreeBSD (#12600, thanks @dmgk)
• Fix FFI specs on release builds (#12601, thanks @HertzDevil)
• Adding welcome message to the interpreter (#12511, thanks @beta-ziliani)

Semantic

• Treat single splats with same restriction as equivalent (#12584, thanks @HertzDevil)

Tools

Formatter

• Formatter: escape backslashes in macro literals when subformatting (#12582, thanks @asterite)

Playground

• Fix origin validation in playground server for localhost (#12599, thanks @straight-shoota)

Other

• Fix doc typos in Socket::IPAddress (#12583, thanks @Blacksmoke16)
• Fix building Wasm32 on Crystal 1.6 (Regression) (#12580, thanks @lbguilherme)
• Bump version to 1.6.1-dev (#12588, thanks @straight-shoota)
• Disable failing specs on Windows CI (#12585, thanks @HertzDevil)
• Detect llvm-configXX while building compiler (#12602, thanks @HertzDevil)