mirror of
https://github.com/mjl-/mox.git
synced 2024-12-29 09:53:47 +03:00
a69887bfab
this simplifies some of the code that makes modifications to the config file. a few protected functions can make changes to the dynamic config, which webadmin can use. instead of having separate functions in mox-/admin.go for each type of change. this also exports the parsed full dynamic config to webadmin, so we need fewer functions for specific config fields too.
28 lines
1.8 KiB
Text
28 lines
1.8 KiB
Text
sherpadoc - documentation for sherpa API's
|
|
|
|
Go package containing type defintions for sherpa documentation for encoding to and decoding from json.
|
|
Also contains the sherpadoc command reads Go code and writes sherpadoc JSON.
|
|
|
|
Use together with the sherpa library, github.com/mjl-/sherpa.
|
|
Read more about sherpa at https://www.ueber.net/who/mjl/sherpa/
|
|
|
|
# About
|
|
|
|
Written by Mechiel Lukkien, mechiel@ueber.net.
|
|
Bug fixes, patches, comments are welcome.
|
|
MIT-licensed, see LICENSE.
|
|
|
|
# todo
|
|
|
|
- major cleanup required. too much parsing is done that can probably be handled by the go/* packages.
|
|
- check that all cases of embedding work (seems like we will include duplicates: when a struct has fields that override an embedded struct, we generate duplicate fields).
|
|
- check that all cross-package referencing (ast.SelectorExpr) works
|
|
- better cli syntax for replacements and renames, and always replace based on fully qualified names. currently you need to specify both the fully qualified and unqualified type paths.
|
|
- see if order of items in output depends on a map somewhere, i've seen diffs for generated jsons where a type was only moved, not modified. perhaps the type was discovered earlier/later because of other type changes. we may want to sort sections,methods,types in the output.
|
|
- better error messages and error handling, stricter parsing
|
|
- support type aliases
|
|
- support plain iota enums? currently only simple literals are supported for enums.
|
|
- support complete expressions for enum consts?
|
|
- find out which go constructs people want to use that aren't yet implemented by sherpadoc
|
|
- when to make a field nullable. when omitempty is set? (currently yes), when field is a pointer type (currently yes). should we have a way to prevent nullable without omitempty set, or make field a pointer without it being nullable?
|
|
- write tests
|