Merge branch 'master' into dependabot/npm_and_yarn/q-io-2.0.6

Author: kmizu

README.md

@@ -153,6 +153,16 @@ sbt textBuildEpub
 
 ![CC-BY-NC-SA](https://licensebuttons.net/l/by-nc-sa/3.0/88x31.png)
 
-の元で配布されています。ただし、直接の利益を得ることを目的としない研修などに利用することは可能とします。
-直接の利益というのは、研修自体を実費以上の金額で提供する行為を指します。社内でのScala研修などは一般的に
-直接の利益を得ることを目的としないので、断りなく使っていただいて構いません。
+の元で配布されています。ただし、CC-BY-NC-SAの「非営利」は[こちら](https://creativecommons.org/licenses/by-nc-sa/4.0/legalcode.en#s3:~:text=NonCommercial%20provided%20there%20is%20no%20payment%20of%20monetary%20compensation%20in%20connection%20with%20the%20exchange.)にかかれている通り、
+
+> NonCommercial means not primarily intended for or directed towards commercial advantage or monetary compensation. For purposes of this Public License, the exchange of the Licensed Material for other material subject to Copyright and Similar Rights by digital file-sharing or similar means is NonCommercial provided there is no payment of monetary compensation in connection with the exchange.
+
+直接的な金銭のやり取りが発生するものであり、たとえば、社内の研修や社内での開発で利用する場合は営利に該当しません。
+
+また、本資料を改変した場合の公開義務についても[こちら](https://wiki.creativecommons.org/wiki/ShareAlike_interpretation#:~:text=The%20ShareAlike%20condition%20only%20applies%20when%20a%20work%20is%20publicly%20shared)
+
+> The ShareAlike condition only applies when a work is publicly shared. You are not obligated to share things you make from SA works--you may create remixes and adaptations that you do not publish. If you are using ShareAlike materials privately and not sharing them with others, you do not have to comply with the license conditions. For example, if you translate a ShareAlike work for internal use within your office, you do not have to license your translation under an SA or compatible license unless you plan to share it with others.
+
+にある通りです。たとえば本資料を改変して社内のドキュメントのために使ったとしても、一般に公開しない限り（社内のみで利用するなど）改変部分について本ライセンスを継承する必要はなく自由に利用可能です。
+
+これらの点について複数の問い合わせがあったため明記することにしました。

build.sbt

@@ -7,9 +7,9 @@ ThisBuild / onChangedBuildSource := ReloadOnSourceChanges
 
 name := "textbook"
 
-scalaVersion := "2.13.13"
+scalaVersion := "2.13.14"
 
-crossScalaVersions += "3.4.1"
+crossScalaVersions += "3.4.2"
 
 enablePlugins(MdocPlugin)
 
@@ -22,10 +22,10 @@ cleanFiles += compiledSrcDir
 libraryDependencies ++= Seq(
   // TODO sbtがScala 2.13対応したら再び有効化
   // "org.scala-sbt" % "sbt" % sbtVersion.value,
-  "org.mockito" % "mockito-core" % "5.11.0",
+  "org.mockito" % "mockito-core" % "5.12.0",
   "org.scalacheck" %% "scalacheck" % "1.18.0",
-  "org.scalatest" %% "scalatest-flatspec" % "3.2.18", // mdocで使うので、テストライブラリだが、わざとcompileスコープ
-  "org.scalatest" %% "scalatest-diagrams" % "3.2.18"
+  "org.scalatest" %% "scalatest-flatspec" % "3.2.19", // mdocで使うので、テストライブラリだが、わざとcompileスコープ
+  "org.scalatest" %% "scalatest-diagrams" % "3.2.19"
 )
 
 Honkit.settings

package-lock.json

@@ -5,13 +5,13 @@
   "description": "Scala初学者がScalaを学ぶためのテキスト",
   "scripts": {},
   "devDependencies": {
-    "@babel/core": "^7.24.5",
-    "@babel/preset-env": "^7.24.5",
-    "@babel/register": "^7.23.7",
+    "@babel/core": "^7.24.7",
+    "@babel/preset-env": "^7.24.7",
+    "@babel/register": "^7.24.6",
     "babel-preset-power-assert": "3.0.0",
     "cheerio": "1.0.0-rc.12",
     "eslint": "^8.57.0",
-    "eslint-config-eslint": "10.0.0",
+    "eslint-config-eslint": "11.0.0",
     "gitbook-plugin-anchors": "0.7.1",
     "gitbook-plugin-footnote-string-to-number": "0.0.2",
     "gitbook-plugin-forkmegithub": "^2.2.0",
@@ -20,7 +20,7 @@
     "gitbook-plugin-regexplace": "2.1.2",
     "honkit": "5.1.4",
     "kramed": "0.5.6",
-    "mocha": "10.4.0",
+    "mocha": "10.6.0",
     "npm-check-updates": "^16.14.20",
     "npm-run-all": "4.1.5",
     "power-assert": "1.6.1",

package.json

@@ -1 +1 @@
-sbt.version = 1.9.9
+sbt.version = 1.10.0

project/build.properties

@@ -1 +1 @@
-addSbtPlugin("org.scalameta" % "sbt-mdoc" % "2.5.2" )
+addSbtPlugin("org.scalameta" % "sbt-mdoc" % "2.5.4" )

project/plugins.sbt

@@ -30,7 +30,7 @@
 - この他のストレージ機能とパスワード機能のメソッドは内部的に使われるのみである
 
 上記のプログラムでは実際に動かすことができるように[ScalikeJDBC](https://github.com/scalikejdbc/scalikejdbc)というデータベース用のライブラリとjBCryptというパスワースのハッシュ値を計算するライブラリが使われていますが、実装の詳細を理解する必要はありません。
-既にメソッドの実装を説明したことがある場合は実装を省略し[`???`](https://github.com/scala/scala/blob/v2.13.13/src/library/scala/Predef.scala#L344)で書くことがあります。
+既にメソッドの実装を説明したことがある場合は実装を省略し[`???`](https://github.com/scala/scala/blob/v2.13.14/src/library/scala/Predef.scala#L344)で書くことがあります。
 
 ## リファクタリング：公開する機能を制限する
 

src/advanced-trait-di.md

@@ -20,7 +20,7 @@ $ sbt console
 とコマンドを打ってみましょう。
 
 ```
-Welcome to Scala version 2.13.13 (Java HotSpot(TM) 64-Bit Server VM, Java 1.8.0_45).
+Welcome to Scala version 2.13.14 (Java HotSpot(TM) 64-Bit Server VM, Java 1.8.0_45).
 Type in expressions to have them evaluated.
 Type :help for more information.
 

src/basic.md

@@ -22,7 +22,7 @@ mutableなコレクションを効果的に使えばプログラムの実行速
 - `Map`(immutable)・`Map`(mutable)
 - `Set`(immutable)・ `Set`(mutable)
 
-## [Array](https://github.com/scala/scala/blob/v2.13.13/src/library/scala/Array.scala)
+## [Array](https://github.com/scala/scala/blob/v2.13.14/src/library/scala/Array.scala)
 
 まずは大抵のプログラミング言語にある配列です。
 
@@ -96,7 +96,7 @@ arr
 
 <!-- end answer -->
 
-### [Range](https://github.com/scala/scala/blob/v2.13.13/src/library/scala/collection/immutable/Range.scala)
+### [Range](https://github.com/scala/scala/blob/v2.13.14/src/library/scala/collection/immutable/Range.scala)
 
 `Range`は範囲を表すオブジェクトです。`Range`は直接名前を指定して生成するより、`to`メソッドと`until`メソッドを用いて呼びだすことが多いです。また、`toList`メソッドを用いて、その範囲の数値の列を後述する`List`に変換することができます。では、早速REPLで`Range`を使ってみましょう。
 
@@ -112,7 +112,7 @@ arr
 
 `to`は右の被演算子を含む範囲を、`until`は右の被演算子を含まない範囲を表していることがわかります。また、`Range`は`toList`で後述する`List`に変換することができることもわかります。
 
-### [List](https://github.com/scala/scala/blob/v2.13.13/src/library/scala/collection/immutable/List.scala)
+### [List](https://github.com/scala/scala/blob/v2.13.14/src/library/scala/collection/immutable/List.scala)
 
 さて、導入として大抵の言語にある`Array`を出しましたが、Scalaでは`Array`を使うことはそれほど多くありません。代わりに`List`や
 `Vector`といったデータ構造をよく使います（`Vector`については後述します）。`List`の特徴は、一度作成したら中身を
@@ -132,9 +132,9 @@ lst(0) = 7
 
 ### Nil：空のList
 
-まず最初に紹介するのは`Nil`です。Scalaで空の`List`を表すには`Nil`というものを使います。Rubyなどでは`nil`は言語上かなり特別な意味を持ちますが、Scalaではデフォルトでスコープに入っているということ以外は特別な意味はなく[単にobjectです](https://github.com/scala/scala/blob/v2.13.13/src/library/scala/collection/immutable/List.scala#L662)。Nilは単体では意味がありませんが、次に説明する`::`と合わせて用いることが多いです。
+まず最初に紹介するのは`Nil`です。Scalaで空の`List`を表すには`Nil`というものを使います。Rubyなどでは`nil`は言語上かなり特別な意味を持ちますが、Scalaではデフォルトでスコープに入っているということ以外は特別な意味はなく[単にobjectです](https://github.com/scala/scala/blob/v2.13.14/src/library/scala/collection/immutable/List.scala#L662)。Nilは単体では意味がありませんが、次に説明する`::`と合わせて用いることが多いです。
 
-### [:: - Listの先頭に要素をくっつける](https://github.com/scala/scala/blob/v2.13.13/src/library/scala/collection/immutable/List.scala#L97)
+### [:: - Listの先頭に要素をくっつける](https://github.com/scala/scala/blob/v2.13.14/src/library/scala/collection/immutable/List.scala#L97)
 
 `::`（コンスと読みます）は既にある`List`の先頭に要素をくっつけるメソッドです。これについては、REPLで結果をみた方が早いでしょう。
 
@@ -742,7 +742,7 @@ List(1, 2, 3, 4) :+ 5 // 注意！末尾への追加は、Listの要素数分か
 
 `mkString`をはじめとした`List`の色々なメソッドを紹介してきましたが、実はこれらの大半は`List`特有ではなく、既に紹介した`Range`や`Array`、これから紹介する他のコレクションでも同様に使うことができます。何故ならばこれらの操作の大半は特定のコレクションではなく、コレクションのスーパータイプである共通のトレイト中に宣言されているからです。もちろん、`List`に要素を加える処理と`Set`に要素を加える処理（`Set`に既にある要素は加えない）のように、中で行われる処理が異なることがあるので、その点は注意する必要があります。詳しくは[ScalaのAPIドキュメント](https://www.scala-lang.org/api/current/index.html)を探索してみましょう。
 
-### [Vector](https://github.com/scala/scala/blob/v2.13.13/src/library/scala/collection/immutable/Vector.scala)
+### [Vector](https://github.com/scala/scala/blob/v2.13.14/src/library/scala/collection/immutable/Vector.scala)
 
 `Vector`は少々変わったデータ構造です。`Vector`は一度データ構造を構築したら変更できないimmutableなデータ構造
 です。要素へのランダムアクセスや長さの取得、データの挿入や削除、いずれの操作も十分に高速にできる比較的
@@ -763,11 +763,11 @@ Vector(1, 2, 3, 4, 5).updated(2, 5)
 `Map`はキーから値へのマッピングを提供するデータ構造です。他の言語では辞書や連想配列と呼ばれたりします。
 Scalaでは`Map`として一度作成したら変更できないimmutableな`Map`と変更可能なmutableな`Map`の2種類を提供しています。
 
-### [`scala.collection.immutable.Map`](https://github.com/scala/scala/blob/v2.13.13/src/library/scala/collection/immutable/Map.scala)
+### [`scala.collection.immutable.Map`](https://github.com/scala/scala/blob/v2.13.14/src/library/scala/collection/immutable/Map.scala)
 
 Scalaで何も設定せずにただ`Map`と書いた場合、`scala.collection.immutable.Map`が使われます。その名の通り、一度
-作成すると変更することはできません。内部の実装としては主に[`scala.collection.immutable.HashMap`](https://github.com/scala/scala/blob/v2.13.13/src/library/scala/collection/immutable/HashMap.scala)と
-[`scala.collection.immutable.TreeMap`](https://github.com/scala/scala/blob/v2.13.13/src/library/scala/collection/immutable/TreeMap.scala)の2種類がありますが、通常は`HashMap`が使われます。
+作成すると変更することはできません。内部の実装としては主に[`scala.collection.immutable.HashMap`](https://github.com/scala/scala/blob/v2.13.14/src/library/scala/collection/immutable/HashMap.scala)と
+[`scala.collection.immutable.TreeMap`](https://github.com/scala/scala/blob/v2.13.14/src/library/scala/collection/immutable/TreeMap.scala)の2種類がありますが、通常は`HashMap`が使われます。
 
 ```scala mdoc:nest
 val m = Map("A" -> 1, "B" -> 2, "C" -> 3)
@@ -807,8 +807,8 @@ Set(1, 1, 2, 3, 4)
 ### `scala.collection.immutable.Set`
 
 Scalaで何も設定せずにただ`Set`と書いた場合、`scala.collection.immutable.Set`が使われます。immutableな`Map`の場合と
-同じく、一度作成すると変更することはできません。内部の実装としては、主に [`scala.collection.immutable.HashSet`](https://github.com/scala/scala/blob/v2.13.13/src/library/scala/collection/immutable/HashSet.scala) と
-[`scala.collection.immutable.TreeSet`](https://github.com/scala/scala/blob/v2.13.13/src/library/scala/collection/immutable/TreeSet.scala) の2種類がありますが、通常は`HashSet`が使われます。
+同じく、一度作成すると変更することはできません。内部の実装としては、主に [`scala.collection.immutable.HashSet`](https://github.com/scala/scala/blob/v2.13.14/src/library/scala/collection/immutable/HashSet.scala) と
+[`scala.collection.immutable.TreeSet`](https://github.com/scala/scala/blob/v2.13.14/src/library/scala/collection/immutable/TreeSet.scala) の2種類がありますが、通常は`HashSet`が使われます。
 
 ```scala mdoc:nest
 val s = Set(1, 2, 3, 4, 5)
@@ -820,8 +820,8 @@ s // 元のSetはそのまま
 
 ### `scala.collection.mutable.Set`
 
-Scalaの変更可能な`Set`は`scala.collection.mutable.Set`にあります。主な実装としては、[`scala.collection.mutable.HashSet`](https://github.com/scala/scala/blob/v2.13.13/src/library/scala/collection/mutable/HashSet.scala) 、
-[`scala.collection.mutable.TreeSet`](https://github.com/scala/scala/blob/v2.13.13/src/library/scala/collection/mutable/TreeSet.scala)がありますが、通常は`HashSet`が使われます。
+Scalaの変更可能な`Set`は`scala.collection.mutable.Set`にあります。主な実装としては、[`scala.collection.mutable.HashSet`](https://github.com/scala/scala/blob/v2.13.14/src/library/scala/collection/mutable/HashSet.scala) 、
+[`scala.collection.mutable.TreeSet`](https://github.com/scala/scala/blob/v2.13.14/src/library/scala/collection/mutable/TreeSet.scala)がありますが、通常は`HashSet`が使われます。
 
 ```scala mdoc:nest
 import scala.collection.mutable

src/collection.md

@@ -156,7 +156,7 @@ Javaのエラー処理では例外が中心的な役割を担っていました
 
 ここでは正常の値とエラー値のどちらかを表現できるデータ構造の紹介を通じて、Scalaの関数型のエラー処理の方法を見ていきます。
 
-### [Option](https://github.com/scala/scala/blob/v2.13.13/src/library/scala/Option.scala)
+### [Option](https://github.com/scala/scala/blob/v2.13.14/src/library/scala/Option.scala)
 
 OptionはScalaでもっとも多用されるデータ型の1つです。
 前述のとおりJavaのnullの代替として使われることが多いデータ型です。
@@ -485,7 +485,7 @@ for { i1 <- v1
 
 <!-- end answer -->
 
-### [Either](https://github.com/scala/scala/blob/v2.13.13/src/library/scala/util/Either.scala)
+### [Either](https://github.com/scala/scala/blob/v2.13.14/src/library/scala/util/Either.scala)
 
 Optionによりnullを使う必要はなくなりましたが、いっぽうでOptionでは処理が成功したかどうかしかわからないという問題があります。
 Noneの場合、値が取得できなかったことはわかりますが、エラーの状態は取得できないので、使用できるのはエラーの種類が問題にならないような場合のみです。
@@ -634,7 +634,7 @@ f(g())
 似たような挙動は高階関数を使えば書けるのですが、名前渡しパラメータのほうが簡潔な記述ができるという点でより優れています。
 
 
-### [Try](https://github.com/scala/scala/blob/v2.13.13/src/library/scala/util/Try.scala)
+### [Try](https://github.com/scala/scala/blob/v2.13.14/src/library/scala/util/Try.scala)
 
 ScalaのTryはEitherと同じように正常な値とエラー値のどちらかを表現するデータ型です。
 Eitherとの違いは、2つの型が平等ではなく、エラー値がThrowableに限定されており、型引数を1つしか取らないことです。
@@ -668,7 +668,7 @@ for {
 } yield i1 * i2 * i3
 ```
 
-#### [`NonFatal`](https://github.com/scala/scala/blob/v2.13.13/src/library/scala/util/control/NonFatal.scala)の例外
+#### [`NonFatal`](https://github.com/scala/scala/blob/v2.13.14/src/library/scala/util/control/NonFatal.scala)の例外
 
 `Try.apply`がcatchするのはすべての例外ではありません。
 NonFatalという種類の例外だけです。