mirror of
https://github.com/p2p-ld/linkml-activitypub.git
synced 2024-11-08 07:44:27 +00:00
LinkML Schema representation of ActivityPub
data | ||
generated | ||
linkml_activitypub | ||
.gitignore | ||
about.yaml | ||
CHANGELOG.md | ||
config.yaml | ||
LICENSE | ||
Makefile | ||
mkdocs.yml | ||
poetry.lock | ||
pyproject.toml | ||
README.md |
linkml-activitypub
LinkML representation of ActivityStreams and ActivityPub schema
https://pypi.org/projects/linkml-activitypub
Source schema:
linkml_activitypub/activitystreams.yaml
- ActivityStreams2 vocabulary schemalinkml_activitypub/activitypub.yaml
- ActivityPub Extensions to ActivityStreams2 (imports ActivityStreams2)
Generated models:
generated/
- All generated schema for both source schema- Pydantic 2 Models:
linkml_activitypub/activitystreams.py
linkml_activitypub/activitypub.py
- Dataclasses
linkml_activitypub/dataclass/activitystreams.py
linkml_activitypub/dataclass/activitypub.py
ActivityStreams
Process
Intermediate files are in the data
directory
activitystreams2.owl
- Initially imported from activitystreams2.owl- Removed problematic OrderedCollection definitions
activitystreams2.ofn
- Convert to functional notation with robotactivitystreams2.yaml
- Then to rough linkml using schema-automator
Then the final schema in linkml_activitypub/activitystreams.yaml
:
- Reorder to match ActivityStreams
- Ensure correct
- inheritance
multivalued
- Prune extra properties and classes to match those in ActivityStreams2 normative definition
- Then re-add the ones that declare a class in their domain, even if the class doesn't list that property in its definition
- Except for those types that seem to be metaclasses:
attributedTo
(->actor
)
- Added LinkML properties (where needed):
- Classes
disjoint_with
see_also
when references given
- Properties
description
domain
range
minumum_value
maximum_value
- Classes
- Added missing slots
closed
startIndex
- Handle special property cases
items
is marked aslist_elements_ordered: true
onOrderedCollection
and false onCollection
- Made types
- anyURI as
xsd:anyURI
, did not try and find a validator pattern. The spec alternatingly uses its own anyURI prop andxsd:anyURI
duration
as a string that indicates it's axsd:duration
, finding a pattern is TODO
- anyURI as
- Made enums
unitEnum
- forunit
- Copied Notes to class
description
rather thancomments
- Added schema prefixes:
schema
: https://schema.org/ - for specifying IETF BCP 47 language codes
Errata
OrderedCollectionPage
is not a subclass of, and doesn't mix inCollectionPage
since it would then have an ambiguous class definition, sinceOrderedCollection
inherits fromCollection
but asserts that thelist_items_ordered
slot istrue
rather thanfalse
. Instead, the slots fromCollectionPage
are just duplicated.- Accordingly, the domain and range of slots that include
CollectionPage
also include `OrderedCollectionPage
- Accordingly, the domain and range of slots that include
- Need to implement some
xsd:duration
pattern
TODO
- JSON-LD Serialization: https://www.w3.org/TR/activitystreams-core/#syntaxconventions
- Collection serialization: "In the JSON serialization, the unordered items of a Collection are represented using the items property while ordered items are represented using the orderedItems property."
- Should
items
andorderedItems
just be disjoint slots, rather than a slot with a special property modification?
- Should
ActivityPub
Process
Errata
TODO
- Everything!
References
- Status of AS OWL vocabulary and etc. https://github.com/w3c/activitystreams/issues/416