docs: added readme

This commit is contained in:
əlemi 2024-04-06 18:24:10 +02:00
parent 03c606514e
commit 5672f75242
Signed by: alemi
GPG key ID: A4895B84D311642C

15
apb/README.md Normal file
View file

@ -0,0 +1,15 @@
# apb
> traits and types for implementing [ActivityPub](https://www.w3.org/TR/activitypub/)
`apb` implements all [ActivityStreams](https://www.w3.org/TR/activitystreams-core/) types as traits, so that implementing structs don't need to hold all possible fields, but only implement getters for relevant ones
`apb` also provides a `Node` enum, which can be Empty, Link, Object or Array
if the `unstructured` feature is enabled, all traits are implemented for `serde_json::Value`, so that it's possible to manipulate free-form json maps as valid AP objects
if the `orm` feature is enabled, enum types are also database-friendly with sea-orm
if the `fetch` feature is enabled (together with `unstructured`), `Node`s expose a `async fn fetch(&mut self) -> reqwest::Result<&mut Self>` to dereference remote nodes
## why
[upub](https://git.alemi.dev/upub.git) uses these types to implement its federation, but I wanted to modularize apb types. this crate is still work in progress and favors upub's needs, get in touch if you'd like to help or tune apb to your project!