Merge branch 'master' into changelog/1.16.0

Author: straight-shoota

.gitattributes

@@ -20,6 +20,8 @@ src/openssl/ssl/defaults.cr linguist-generated
 src/string/grapheme/properties.cr linguist-generated
 # produced by scripts/generate_unicode_data.cr
 src/unicode/data.cr linguist-generated
+# produced by scripts/generate_glob_specs.cr
+spec/std/file/match-fast-glob_spec.cr
 # produced by scripts/generate_grapheme_break_specs.cr
 spec/std/string/grapheme_break_spec.cr linguist-generated
 # produced by spec/generate_wasm32_spec.sh

.github/workflows/aarch64-github.yml

@@ -0,0 +1,85 @@
+name: AArch64 GitHub CI
+
+on: [push, pull_request]
+
+permissions: {}
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: ${{ github.ref != 'refs/heads/master' }}
+
+env:
+  SPEC_SPLIT_DOTS: 160
+
+jobs:
+  aarch64-github-cross-compile:
+    runs-on: ubuntu-24.04
+    steps:
+      - name: Download Crystal source
+        uses: actions/checkout@v4
+
+      - name: Install LLVM 20
+        run: |
+          sudo apt remove 'llvm-*' 'libllvm*'
+          wget -qO- https://apt.llvm.org/llvm-snapshot.gpg.key | sudo tee /etc/apt/trusted.gpg.d/apt.llvm.org.asc
+          sudo apt-add-repository -y deb http://apt.llvm.org/noble/ llvm-toolchain-noble-20 main
+          sudo apt install -y llvm-20-dev
+
+      - name: Install Crystal
+        uses: crystal-lang/install-crystal@v1
+        with:
+          crystal: "1.15.1"
+
+      - name: Cross-compile Crystal
+        run: make target=aarch64-linux-gnu release=1
+
+      - name: Upload crystal.o
+        uses: actions/upload-artifact@v4
+        with:
+          name: aarch64-linux-crystal-o
+          path: .build/crystal.o
+
+  aarch64-github-build:
+    runs-on: ubuntu-24.04-arm
+    needs: [aarch64-github-cross-compile]
+    steps:
+      - name: Checkout Crystal source
+        uses: actions/checkout@v4
+
+      - name: Install LLVM 20
+        run: |
+          sudo apt remove 'llvm-*' 'libllvm*'
+          wget -qO- https://apt.llvm.org/llvm-snapshot.gpg.key | sudo tee /etc/apt/trusted.gpg.d/apt.llvm.org.asc
+          sudo apt-add-repository -y deb http://apt.llvm.org/noble/ llvm-toolchain-noble-20 main
+          sudo apt install -y llvm-20-dev
+
+      - name: Install dependencies
+        run: |
+          sudo apt install -y lld libgc-dev libpcre2-dev
+
+      - name: Download crystal.o
+        uses: actions/download-artifact@v4
+        with:
+          name: aarch64-linux-crystal-o
+
+      - name: Link Crystal
+        run: |
+          mkdir .build
+          # shellcheck disable=SC2046
+          cc crystal.o -o .build/crystal \
+            $(pkg-config bdw-gc libpcre2-8 --libs) \
+            $(llvm-config-20 --libs --system-libs --ldflags) \
+            -lm
+          bin/crystal --version
+
+      - name: Run stdlib specs
+        run: make std_spec
+
+      - name: Run compiler specs
+        run: make compiler_spec
+
+      - name: Run interpreter specs
+        run: make interpreter_spec
+
+      - name: Run primitives specs
+        run: make -o .build/crystal.exe primitives_spec # we know the compiler is fresh; do not rebuild it here

CHANGELOG.0.md

@@ -52,16 +52,16 @@ documentation available on the official web site.
 *--mcpu* _CPU_::
 Specify a specific CPU to generate code for. This will pass a
 -mcpu flag to LLVM, and is only intended to be used for cross-
-compilation. For a list of available CPUs, invoke "llvm-as <
-/dev/null | llc -march=xyz -mcpu=help".  Passing --mcpu native
+compilation. For a list of available CPUs, pass --mcpu help
+when building any Crystal source code.  Passing --mcpu native
 will pass the host CPU name to tune performance for the host.
 *--mattr* _CPU_::
 Override or control specific attributes of the target, such as
 whether SIMD operations are enabled or not. The default set of
 attributes is set by the current CPU. This will pass a -mattr
 flag to LLVM, and is only intended to be used for cross-compilation. For a list of available attributes, invoke "llvm-as <
 /dev/null | llc -march=xyz -mattr=help".
-*--mcmodel* default|kernel|small|medium|large::
+*--mcmodel* default|kernel|tiny|small|medium|large::
 Specifies a specific code model to generate code for. This will
 pass a --code-model flag to LLVM.
 *--no-color*::

CHANGELOG.md

@@ -22,6 +22,9 @@ Variables:
 *CRYSTAL_CACHE_DIR*::
 Please see ENVIRONMENT VARIABLES.
 
+*CRYSTAL_EXEC_PATH*::
+Please see ENVIRONMENT VARIABLES.
+
 *CRYSTAL_LIBRARY_PATH*::
 Please see ENVIRONMENT VARIABLES.
 

doc/man/crystal-build.adoc

@@ -131,6 +131,9 @@ subsequent builds. This path is also used to temporarily store executables
 when Crystal programs are run with '*crystal* run' rather than '*crystal*
 build'.
 
+=== CRYSTAL_EXEC_PATH
+Determines the path where *crystal* looks for external sub-commands.
+
 === CRYSTAL_LIBRARY_PATH
 Defines paths where Crystal searches for (binary) libraries. Multiple paths
 can be separated by ":".	 These paths are passed to the linker as `-L`

doc/man/crystal-env.adoc

@@ -198,8 +198,8 @@ documentation available on the official web site.
 .RS 4
 Specify a specific CPU to generate code for. This will pass a
 \-mcpu flag to LLVM, and is only intended to be used for cross\-
-compilation. For a list of available CPUs, invoke "llvm\-as <
-/dev/null | llc \-march=xyz \-mcpu=help".  Passing \-\-mcpu native
+compilation. For a list of available CPUs, pass \-\-mcpu help
+when building any Crystal source code.  Passing \-\-mcpu native
 will pass the host CPU name to tune performance for the host.
 .RE
 .sp
@@ -212,7 +212,7 @@ flag to LLVM, and is only intended to be used for cross\-compilation. For a list
 /dev/null | llc \-march=xyz \-mattr=help".
 .RE
 .sp
-\fB\-\-mcmodel\fP default|kernel|small|medium|large
+\fB\-\-mcmodel\fP default|kernel|tiny|small|medium|large
 .RS 4
 Specifies a specific code model to generate code for. This will
 pass a \-\-code\-model flag to LLVM.
@@ -415,6 +415,11 @@ Variables:
 Please see ENVIRONMENT VARIABLES.
 .RE
 .sp
+\fBCRYSTAL_EXEC_PATH\fP
+.RS 4
+Please see ENVIRONMENT VARIABLES.
+.RE
+.sp
 \fBCRYSTAL_LIBRARY_PATH\fP
 .RS 4
 Please see ENVIRONMENT VARIABLES.
@@ -805,6 +810,9 @@ Defines path where Crystal caches partial compilation results for faster
 subsequent builds. This path is also used to temporarily store executables
 when Crystal programs are run with \*(Aq\fBcrystal\fP run\*(Aq rather than \*(Aq\fBcrystal\fP
 build\*(Aq.
+.SS "CRYSTAL_EXEC_PATH"
+.sp
+Determines the path where crystal looks for external sub-commands.
 .SS "CRYSTAL_LIBRARY_PATH"
 .sp
 Defines paths where Crystal searches for (binary) libraries. Multiple paths

doc/man/crystal.adoc

@@ -0,0 +1,11 @@
+def fibonacci(n : Int32) : Int32
+  return 0 if n < 0
+  return n if n <= 1
+
+  fibonacci(n - 1) + fibonacci(n - 2)
+end
+
+puts "First ten Fibonacci numbers:"
+(0..9).each do |n|
+  puts "fibonacci(#{n}) = #{fibonacci(n)}"
+end

man/crystal.1

@@ -0,0 +1,66 @@
+#!/bin/env bash
+
+# This tool generates the tests in spec/std/file/match-fast-glob_spec.cr
+# from https://github.com/oxc-project/fast-glob/blob/main/tests/test.rs
+# converted to Crystal
+
+set -euo pipefail
+
+target=spec/std/file/match-fast-glob_spec.cr
+URL="https://raw.githubusercontent.com/oxc-project/fast-glob/refs/heads/main/tests/test.rs"
+
+curl -L "$URL" |
+(
+  echo '
+# This file was automatically generated by running:
+#
+#   scripts/generate_glob_specs.cr
+#
+# DO NOT EDIT
+'
+
+echo "
+# These tests are autogenerated from $URL
+# They are are  collection of tests from bash and micromatch
+# https://github.com/micromatch/picomatch/blob/master/test/bash.js.
+"
+
+  echo '
+require "spec"
+
+private def assert_file_matches(pattern, path : String, *, file = __FILE__, line = __LINE__)
+  File.match?(pattern, path).should be_true, file: file, line: line
+  File.match?(pattern, Path.posix(path)).should be_true, file: file, line: line
+  File.match?(pattern, Path.posix(path).to_windows(mappings: false)).should be_true, file: file, line: line
+end
+
+private def refute_file_matches(pattern, path : String, *, file = __FILE__, line = __LINE__)
+  File.match?(pattern, path).should be_false, file: file, line: line
+  File.match?(pattern, Path.posix(path)).should be_false, file: file, line: line
+  File.match?(pattern, Path.posix(path).to_windows(mappings: false)).should be_false, file: file, line: line
+end
+'
+
+  echo 'describe "File .match? bash tests" do'
+
+  sed -E '1,5d' |
+  sed '/let patterns/,/#\[test\]/d; s/fn not_paired_braces/end\n\nfn not_paired_braces/' | # drop complex patterns implementation
+  sed '/fn fuzz_tests/,$d' | # drop complex fuzz tests implementation
+  sed '/^\s*#\[/d' |
+  sed -E 's/fn (.*)\(\) \{/it "\1" do/' |
+  sed -E 's/\}$/end/' |
+  sed -E 's|^\s*//|#|' |
+  sed -E 's/assert!\(!glob_match\("(.*)", "(.*)"\)\);/refute_file_matches "\1", "\2"/' |
+  sed -E 's/assert!\(glob_match\("(.*)", "(.*)"\)\);/assert_file_matches "\1", "\2"/' |
+  # multiline assertions:
+  sed -E 's/assert!\(glob_match\(/assert_file_matches(/' |
+  sed -E 's/assert!\(!glob_match\(/refute_file_matches(/' |
+  sed -E 's/\)\);/)/' |
+  sed -E 's/let //' |
+  sed -E 's/it "negation"/pending "negation"/' | # File.match? currently does not support negated patterns
+  sed -E '/it "generic_input"/,/end$/d' # Generic input tests are specific to Rust types
+
+  echo 'end'
+) > "$target"
+
+crystal tool format "$target"

samples/fibonacci.cr

@@ -0,0 +1,42 @@
+{% skip_file unless flag?(:execution_context) %}
+require "spec"
+
+describe Fiber::ExecutionContext::MultiThreaded do
+  it ".new" do
+    mt = Fiber::ExecutionContext::MultiThreaded.new("test", maximum: 2)
+    mt.size.should eq(0)
+    mt.capacity.should eq(2)
+
+    expect_raises(ArgumentError, "needs at least one thread") do
+      Fiber::ExecutionContext::MultiThreaded.new("test", maximum: -1)
+    end
+
+    expect_raises(ArgumentError, "needs at least one thread") do
+      Fiber::ExecutionContext::MultiThreaded.new("test", maximum: 0)
+    end
+
+    mt = Fiber::ExecutionContext::MultiThreaded.new("test", size: 0..2)
+    mt.size.should eq(0)
+    mt.capacity.should eq(2)
+
+    mt = Fiber::ExecutionContext::MultiThreaded.new("test", size: ..4)
+    mt.size.should eq(0)
+    mt.capacity.should eq(4)
+
+    mt = Fiber::ExecutionContext::MultiThreaded.new("test", size: 1..5)
+    mt.size.should eq(1)
+    mt.capacity.should eq(5)
+
+    mt = Fiber::ExecutionContext::MultiThreaded.new("test", size: 1...5)
+    mt.size.should eq(1)
+    mt.capacity.should eq(4)
+
+    expect_raises(ArgumentError, "needs at least one thread") do
+      Fiber::ExecutionContext::MultiThreaded.new("test", size: 0...1)
+    end
+
+    expect_raises(ArgumentError, "invalid range") do
+      Fiber::ExecutionContext::MultiThreaded.new("test", size: 5..1)
+    end
+  end
+end