Fix "byexample" doc tests

Author: fnordfish

.devcontainer/Dockerfile

@@ -0,0 +1,26 @@
+FROM ruby:3.4
+
+ARG USERNAME=vscode
+ARG USER_UID=1000
+ARG USER_GID=$USER_UID
+
+RUN apt-get update && apt-get upgrade -y && \
+    apt-get install -y curl wget git procps && \
+    gem update --system && \
+    gem update bundler && \
+    # Add unprivileged user
+    groupadd --gid $USER_GID $USERNAME && \
+    useradd -s /bin/bash --uid $USER_UID --gid $USER_GID -m $USERNAME && \
+    # Cleaning up
+    apt-get autoremove -y && \
+    apt-get clean -y && \
+    rm -rf /var/lib/apt/lists/*
+
+COPY ./docker-entrypoint.sh /
+
+USER $USERNAME
+ENV GEM_HOME="/home/$USERNAME/.gem/ruby/$RUBY_VERSION"
+ENV PATH=$GEM_HOME/bin:$GEM_HOME/gems/bin:$PATH
+RUN mkdir -p $GEM_HOME
+
+ENTRYPOINT ["/docker-entrypoint.sh"]

.devcontainer/Gemfile

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+source "https://rubygems.org"
+git_source(:github) { |repo_name| "https://github.com/#{repo_name}" }
+
+gem "ruby-lsp"
+gem "standard"

.devcontainer/Gemfile.lock

@@ -0,0 +1,67 @@
+GEM
+  remote: https://rubygems.org/
+  specs:
+    ast (2.4.3)
+    json (2.13.2)
+    language_server-protocol (3.17.0.5)
+    lint_roller (1.1.0)
+    logger (1.7.0)
+    parallel (1.27.0)
+    parser (3.3.9.0)
+      ast (~> 2.4.1)
+      racc
+    prism (1.4.0)
+    racc (1.8.1)
+    rainbow (3.1.1)
+    rbs (3.9.4)
+      logger
+    regexp_parser (2.11.2)
+    rubocop (1.75.8)
+      json (~> 2.3)
+      language_server-protocol (~> 3.17.0.2)
+      lint_roller (~> 1.1.0)
+      parallel (~> 1.10)
+      parser (>= 3.3.0.2)
+      rainbow (>= 2.2.2, < 4.0)
+      regexp_parser (>= 2.9.3, < 3.0)
+      rubocop-ast (>= 1.44.0, < 2.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (>= 2.4.0, < 4.0)
+    rubocop-ast (1.46.0)
+      parser (>= 3.3.7.2)
+      prism (~> 1.4)
+    rubocop-performance (1.25.0)
+      lint_roller (~> 1.1)
+      rubocop (>= 1.75.0, < 2.0)
+      rubocop-ast (>= 1.38.0, < 2.0)
+    ruby-lsp (0.26.1)
+      language_server-protocol (~> 3.17.0)
+      prism (>= 1.2, < 2.0)
+      rbs (>= 3, < 5)
+    ruby-progressbar (1.13.0)
+    standard (1.50.0)
+      language_server-protocol (~> 3.17.0.2)
+      lint_roller (~> 1.0)
+      rubocop (~> 1.75.5)
+      standard-custom (~> 1.0.0)
+      standard-performance (~> 1.8)
+    standard-custom (1.0.2)
+      lint_roller (~> 1.0)
+      rubocop (~> 1.50)
+    standard-performance (1.8.0)
+      lint_roller (~> 1.1)
+      rubocop-performance (~> 1.25.0)
+    unicode-display_width (3.1.5)
+      unicode-emoji (~> 4.0, >= 4.0.4)
+    unicode-emoji (4.0.4)
+
+PLATFORMS
+  aarch64-linux
+  ruby
+
+DEPENDENCIES
+  ruby-lsp
+  standard
+
+BUNDLED WITH
+   2.7.1

.devcontainer/devcontainer.json

@@ -0,0 +1,74 @@
+// For format details, see https://aka.ms/devcontainer.json. For config options, see the
+// README at: https://github.com/devcontainers/templates/tree/main/src/ruby
+{
+	"name": "Teckel",
+	"dockerFile": "Dockerfile",
+	// Or use a Dockerfile or Docker Compose file. More info: https://containers.dev/guide/dockerfile
+	// "image": "mcr.microsoft.com/devcontainers/ruby:1-3.3-bullseye"
+
+	"workspaceFolder": "/workspaces/${localWorkspaceFolderBasename}",
+
+	// Features to add to the dev container. More info: https://containers.dev/features.
+	// "features": {},
+
+	// Use 'forwardPorts' to make a list of ports inside the container available locally.
+	// "forwardPorts": [],
+
+	// Use 'postCreateCommand' to run commands after the container is created.
+	"postCreateCommand": "bundle install",
+
+	"shutdownAction": "stopContainer",
+
+	// Configure tool-specific properties.
+	"customizations": {
+		"vscode": {
+			"extensions": [
+				"shopify.ruby-extensions-pack"
+			],
+			"settings": {
+				"[ruby]": {
+					"editor.defaultFormatter": "Shopify.ruby-lsp", // Use the Ruby LSP as the default formatter
+					"editor.formatOnSave": true, // Format files automatically when saving
+					"editor.tabSize": 2, // Use 2 spaces for indentation
+					"editor.insertSpaces": true, // Use spaces and not tabs for indentation
+					"editor.semanticHighlighting.enabled": true, // Enable semantic highlighting
+					"editor.formatOnType": true // Enable formatting while typing
+				},
+				"rubyLsp.addonSettings": {},
+				"rubyLsp.bundleGemfile": ".devcontainer/Gemfile",
+				// "rubyLsp.rubyExecutablePath": "chruby-exec ruby",
+				"rubyLsp.enabledFeatures": {
+					"codeActions": true,
+					"codeLens": true,
+					"completion": true,
+					"definition": true,
+					"diagnostics": true,
+					"documentHighlights": true,
+					"documentLink": true,
+					"documentSymbols": true,
+					"foldingRanges": true,
+					"formatting": true,
+					"hover": true,
+					"inlayHint": true,
+					"onTypeFormatting": true,
+					"selectionRanges": true,
+					"semanticHighlighting": true,
+					"signatureHelp": true,
+					"typeHierarchy": true,
+					"workspaceSymbol": true
+				},
+				"rubyLsp.formatter": "standard",
+				"rubyLsp.linters": [
+					"standard"
+				],
+				"rubyLsp.featureFlags": {
+					"all": true
+				}
+			}
+		}
+	},
+
+	// Uncomment to connect as root instead. More info: https://aka.ms/dev-containers-non-root.
+	// "remoteUser": "root"
+	"remoteUser": "vscode"
+}

.devcontainer/docker-entrypoint.sh

@@ -0,0 +1,7 @@
+#!/bin/bash
+set -e
+
+unset BUNDLE_PATH
+unset BUNDLE_BIN
+
+exec "$@"

.github/workflows/pages_specs.yml

@@ -22,7 +22,7 @@ jobs:
     - name: Set up Ruby
       uses: ruby/setup-ruby@v1
       with:
-        ruby-version: '2.7'
+        ruby-version: '3.4'
         bundler-cache: true
     - name: Setup python
       uses: actions/setup-python@v1

Gemfile

@@ -8,7 +8,7 @@ git_source(:github) { |repo_name| "https://github.com/#{repo_name}" }
 gemspec
 
 group :development, :test do
-  gem "irb", ">= 1.2.7", "< 2" if RUBY_VERSION >= "2.5"
+  gem "irb", "~> 1.4.1" if RUBY_VERSION >= "2.6" # byexample needs a specific irb version
   gem "dry-struct", ">= 1.1.1", "< 2"
   gem "dry-monads", ">= 1.3", "< 2"
   gem "dry-validation", ">= 1.5.6", "< 2"

_pages/docs/chains/around.md

@@ -89,6 +89,6 @@ Their hooks gets total control over the execution, so it needs to take care of c
 => true
 
 >> failure_result.failure
-=> {:message=>"Did not find a friend."}
+=> {message: "Did not find a friend."}
 ```
 {% endfilter %}

_pages/docs/chains/basics.md

@@ -102,7 +102,7 @@ Defining a simple Chain with three steps.
 => true
 
 >> failure_result.failure
-=> {:message=>"Did not find a friend."}
+=> {message: "Did not find a friend."}
 ```
 {% endfilter %}
 
@@ -121,8 +121,8 @@ Hash style:
 
 >> result
 => ["Success result",
-  {:friend=>#<User:<...> @age=42, @name="A friend">,
-   :user=>#<User:<...> @age=23, @name="Bob">}]
+  {friend: #<User:<...> @age=42, @name="A friend">,
+   user: #<User:<...> @age=23, @name="Bob">}]
 ```
 {% endfilter %}
 
@@ -138,6 +138,6 @@ Array style:
 .. end
 
 >> result
-=> ["Failed", {:message=>"Did not find a friend."}]
+=> ["Failed", {message: "Did not find a friend."}]
 ```
 {% endfilter %}

_pages/docs/operations/basics.md

@@ -54,7 +54,7 @@ A failure call:
 ```ruby
 >> CreateUserInline.call(name: "Bob", age: 10)
 => #<CreateUserInline::Error:<...>
-   @errors=[{:age=>"underage"}],
+   @errors=[{age: "underage"}],
    @message="Could not save User">
 ```
 {% endfilter %}
@@ -110,7 +110,7 @@ A failure call:
 {% filter remove_code_promt %}
 ```ruby
 >> CreateUserDry.call(name: "Bob", age: 10)
-=> {:errors=>[{:age=>"underage"}], :message=>"Could not save User"}
+=> {errors: [{age: "underage"}], message: "Could not save User"}
 ```
 {% endfilter %}
 
@@ -272,6 +272,6 @@ Array style:
 .. end
 
 >> result
-=> ["Failed", {:errors=>[{:age=>"underage"}], :message=>"Could not save User"}]
+=> ["Failed", {errors: [{age: "underage"}], message: "Could not save User"}]
 ```
 {% endfilter %}