tools/

directory
v0.1.2 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Sep 1, 2026 License: AGPL-3.0

Directories

Path Synopsis
Package main implements docsgen: a small CLI that generates reference documentation (CLI flags, HTTP API, environment variables, configuration) for the Authplane authserver by inspecting the source tree.
Package main implements docsgen: a small CLI that generates reference documentation (CLI flags, HTTP API, environment variables, configuration) for the Authplane authserver by inspecting the source tree.
cmd
openapi.go — generate OpenAPI 3 YAML for the public + admin servers from the same handler/DTO AST walk that produces docs/reference/http-api.md.
openapi.go — generate OpenAPI 3 YAML for the public + admin servers from the same handler/DTO AST walk that produces docs/reference/http-api.md.
internal/configast
Package configast provides an AST-driven model of the authserver's configuration package.
Package configast provides an AST-driven model of the authserver's configuration package.
internal/mdwriter
Package mdwriter contains small, pure helpers for building Markdown fragments: tables, fenced code blocks, anchors and sections.
Package mdwriter contains small, pure helpers for building Markdown fragments: tables, fenced code blocks, anchors and sections.
internal/srcref
Package srcref formats AST positions as repo-relative "file:line" references suitable for embedding in generated reference docs.
Package srcref formats AST positions as repo-relative "file:line" references suitable for embedding in generated reference docs.
docslinks walks every Markdown file in the repo and verifies that inline links of the form `[text](path)` or `[text](path#fragment)` resolve: the target file exists, and any `#fragment` matches either an explicit `<a id="fragment"></a>` element or a heading whose GitHub slug matches the fragment.
docslinks walks every Markdown file in the repo and verifies that inline links of the form `[text](path)` or `[text](path#fragment)` resolve: the target file exists, and any `#fragment` matches either an explicit `<a id="fragment"></a>` element or a heading whose GitHub slug matches the fragment.
Package main implements loccount: a small CLI that counts auth-specific lines of code inside marked regions in example projects and renders a summary banner in each example's README.md.
Package main implements loccount: a small CLI that counts auth-specific lines of code inside marked regions in example projects and renders a summary banner in each example's README.md.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL