support multiple config sections in json format

rodionstolyarov · rodionstolyarov · commit 91f7dd910df1 · 2026-01-14T15:30:12.000+07:00
diff --git a/_examples/simple/doc.json b/_examples/simple/doc.json
@@ -1,23 +1,29 @@
 [
   {
-    "env_name": "HOST",
-    "doc": "Hosts name of hosts to listen on.",
-    "env_separator": ";",
-    "required": true
-  },
-  {
-    "env_name": "PORT",
-    "doc": "Port to listen on.",
-    "required": true,
-    "non_empty": true
-  },
-  {
-    "env_name": "DEBUG",
-    "doc": "Debug mode enabled.",
-    "env_default": "false"
-  },
-  {
-    "env_name": "PREFIX",
-    "doc": "Prefix for something."
+    "name": "Config",
+    "doc": "Config is an example configuration structure.\nIt is used to generate documentation for the configuration\nusing the commands below.",
+    "items": [
+      {
+        "env_name": "HOST",
+        "doc": "Hosts name of hosts to listen on.",
+        "env_separator": ";",
+        "required": true
+      },
+      {
+        "env_name": "PORT",
+        "doc": "Port to listen on.",
+        "required": true,
+        "non_empty": true
+      },
+      {
+        "env_name": "DEBUG",
+        "doc": "Debug mode enabled.",
+        "env_default": "false"
+      },
+      {
+        "env_name": "PREFIX",
+        "doc": "Prefix for something."
+      }
+    ]
   }
 ]
diff --git a/render/renderer.go b/render/renderer.go
@@ -35,9 +35,9 @@ func (r *Renderer) Render(scopes []*types.EnvScope, out io.Writer) error {
 }
 
 type renderSection struct {
-	Name  string
-	Doc   string
-	Items []renderItem
+	Name  string       `json:"name,omitempty"`
+	Doc   string       `json:"doc,omitempty"`
+	Items []renderItem `json:"items,omitempty"`
 }
 
 type renderItem struct {
diff --git a/render/templ/json.tmpl b/render/templ/json.tmpl
@@ -1,3 +1 @@
-{{- range .Sections }}
-{{- marshalIndent .Items }}
-{{- end }}
+{{- marshalIndent .Sections }}

Original file line number	Diff line number	Diff line change
`@@ -35,9 +35,9 @@ func (r Renderer) Render(scopes []types.EnvScope, out io.Writer) error {`
`35`	`35`	`}`
`36`	`36`
`37`	`37`	`type renderSection struct {`
`38`		`- Name string`
`39`		`- Doc string`
`40`		`- Items []renderItem`
	`38`	+ Name string `json:"name,omitempty"`
	`39`	+ Doc string `json:"doc,omitempty"`
	`40`	+ Items []renderItem `json:"items,omitempty"`
`41`	`41`	`}`
`42`	`42`
`43`	`43`	`type renderItem struct {`