21 行
879 B
Markdown
21 行
879 B
Markdown
|
# gen
|
||
|
|
||
|
This library is used to generate the `vocab` library implementation. Changes to
|
||
|
this will fundamentally change the implementation of the `vocab` library. If
|
||
|
custom ActivityStream types are required, no changes to this are required.
|
||
|
Instead, the `tools/gen/vocab` library will need edits.
|
||
|
|
||
|
Creating a static type implementation from the specification is not
|
||
|
straightforward due to the following considerations that stem from its roots in
|
||
|
JSON-LD:
|
||
|
|
||
|
* Any property could be an IRI (`url.URL`)
|
||
|
* Most properties could be another ActivityStream type
|
||
|
(`map[string]interface{}`) or a value (`time.Time`, etc)
|
||
|
* Most properties can have multiple values (`[]interface{}`)
|
||
|
* In a multiple value scenario, each value could once more be an IRI, another
|
||
|
ActivityStream type, or a value
|
||
|
|
||
|
The current generation algorithm leaves ample opportunity for improvements and
|
||
|
optimizations.
|