feat: add gleam support to sqlite

Author: ryan-gang

.gitignore

@@ -1 +1,2 @@
 course_definition_tester
+.history/

compiled_starters/gleam/.gitattributes

@@ -0,0 +1 @@
+* text=auto

compiled_starters/gleam/.gitignore

@@ -0,0 +1,4 @@
+*.beam
+*.ez
+/build
+erl_crash.dump

compiled_starters/gleam/README.md

@@ -0,0 +1,77 @@
+![progress-banner](https://codecrafters.io/landing/images/default_progress_banners/sqlite.png)
+
+This is a starting point for Gleam solutions to the
+["Build Your Own SQLite" Challenge](https://codecrafters.io/challenges/sqlite).
+
+In this challenge, you'll build a barebones SQLite implementation that supports
+basic SQL queries like `SELECT`. Along the way we'll learn about
+[SQLite's file format](https://www.sqlite.org/fileformat.html), how indexed data
+is
+[stored in B-trees](https://jvns.ca/blog/2014/10/02/how-does-sqlite-work-part-2-btrees/)
+and more.
+
+**Note**: If you're viewing this repo on GitHub, head over to
+[codecrafters.io](https://codecrafters.io) to try the challenge.
+
+# Passing the first stage
+
+The entry point for your SQLite implementation is in `src/sqlite.gleam`. Study
+and uncomment the relevant code, and push your changes to pass the first stage:
+
+```sh
+git add .
+git commit -m "pass 1st stage" # any msg
+git push origin master
+```
+
+Time to move on to the next stage!
+
+# Stage 2 & beyond
+
+Note: This section is for stages 2 and beyond.
+
+1. Ensure you have `gleam (1.0)` installed locally
+1. Run `./your_sqlite3.sh` to run your program, which is implemented in
+   `src/sqlite.gleam`.
+1. Commit your changes and run `git push origin master` to submit your solution
+   to CodeCrafters. Test output will be streamed to your terminal.
+
+# Sample Databases
+
+To make it easy to test queries locally, we've added a sample database in the
+root of this repository: `sample.db`.
+
+This contains two tables: `apples` & `oranges`. You can use this to test your
+implementation for the first 6 stages.
+
+You can explore this database by running queries against it like this:
+
+```sh
+$ sqlite3 sample.db "select id, name from apples"
+1|Granny Smith
+2|Fuji
+3|Honeycrisp
+4|Golden Delicious
+```
+
+There are two other databases that you can use:
+
+1. `superheroes.db`:
+   - This is a small version of the test database used in the table-scan stage.
+   - It contains one table: `superheroes`.
+   - It is ~1MB in size.
+1. `companies.db`:
+   - This is a small version of the test database used in the index-scan stage.
+   - It contains one table: `companies`, and one index: `idx_companies_country`
+   - It is ~7MB in size.
+
+These aren't included in the repository because they're large in size. You can
+download them by running this script:
+
+```sh
+./download_sample_databases.sh
+```
+
+If the script doesn't work for some reason, you can download the databases
+directly from
+[codecrafters-io/sample-sqlite-databases](https://github.com/codecrafters-io/sample-sqlite-databases).

compiled_starters/gleam/codecrafters.yml

@@ -0,0 +1,11 @@
+# Set this to true if you want debug logs.
+#
+# These can be VERY verbose, so we suggest turning them off
+# unless you really need them.
+debug: false
+
+# Use this to change the Gleam version used to run your code
+# on Codecrafters.
+#
+# Available versions: gleam-1.0
+language_pack: gleam-1.0

compiled_starters/gleam/gleam.toml

@@ -0,0 +1,22 @@
+name = "sqlite"
+version = "1.0.0"
+
+# Fill out these fields if you intend to generate HTML documentation or publish
+# your project to the Hex package manager.
+#
+# description = ""
+# licences = ["Apache-2.0"]
+# repository = { type = "github", user = "username", repo = "project" }
+# links = [{ title = "Website", href = "https://gleam.run" }]
+#
+# For a full reference of all the available options, you can have a look at
+# https://gleam.run/writing-gleam/gleam-toml/. 
+
+[dependencies]
+gleam_stdlib = "~> 0.34 or ~> 1.0"
+gleam_erlang = "~> 0.25"
+gleam_otp = "~> 0.10"
+glisten = "~> 2.0"
+
+[dev-dependencies]
+gleeunit = "~> 1.0"

compiled_starters/gleam/manifest.toml

@@ -0,0 +1,17 @@
+# This file was generated by Gleam
+# You typically do not need to edit this file
+
+packages = [
+  { name = "gleam_erlang", version = "0.25.0", build_tools = ["gleam"], requirements = ["gleam_stdlib"], otp_app = "gleam_erlang", source = "hex", outer_checksum = "054D571A7092D2A9727B3E5D183B7507DAB0DA41556EC9133606F09C15497373" },
+  { name = "gleam_otp", version = "0.10.0", build_tools = ["gleam"], requirements = ["gleam_erlang", "gleam_stdlib"], otp_app = "gleam_otp", source = "hex", outer_checksum = "0B04FE915ACECE539B317F9652CAADBBC0F000184D586AAAF2D94C100945D72B" },
+  { name = "gleam_stdlib", version = "0.36.0", build_tools = ["gleam"], requirements = [], otp_app = "gleam_stdlib", source = "hex", outer_checksum = "C0D14D807FEC6F8A08A7C9EF8DFDE6AE5C10E40E21325B2B29365965D82EB3D4" },
+  { name = "gleeunit", version = "1.1.2", build_tools = ["gleam"], requirements = ["gleam_stdlib"], otp_app = "gleeunit", source = "hex", outer_checksum = "72CDC3D3F719478F26C4E2C5FED3E657AC81EC14A47D2D2DEBB8693CA3220C3B" },
+  { name = "glisten", version = "2.0.0", build_tools = ["gleam"], requirements = ["gleam_erlang", "gleam_otp", "gleam_stdlib"], otp_app = "glisten", source = "hex", outer_checksum = "CF3A9383E9BA4A8CBAF2F7B799716290D02F2AC34E7A77556B49376B662B9314" },
+]
+
+[requirements]
+gleam_erlang = { version = "~> 0.25" }
+gleam_otp = { version = "~> 0.10" }
+gleam_stdlib = { version = "~> 0.34 or ~> 1.0" }
+gleeunit = { version = "~> 1.0" }
+glisten = { version = "~> 2.0"}

compiled_starters/gleam/src/sqlite.gleam

@@ -0,0 +1,39 @@
+import gleam/io
+import gleam/string
+import gleam/int
+import gleam/list
+import gleam/result
+
+// 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!")
+
+// Uncomment this block to pass the first stage
+// pub fn main() {
+//   let args = io.argv()
+//   
+//   case args {
+//     [_, database_file_path, command] -> {
+//       case command {
+//         ".dbinfo" -> {
+//           io.open(database_file_path, io.Read)
+//           |> result.then(fn(file) { 
+//             io.seek(file, 16)
+//             |> result.then(fn(_) {
+//               io.read_bytes(file, 2) 
+//               |> result.then(fn(bytes) {
+//                 let page_size = bytes 
+//                   |> list.reverse
+//                   |> int.from_bytes_be
+//                 io.println(string.concat(["database page size: ", int.to_string(page_size)]))
+//                 |> result.map(fn(_) { io.close(file) })
+//               })
+//             })
+//           })
+//           |> result.unwrap(crash)
+//         }
+//         _ -> io.println(string.concat(["Invalid command: ", command]))
+//       }
+//     }
+//     _ -> io.println("Usage: gleam run database_file_path command")
+//   }
+// } 

compiled_starters/gleam/your_sqlite3.sh

@@ -0,0 +1,8 @@
+#!/bin/sh
+#
+# DON'T EDIT THIS!
+#
+# CodeCrafters uses this file to test your code. Don't make any changes here!
+#
+# DON'T EDIT THIS!
+exec gleam run -- "$@"

course-definition.yml

@@ -44,6 +44,8 @@ languages:
   - slug: "zig"
   - slug: "java"
     release_status: "beta"
+  - slug: "gleam"
+    release_status: "beta"
 
 marketing:
   difficulty: hard