![]() |
||
---|---|---|
.. | ||
codegen | ||
convert | ||
gen | ||
rdf | ||
README.md | ||
activitystreams.jsonld | ||
example_custom_spec.jsonld | ||
main.go |
README.md
ActivityStreams Tool
go get github.com/go-fed/activity
cd $GOPATH/github.com/go-fed/activity/astool
go build
./astool -h
Overview
The code-generation tool for ActivityStreams and extensions.
This tool is simple: It accepts an RDF definition in OWL2 syntax of an ActivityStreams vocabulary, and generates the Go code required to:
- Create native types and properties of this vocabulary.
- Handle the serialization and deserialization of JSON correctly, including
the instances where non-functional properties could be an object (
{}
), an array of objects and/or IRIs ([]
), or an IRI (https://exmaple.com/id
). - Manages the ActivityStreams inheritance properly of
extends
anddisjoint
, which is in the RDF-sense. It is not the same kind of inheritance as the Object Oriented sense of inheritance. - Provides Resolvers and PredicatedResolvers to (conditionally) take arbitrary objects or data and resolve them into concrete types.
All of the above code is autogenerated, allowing:
- Application developers to rapidly use the needed ActivityStreams in their domain.
- Extension writers a quick way to iteratively prototype a new ActivityStreams extension, skipping boilerplate code writing in the process.
- Go-fed alternatives to fork the tool and generate their own implementations, or hook their own implementations into the dependency-injected Manager so they are used in existing applications seamlessly.
All code is generated in the current working directory that the tool is executed in.
Generating the ActivityStreams Vocabulary
Comprehensive help is available at:
astool -h
The ActivityStreams tool accepts one or more specifications for the
Core And Extended ActivityStreams
vocabulary as well as any derived vocabularies. For example, bundled with this
tool is activitystreams.jsonld
which contains the OWL2 definition of the
ActivityStreams specification. To generate the code, in your $GOPATH
do:
mkdir tmp
cd tmp
astool -spec activitystreams.jsonld
This will automatically generate a number of files containing the functions,
structs, and interfaces for use in your program. Alternatively, the
go-fed/activity
library has all of these pregenerated for you.
Generating An Extension
If you want to create an ActivityStreams Extensions, see the provided file
example_custom_spec.jsonld
which contains a custom type and property which
leverage the original ActivityStreams specification.
Any new derived extension must be passed into the tool, as well as any dependencies, in order of derivation:
mkdir tmp
cd tmp
astool -spec activitystreams.jsonld -spec example\_custom\_spec.jsonld
This automatically generates a number of files containing the functions, structs, and interfaces for both of these vocabularies.
Generating As A Module
The tool has untested, experimental support for generating code with a specific prefix path to all package names:
mkdir tmp
cd tmp
astool -spec activitystreams.jsonld -path mymodule
Known Limitations
This tool relies on built-in knowledge of several ontologies:
- OWL2
- RDF
- RDF Schema
- Schema.org
- XML Schema
- RFCs
It does not have complete knowledge of these schemas, so if an error is encountered during the code generation process with a new extension, please file an issue.