vlib: add toml module + tests

.github/workflows/toml_ci.yml

@@ -0,0 +1,27 @@
+name: toml CI
+
+on:
+  push:
+    paths-ignore:
+      - "**.md"
+  pull_request:
+    paths-ignore:
+      - "**.md"
+
+jobs:
+  toml-module-pass-external-test-suites:
+    runs-on: ubuntu-20.04
+    timeout-minutes: 121
+    steps:
+
+    - uses: actions/checkout@v2
+    - name: Build V
+      run: make -j2 && ./v -cc gcc -o v cmd/v
+
+    - name: Clone BurntSushi/toml-test
+      run: |
+        cd vlib/toml/tests/testdata
+        git clone --depth 1 https://github.com/BurntSushi/toml-test.git burntsushi/toml-test
+
+    - name: Run tests
+      run: ./v -stats test vlib/toml

examples/toml.v

@@ -0,0 +1,48 @@
+import toml
+
+// Complete text from the example in the README.md:
+// https://github.com/toml-lang/toml/blob/3b11f6921da7b6f5db37af039aa021fee450c091/README.md#Example
+const toml_text = '# This is a TOML document.
+
+title = "TOML Example"
+
+[owner]
+name = "Tom Preston-Werner"
+dob = 1979-05-27T07:32:00-08:00 # First class dates
+
+[database]
+server = "192.168.1.1"
+ports = [ 8000, 8001, 8002 ]
+connection_max = 5000
+enabled = true
+
+[servers]
+
+  # Indentation (tabs and/or spaces) is allowed but not required
+  [servers.alpha]
+  ip = "10.0.0.1"
+  dc = "eqdc10"
+
+  [servers.beta]
+  ip = "10.0.0.2"
+  dc = "eqdc10"
+
+[clients]
+data = [ ["gamma", "delta"], [1, 2] ]
+
+# Line breaks are OK when inside arrays
+hosts = [
+  "alpha",
+  "omega"
+]'
+
+fn main() {
+	doc := toml.parse(toml_text) or { panic(err) }
+	title := doc.value('title').string()
+	println('title: "$title"')
+	ip := doc.value('servers.alpha.ip').string()
+	println('Server IP: "$ip"')
+
+	toml_json := doc.to_json()
+	println(toml_json)
+}

vlib/time/parse.c.v

@@ -43,6 +43,61 @@ pub fn parse_rfc2822(s string) ?Time {
 	}
 }
 
+// ----- rfc3339 -----
+const (
+	err_invalid_3339 = 'Invalid 3339 format'
+)
+
+// parse_rfc3339 returns time from a date string in RFC 3339 datetime format.
+pub fn parse_rfc3339(s string) ?Time {
+	if s == '' {
+		return error(time.err_invalid_3339 + ' cannot parse empty string')
+	}
+	mut t := parse_iso8601(s) or { Time{} }
+	// If parse_iso8601 DID NOT result in default values (i.e. date was parsed correctly)
+	if t != Time{} {
+		return t
+	}
+
+	t_i := s.index('T') or { -1 }
+	parts := if t_i != -1 { [s[..t_i], s[t_i + 1..]] } else { s.split(' ') }
+
+	// Check if s is date only
+	if !parts[0].contains_any(' Z') && parts[0].contains('-') {
+		year, month, day := parse_iso8601_date(s) ?
+		t = new_time(Time{
+			year: year
+			month: month
+			day: day
+		})
+		return t
+	}
+	// Check if s is time only
+	if !parts[0].contains('-') && parts[0].contains(':') {
+		mut hour_, mut minute_, mut second_, mut microsecond_, mut unix_offset, mut is_local_time := 0, 0, 0, 0, i64(0), true
+		hour_, minute_, second_, microsecond_, unix_offset, is_local_time = parse_iso8601_time(parts[0]) ?
+		t = new_time(Time{
+			hour: hour_
+			minute: minute_
+			second: second_
+			microsecond: microsecond_
+		})
+		if is_local_time {
+			return t // Time is already local time
+		}
+		mut unix_time := t.unix
+		if unix_offset < 0 {
+			unix_time -= (-unix_offset)
+		} else if unix_offset > 0 {
+			unix_time += unix_offset
+		}
+		t = unix2(i64(unix_time), t.microsecond)
+		return t
+	}
+
+	return error(time.err_invalid_3339 + '. Could not parse "$s"')
+}
+
 // ----- iso8601 -----
 const (
 	err_invalid_8601 = 'Invalid 8601 Format'

vlib/toml/README.md

@@ -0,0 +1,55 @@
+# TOML module
+`toml` is a fully fledged TOML v1.0.0 compatible parser written in pure V.
+
+## Usage
+
+```v
+import toml
+
+// Complete text from the example in the README.md:
+// https://github.com/toml-lang/toml/blob/3b11f6921da7b6f5db37af039aa021fee450c091/README.md#Example
+const toml_text = '# This is a TOML document.
+
+title = "TOML Example"
+
+[owner]
+name = "Tom Preston-Werner"
+dob = 1979-05-27T07:32:00-08:00 # First class dates
+
+[database]
+server = "192.168.1.1"
+ports = [ 8000, 8001, 8002 ]
+connection_max = 5000
+enabled = true
+
+[servers]
+
+  # Indentation (tabs and/or spaces) is allowed but not required
+  [servers.alpha]
+  ip = "10.0.0.1"
+  dc = "eqdc10"
+
+  [servers.beta]
+  ip = "10.0.0.2"
+  dc = "eqdc10"
+
+[clients]
+data = [ ["gamma", "delta"], [1, 2] ]
+
+# Line breaks are OK when inside arrays
+hosts = [
+  "alpha",
+  "omega"
+]'
+
+fn main() {
+	doc := toml.parse(toml_text) or { panic(err) }
+	title := doc.value('title').string()
+	println('title: "$title"')
+	ip := doc.value('servers.alpha.ip').string()
+	println('Server IP: "$ip"')
+
+	toml_json := doc.to_json()
+	println(toml_json)
+}
+```