feat: update gleam starter

add comments.

Author: ryan-gang

compiled_starters/gleam/src/sqlite.gleam

@@ -1,26 +1,28 @@
 import argv
 import file_streams/read_stream
-import gleam/bit_array
 import gleam/int.{to_string}
 import gleam/io
-import gleam/list.{each}
 
 pub fn main() {
   // You can use print statements as follows for debugging, they'll be visible when running tests.
   io.println("Logs from your program will appear here!")
+
   let args = argv.load().arguments
+
   // Uncomment this to pass the first stage
   // case args {
   //   [database_file_path, ".dbinfo", ..] -> {
   //     let assert Ok(rs) = read_stream.open(database_file_path)
-  //     let assert Ok(bytes) = read_stream.read_bytes_exact(rs, 16)
-  //     let assert Ok(int_value) = read_stream.read_int16_be(rs)
+  //     // Get a file handle to the database file, and skip the first 16 bytes
+  //     let assert Ok(_bytes) = read_stream.read_bytes_exact(rs, 16)
+  //     // The next 2 bytes hold the page size in big-endian format
+  //     let assert Ok(page_size) = read_stream.read_int16_be(rs)
   //
   //     io.print("database page size: ")
-  //     io.println(to_string(int_value))
+  //     io.println(to_string(page_size))
   //   }
   //   _ -> {
-  //     io.println("No match")
+  //     io.println("Unknown command")
   //   }
   // }
 }

solutions/gleam/01-init/code/src/sqlite.gleam

@@ -1,23 +1,24 @@
 import argv
 import file_streams/read_stream
-import gleam/bit_array
 import gleam/int.{to_string}
 import gleam/io
-import gleam/list.{each}
 
 pub fn main() {
   let args = argv.load().arguments
+
   case args {
     [database_file_path, ".dbinfo", ..] -> {
       let assert Ok(rs) = read_stream.open(database_file_path)
-      let assert Ok(bytes) = read_stream.read_bytes_exact(rs, 16)
-      let assert Ok(int_value) = read_stream.read_int16_be(rs)
+      // Get a file handle to the database file, and skip the first 16 bytes
+      let assert Ok(_bytes) = read_stream.read_bytes_exact(rs, 16)
+      // The next 2 bytes hold the page size in big-endian format
+      let assert Ok(page_size) = read_stream.read_int16_be(rs)
 
       io.print("database page size: ")
-      io.println(to_string(int_value))
+      io.println(to_string(page_size))
     }
     _ -> {
-      io.println("No match")
+      io.println("Unknown command")
     }
   }
 }

solutions/gleam/01-init/diff/src/sqlite.gleam.diff

@@ -1,40 +1,44 @@
-@@ -1,26 +1,23 @@
+@@ -1,28 +1,24 @@
  import argv
  import file_streams/read_stream
- import gleam/bit_array
  import gleam/int.{to_string}
  import gleam/io
- import gleam/list.{each}
 
  pub fn main() {
 -  // You can use print statements as follows for debugging, they'll be visible when running tests.
 -  io.println("Logs from your program will appear here!")
+-
    let args = argv.load().arguments
+
 -  // Uncomment this to pass the first stage
 -  // case args {
 -  //   [database_file_path, ".dbinfo", ..] -> {
 -  //     let assert Ok(rs) = read_stream.open(database_file_path)
--  //     let assert Ok(bytes) = read_stream.read_bytes_exact(rs, 16)
--  //     let assert Ok(int_value) = read_stream.read_int16_be(rs)
+-  //     // Get a file handle to the database file, and skip the first 16 bytes
+-  //     let assert Ok(_bytes) = read_stream.read_bytes_exact(rs, 16)
+-  //     // The next 2 bytes hold the page size in big-endian format
+-  //     let assert Ok(page_size) = read_stream.read_int16_be(rs)
 -  //
 -  //     io.print("database page size: ")
--  //     io.println(to_string(int_value))
+-  //     io.println(to_string(page_size))
 -  //   }
 -  //   _ -> {
--  //     io.println("No match")
+-  //     io.println("Unknown command")
 -  //   }
 -  // }
 +  case args {
 +    [database_file_path, ".dbinfo", ..] -> {
 +      let assert Ok(rs) = read_stream.open(database_file_path)
-+      let assert Ok(bytes) = read_stream.read_bytes_exact(rs, 16)
-+      let assert Ok(int_value) = read_stream.read_int16_be(rs)
++      // Get a file handle to the database file, and skip the first 16 bytes
++      let assert Ok(_bytes) = read_stream.read_bytes_exact(rs, 16)
++      // The next 2 bytes hold the page size in big-endian format
++      let assert Ok(page_size) = read_stream.read_int16_be(rs)
 +
 +      io.print("database page size: ")
-+      io.println(to_string(int_value))
++      io.println(to_string(page_size))
 +    }
 +    _ -> {
-+      io.println("No match")
++      io.println("Unknown command")
 +    }
 +  }
  }

solutions/gleam/01-init/explanation.md

@@ -7,14 +7,16 @@ Study and uncomment the relevant code:
 case args {
   [database_file_path, ".dbinfo", ..] -> {
     let assert Ok(rs) = read_stream.open(database_file_path)
-    let assert Ok(bytes) = read_stream.read_bytes_exact(rs, 16)
-    let assert Ok(int_value) = read_stream.read_int16_be(rs)
+    // Get a file handle to the database file, and skip the first 16 bytes
+    let assert Ok(_bytes) = read_stream.read_bytes_exact(rs, 16)
+    // The next 2 bytes hold the page size in big-endian format
+    let assert Ok(page_size) = read_stream.read_int16_be(rs)
 
     io.print("database page size: ")
-    io.println(to_string(int_value))
+    io.println(to_string(page_size))
   }
   _ -> {
-    io.println("No match")
+    io.println("Unknown command")
   }
 }
 ```

starter_templates/gleam/src/sqlite.gleam

@@ -1,26 +1,28 @@
 import argv
 import file_streams/read_stream
-import gleam/bit_array
 import gleam/int.{to_string}
 import gleam/io
-import gleam/list.{each}
 
 pub fn main() {
   // You can use print statements as follows for debugging, they'll be visible when running tests.
   io.println("Logs from your program will appear here!")
+
   let args = argv.load().arguments
+
   // Uncomment this to pass the first stage
   // case args {
   //   [database_file_path, ".dbinfo", ..] -> {
   //     let assert Ok(rs) = read_stream.open(database_file_path)
-  //     let assert Ok(bytes) = read_stream.read_bytes_exact(rs, 16)
-  //     let assert Ok(int_value) = read_stream.read_int16_be(rs)
+  //     // Get a file handle to the database file, and skip the first 16 bytes
+  //     let assert Ok(_bytes) = read_stream.read_bytes_exact(rs, 16)
+  //     // The next 2 bytes hold the page size in big-endian format
+  //     let assert Ok(page_size) = read_stream.read_int16_be(rs)
   //
   //     io.print("database page size: ")
-  //     io.println(to_string(int_value))
+  //     io.println(to_string(page_size))
   //   }
   //   _ -> {
-  //     io.println("No match")
+  //     io.println("Unknown command")
   //   }
   // }
 }