improve scala-cli explanations, fix #771

compendium/modules/w09-setmap-lab.tex

@@ -35,9 +35,8 @@ \subsection{Bakgrund}
 
 \subsection{Obligatoriska uppgifter}
 
-Du ska bygga ditt program med en editor, t.ex. VS \texttt{code}, och kompilera din kod i terminalen med \code{scalac} eller med hjälp av \code{scala-cli}. Medan du steg för steg utvecklar ditt program, ska du parallellt göra experiment i REPL för att undersöka hur du kan använda samlingsmetoder för att lösa uppgifterna.
-
-Kod att utgå ifrån finns på github här: \url{https://github.com/lunduniversity/introprog/tree/master/workspace/w09_words}
+Du ska bygga ditt program med en editor, t.ex. VS \texttt{code}, och kompilera och köra din kod i terminalen med hjälp av \code{scala-cli} i \textit{watch mode} med det arbetssätt som beskrivs i appendix \ref{appendix:build} avsnitt \ref{appendix:build-scala-cli-watch-mode}. Medan du steg för steg utvecklar ditt program, ska du parallellt göra experiment i REPL för att undersöka hur du kan använda samlingsmetoder för att lösa uppgifterna.
+Kod att utgå ifrån finns här: \url{https://github.com/lunduniversity/introprog/tree/master/workspace/w09_words}
 
 Dessa ofärdiga kodfiler ligger i paketet \code{nlp}:
 \begin{itemize}
@@ -48,20 +47,6 @@ \subsection{Obligatoriska uppgifter}
   \item \href{https://github.com/lunduniversity/introprog/blob/master/workspace/w09_words/Main.scala}{\texttt{Main.scala}} innehåller ett ofärdigt huvudprogram som du kan använda i laborationens senare del.
 \end{itemize}
 
-För att underlätta ditt arbetsflöde under det att du stegvis bygger upp din kod metod för metod, kan du med fördel använda verktyget \texttt{scala-cli} (se appendix \ref{appendix:build}) så här:
-
-\begin{itemize}
-  \item
-    Med kommandot \code{scala-cli repl .}~ startar du REPL med dina klasser i aktuella katalogen (därav punkten efter blanksteg efter \code{scala repl}) automatiskt tillgängliga på classpath och du kan anropa dina metoder när du experimenterar inför nästa steg. 
-  \item
-    Du kan också ge annan sökväg som argument till kommandot, exempelvis \code{scala-cli repl minKatalog} och när du ändrat något i din editor och vill experimentera med nya versionen så stänger du ned REPL (exempelvis med Ctrl+D eller Ctrl+C eller \code{:q}) och startar om genom att återupprepa kommandot \code{scala-cli repl .}
-  \item
-    Med \texttt{scala-cli run .} sker kompilering och körning av \code{main}-metoden i aktuella katalogen. Du kan ange en annan katalog genom att skicka med sökvägen som argument till kommandot. 
-  \item
-    Om det finns flera \texttt{main}-metoder i aktuella katalogen, går det att specificera vilken av dessa som ska exekveras med optionen \verb|--main-class|, exempelvis\\ \verb|scala-cli run .  --main-class Hello| \\ Argument anges efter dubbla minustecken \verb|--| så här: \\\verb|scala-cli run . -- arg1 arg2 arg3|
-\end{itemize}
-
-
 \Task \emph{Skapa frekvenstabeller}. Du ska använda \code{FreqMapBuilder} från veckans övning för att skapa frekvenstabeller av typen \code{Map[String, Int]}, där nyckel-värde-paren i tabellen anger antalet förekomster av en viss sträng.
 
 \Subtask Lägg klassen \code{FreqMapBuilder} i ett paket som heter \code{nlp} och kompilera.
@@ -90,7 +75,8 @@ \subsection{Obligatoriska uppgifter}
 res1: Int = 32770
 
 scala> fmb.toMap
-res2: Map[String,Int] = Map(10292 -> 1, 19125 -> 1, 26985 -> 1, 29301 -> 1, 5451 -> 1, 4018 -> 1, 31211 -> 1, 17319 -> 1, 20778 -> 1, 25285 -> 1, 17079 -> 1, 9936 -> 1, 13172 -
+res2: Map[String,Int] = 
+  Map(10292 -> 1, 19125 -> 1, 26985 -> 1, 29301 -> 1, 5451 -> 1, 4018 -> 1, 31211 -> 1, ...
 \end{REPL}
 
 \noindent I kommande uppgifter ska du steg för steg skapa och testa case-klassen \code{Text}. %figur \ref{data:fig-text}.

compendium/postchapters/build.tex

@@ -54,21 +54,40 @@ \section{Vad gör ett byggverktyg?}
 
 \section{Scala Command Line Interface \texttt{scala-cli}}\label{appendix:build:scala-cli}
 
-Utvecklingen av \href{https://scala-cli.virtuslab.org/}{Scala CLI} påbörjades 2022 av \href{https://virtuslab.com/}{Virtuslab}. Scala CLI blir under 2023 det officiella byggverktyget för enkla Scala-projekt och kommer medfölja \href{https://www.scala-lang.org/download/}{installationen av Scala}. Scala CLI kan även installeras separat och köras med kommandot \code{scala-cli}, men blir någon gång under 2023 liktydigt med kommandot \code{scala} i terminalen.\footnote{I skrivande stund har gamla \code{scala}-kommandot ännu inte uppgraderats, men det förväntas ske i början av hösten. När så väl sker kan alla förekomster av \code{scala-cli} i detta stycke ersättas med det kortare kommandot \code{scala}, efter uppdatering.}
+Utvecklingen av Scala CLI\footnote{CLI är en förkortning för \textit{command line interface}. Läs mer om Scala CLI här: \url{https://scala-cli.virtuslab.org/docs/overview}} påbörjades 2022 och planeras under 2024 bli det officiella bygg- och körverktyget. Det kommer då medfölja den officiella installationen av Scala via \url{https://www.scala-lang.org}. Scala CLI kan även installeras separat från \url{https://scala-cli.virtuslab.org} och köras med kommandot \code{scala-cli}, men någon gång under 2024 när Scala 3.5 släpps så blir kommandot \code{scala} liktydigt med \code{scala-cli}.\footnote{I skrivande stund har gamla \code{scala}-kommandot ännu inte uppgraderats, men det förväntas ske i början av hösten. När så väl sker kan \code{scala-cli} ersättas med \code{scala} om du uppdaterar till Scala 3.5.0 eller senare.}
 
 Efter nyinstallation av Scala CLI kan du ange följande kommando för att, en gång för alla, få tillgång till kompletteringar av optioner med Tab-tangenten i terminalen:
 \begin{REPLsmall}
 scala-cli install-completions 
 \end{REPLsmall}
 
-Innan du börjar skriva källkod i en ny katalog i VS Code kan du konfigurera VS Code att vara redo för att använda Scala CLI som byggverktyg i aktuell katalog med följande kommando (vänta med att öppna VS Code till efter att du kört kommandot): 
+Innan du börjar skriva källkod i en ny katalog i VS Code kan du göra VS Code redo för att använda Scala CLI som byggverktyg i aktuell katalog med följande kommando (vänta med att öppna VS Code till efter att du kört kommandot): 
 \begin{REPLsmall}
 mkdir minNyaKatalog
 cd minNyaKatalog
 scala-cli setup-ide . 
 code .
 \end{REPLsmall}
-
+I senare versionerna av VS Code med Metals och Scala 3.4 behövs ej \code{setup-ide} då Metals kör scala-cli som default.
+
+\subsection{Exempel på användning av Scala CLI}\label{appendix:build-scala-cli-watch-mode}
+
+Nedan beskrivs de viktigaste Scala-CLI-kommandona för att stegvis bygga upp din kod med många små steg och experimenterande med dellösningar. 
+
+\begin{itemize}
+  \item Med kommandot \code{scala-cli compile . -w} i ett eget terminalfönster bredvid din editor startar du Scala CLI i så kallad \textit{watch mode}. Då bevakas alla filändringar och omkompilering sker direkt när någon ny ändring sparats och du kan se eventuella kompileringsfel direkt. Åtgärda helst ett kompileringsfel innan du bygger vidare på din kod, då följdfel kan vara svåra att lösa speciellt om de är många. Dela upp stora kodändringar i små steg och försök att så fort som möjligt få den senaste ändringen att kompilera felfritt. 
+  \item
+    Med kommandot \code{scala-cli repl .}~ i ett annat terminalfönster startar du REPL med dina klasser i aktuella katalogen  automatiskt tillgängliga på classpath (därav punkten efter blanksteg efter \code{scala repl}) och du kan anropa dina metoder, efter ev. \code{import} när du gör experiment inför nästa steg. 
+
+    På så sätt kan du skapa och testa små funktioner och få dem att att fungera innan inför dem i ditt program och sätter samman dessa med redan skapade funktioner. Det är ofta lättare att felsöka och bygga upp ett större program om du har många små funktioner som samverkar, snarare än få väldigt stora funktioner. Och det är oftast lättare att testköra nya lösningsidéer i REPL innan du skapar ''färdig'' kod i ditt program.
+  \item
+    Med \texttt{scala-cli run .} sker kompilering och körning av \code{main}-metoden i aktuella katalogen. Du kan ange en annan katalog genom att skicka med sökvägen som argument till kommandot.  Du kan också ange optionen \code{-w} för \textit{watch mode} vid körning. Då kommer ditt program att köras om vid varje ändring. Watch mode vid körning är användbart om programmet ger resultat utan att vänta på input, men inte så smidigt om varje körning kräver att användaren skriver indata eller om fönster måste stängas.
+  \item
+    Om det finns flera \texttt{main}-metoder i aktuella katalogen, går det att specificera vilken av dessa som ska exekveras med optionen \verb|--main-class|, exempelvis\\ \verb|scala-cli run .  --main-class hello| 
+  \item Argument till ditt huvudprogam anges efter dubbla minustecken \verb|--| så här: \\\verb|scala-cli run . -- arg1 arg2 arg3|
+\end{itemize}
+
+
 
 \subsection{Grundläggande byggfunktioner i Scala CLI}