small change

Author: forax

build/build.java

@@ -410,22 +410,23 @@ private static String shortName(String filename) {
     return filename.substring(index + 1);
   }
 
-  private interface Generator<T> {
-    void generate(List<String> lines, T attachment) throws IOException;
+  @FunctionalInterface
+  private interface Action<T> {
+    void execute(List<String> lines, T attachment) throws IOException;
 
-    default Generator<T> and(Generator<T> generator) {
+    default Action<T> and(Action<? super T> action) {
       return (lines, attachment) -> {
-        generate(lines, attachment);
-        generator.generate(lines, attachment);
+        execute(lines, attachment);
+        action.execute(lines, attachment);
       };
     }
 
-    static Generator<String> write(Generator<Path> writeMethod, Path folder, String extension) {
-      return (lines, rawFilename) -> writeMethod.generate(lines, folder.resolve(rawFilename + extension));
+    static Action<String> create(Action<Path> action, Path folder, String extension) {
+      return (lines, rawFilename) -> action.execute(lines, folder.resolve(rawFilename + extension));
     }
   }
 
-  private static void generate(List<Path> paths, Generator<String> generator) throws IOException {
+  private static void generate(List<Path> paths, Action<String> action) throws IOException {
     for(var path: paths) {
       var rawFilename = removeExtension(path.getFileName().toString());
 
@@ -435,7 +436,7 @@ private static void generate(List<Path> paths, Generator<String> generator) thro
         lines = stream.dropWhile(LineKind.is(LineKind.TEXT)).dropWhile(LineKind.is(LineKind.BLANK)).collect(Collectors.toList());
       }
 
-      generator.generate(lines, rawFilename);
+      action.execute(lines, rawFilename);
     }
   }
 
@@ -454,7 +455,7 @@ private static List<Path> gatherFiles(Path directory, Predicate<String> filter)
     }
   }
 
-  private static /*record*/ class Config {
+  private static record Config(Optional<Kind> index, Set<Kind> kinds, Map<Kind, Path> folderMap) {
     private enum Kind {
       MARKDOWN(".md", build::writeMarkDown),
       NOTEBOOK(".ipynb", build::writeJupyter),
@@ -469,12 +470,12 @@ static Optional<Kind> of(String name) {
 
       private final String propertyName;
       private final String extension;
-      private final Generator<Path> generator;
+      private final Action<Path> action;
 
-      private Kind(String extension, Generator<Path> generator) {
+      private Kind(String extension, Action<Path> action) {
         this.propertyName = name().toLowerCase();
         this.extension = extension;
-        this.generator = generator;
+        this.action = action;
       }
 
       Path folder(Properties properties) {
@@ -486,16 +487,6 @@ private static Optional<String> getProperty(Properties properties, String proper
       return Optional.ofNullable(properties.getProperty(propertyName));
     }
 
-    private final Optional<Kind> index;
-    private final Set<Kind> kinds; 
-    private final Map<Kind, Path> folderMap;
-    
-    private Config(Optional<Kind> index, Set<Kind> kinds, Map<Kind, Path> folderMap) {
-      this.index = index;
-      this.kinds = kinds;
-      this.folderMap = folderMap;
-    }
-    
     Path folder(Kind kind) {
       return folderMap.get(kind);
     }
@@ -523,8 +514,8 @@ public static void main(String[] args) throws IOException {
       createDirectories(config.folder(kind));
     }
 
-    // create generator
-    var generator = config.kinds.stream().map(k -> Generator.write(k.generator, config.folder(k), k.extension)).reduce(Generator::and).orElseThrow();
+    // create action
+    var generator = config.kinds.stream().map(k -> Action.create(k.action, config.folder(k), k.extension)).reduce(Action::and).orElseThrow();
 
     // gather files and generate    
     var files = gatherFiles(Path.of("."), name -> name.endsWith(".jsh"));

chapter25-stream.jsh

@@ -326,6 +326,7 @@ System.out.println(Arrays.stream(squareRoots).limit(10).boxed().collect(toList()
 // ## Limitations
 
 // ### Reusing stream objects
+// You can not reuse a stream for several queries
 var stream = Stream.of(1, 2, 3);
 System.out.println(stream.count());
 System.out.println(stream.count());

guide/chapter25-stream.md

@@ -394,6 +394,7 @@ You have to use specialized method (resp `findFirst()` and `forEachOrdered()`) t
 ## Limitations
 
 ### Reusing stream objects
+You can not reuse a stream for several queries
 ```java
 var stream = Stream.of(1, 2, 3);
 System.out.println(stream.count());

jupyter/chapter25-stream.ipynb

@@ -626,7 +626,7 @@
 {
   "cell_type": "markdown",
   "metadata": {},
-  "source": ["### Reusing stream objects\n"]
+  "source": ["### Reusing stream objects\n", "You can not reuse a stream for several queries\n"]
 }
 ,
 {