dms-parser 0.5.0 → 0.5.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8c14f1d20d52d7187a1d070cd97a73489c7ecf26d33f36e1b7caec2800e5ebf7
-  data.tar.gz: c23cd13f0f751281b72245f2ae5c4193b705c44ffc7154208146d2af06535bfd
+  metadata.gz: 9ff6c29cfa7778eda9199a9b532ea2af36616977b1f4d839c39b7a6816e61b9c
+  data.tar.gz: '0049b496c4f68647eaf9078bdba8e165b67d049e51c194f9119142bc5e3e9769'
 SHA512:
-  metadata.gz: e54215e05be86f064095579e879b0a45518b2b221dfea42d0c2314bce3f45863ba2be8098f460ebd82acd5e1387339b280ddb7718271f3f3fd0e61c42fec2999
-  data.tar.gz: aa9925ba49da2e63580c171a6d08f91db92ad5b4a6a5623fcca75ac8a26ef21102935ebed7323069f16cc3d03f01493f98a4cc5636fb7625ed492d402c7523a5
+  metadata.gz: 5be4558f18b436cd0d5c943bc829b98547a724e5c10a214238f4fcadf24c4b24c3e3812b6b0f2b12912f08981e29c394d79d8208fa009151374271c473fa95f6
+  data.tar.gz: 491cab0c32eaa8d224ded077cafddd7f4d7fbefd4a50ce6a9e6000594058c40da8020798706e24ceb70ec0ad3fea982f7374dd45f471f4c88c9237ae1c8df15f

data/README.md

@@ -7,16 +7,88 @@ multi-line heredocs, and front-matter metadata.
 
 Two gems live in this repo, both with the same Ruby API and value shape:
 
-| gem    | implementation                       | when to use                          |
-| ------ | ------------------------------------ | ------------------------------------ |
-| `dms`  | pure Ruby                            | portable; no C toolchain required    |
-| `dms-c`| C extension wrapping the dms-c decoder | hot paths; ~2× faster than pure Ruby |
+| gem          | implementation                            | when to use                          |
+| ------------ | ----------------------------------------- | ------------------------------------ |
+| `dms-parser` | pure Ruby (`require "dms"`)               | portable; no C toolchain required    |
+| `dms-c`      | C extension wrapping the dms-c decoder    | hot paths; ~2× faster than pure Ruby |
+
+> **Gem naming.** The plain `dms` name on RubyGems is taken by an unrelated
+> project, so the pure-Ruby gem ships as `dms-parser`. The require path is
+> still `"dms"` (the install command and the `require` line don't match —
+> a one-time gotcha when adding the dependency).
+
+## What DMS looks like
+
+A medium-size tier-0 document, exercising every feature you'd touch in a
+real config — front matter, comments (line + trailing), nested tables,
+list-of-tables with the `+` marker, flow forms, distinct types, and a
+heredoc with a trim modifier:
+
+```dms
++++
+title:    "DMS feature tour"
+version:  "1.0.0"
+updated:  2026-04-24T09:30:00-04:00
++++
+
+# Hash and // line comments both work.
+// Bare keys allow full Unicode; quoted keys take any string.
+
+database:
+  host:    "db.internal"
+  port:    5432            # bumped after the LB change
+  pool:    { size: 10, idle_timeout_s: 30 }   # flow table
+
+servers:
+  + name: "web1"
+    disks:
+      + mount: "/"
+        size_gb: 100
+      + mount: "/var"
+        size_gb: 500
+  + name: "web2"
+
+regions: ["us-east-1", "eu-west-1", "ap-south-1"]
+
+sql: """SQL _trim("\n", ">")
+    SELECT id, email
+      FROM users
+     WHERE active = true
+    SQL
+```
+
+Tier 1 layers structured decorators on top of the value tree. Sigils bind
+to families published by a dialect; here is `dms+html` carrying an HTML
+fragment as a DMS document:
+
+```dms
++++
+_dms_tier: 1
+_dms_imports:
+  + dialect: "html"
+    version: "1.0.0"
++++
+
++ |html(lang: "en")
+  + |head
+    + |title "DMS feature tour"
+    + |meta(charset: "UTF-8")
+  + |body(class: "main")
+    + |h1 "Welcome to DMS"
+    + |p(class: "lede")
+      + "Click "
+      + |a(href: "/spec.html") "here"
+      + " to read the spec."
+```
+
+Full feature tour, format comparison, and dialect index on the
+**[DMS website](https://flo-labs.gitlab.io/pub/dms-webpage/)**.
 
 ## Install
 
 ```sh
-gem install dms          # pure Ruby
-gem install dms-c        # native (C) extension, same API
+gem install dms-parser   # pure Ruby
+gem install dms-c        # native (C) extension, same API (not yet published)
 ```
 
 ## Usage

data/bin/dms-encoder

@@ -5,10 +5,22 @@
 # Reads DMS source from stdin, writes tagged JSON to stdout.
 
 $LOAD_PATH.unshift(File.expand_path("../lib", __dir__))
+$LOAD_PATH.unshift(File.expand_path("../dms-c/lib", __dir__))
 
 require "json"
 require "dms"
 
+# Feature-detect the native dms-c gem for tier-1 acceleration.
+# Falls back silently to pure-Ruby Dms::Tier1 if unavailable or
+# if the build hasn't been compiled yet.
+DMS_C_AVAILABLE =
+  begin
+    require "dms_c"
+    DmsC.respond_to?(:decode_t1_to_json)
+  rescue LoadError
+    false
+  end
+
 # Force UTF-8 output: tagged JSON uses ensure_ascii=False equivalent
 # (we write raw UTF-8) so stdout must accept it. Disable CRLF translation.
 $stdout.set_encoding("UTF-8")
@@ -188,9 +200,16 @@ end
 begin
   # Tier-1 decode path: parse with decorator awareness, emit wrapper JSON.
   if tier_flag == 1
-    doc_t1 = Dms::Tier1.parse(src)
-    out = Dms::Tier1.emit_t1_json(doc_t1, method(:tag))
-    $stdout.write(JSON.pretty_generate(out, indent: "  ") + "\n")
+    if DMS_C_AVAILABLE
+      # Native path: dms-c tier1.c returns ready-to-print JSON; pretty-print it.
+      raw_hash = DmsC.decode_t1(src)
+      $stdout.write(JSON.pretty_generate(raw_hash, indent: "  ") + "\n")
+    else
+      # Pure-Ruby fallback.
+      doc_t1 = Dms::Tier1.parse(src)
+      out = Dms::Tier1.emit_t1_json(doc_t1, method(:tag))
+      $stdout.write(JSON.pretty_generate(out, indent: "  ") + "\n")
+    end
     exit 0
   end
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: dms-parser
 version: !ruby/object:Gem::Version
-  version: 0.5.0
+  version: 0.5.1
 platform: ruby
 authors:
 - Filip Lopes
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-05-05 00:00:00.000000000 Z
+date: 2026-05-06 00:00:00.000000000 Z
 dependencies: []
 description: Ruby parser for DMS, a data syntax with strong typing, ordered maps,
   multi-line heredocs, and front-matter metadata.