103 lines
3.2 KiB
Markdown
103 lines
3.2 KiB
Markdown
# An extension API for activitystreams-new
|
|
|
|
This crate provides Ext1, Ext2, Ext3, and Ext4 for adding extensions to ActivityStreams types
|
|
|
|
## Usage
|
|
|
|
First, add ActivityStreams to your dependencies
|
|
```toml
|
|
[dependencies]
|
|
activitystreams-new = { version = "0.1.0", git = "https://git.asonix.dog/asonix/activitystreams-sketch" }
|
|
activitystreams-ext = { version = "0.1.0", git = "https://git.asonix.dog/asonix/activitystreams-ext" }
|
|
|
|
[patch.crates-io]
|
|
typed-builder = { git = "https://git.asonix.dog/asonix/typed-builder" }
|
|
```
|
|
|
|
For an example, we'll implement a PublicKey extension and demonstrate usage with Ext1
|
|
```rust
|
|
use activitystreams_ext::{Ext1, UnparsedExtension};
|
|
use activitystreams_new::{
|
|
actor::{ApActor, Person},
|
|
context,
|
|
prelude::*,
|
|
primitives::XsdAnyUri,
|
|
security,
|
|
unparsed::UnparsedMutExt,
|
|
};
|
|
|
|
#[derive(Clone, Debug, serde::Deserialize, serde::Serialize)]
|
|
#[serde(rename_all = "camelCase")]
|
|
pub struct PublicKey {
|
|
public_key: PublicKeyInner,
|
|
}
|
|
|
|
#[derive(Clone, Debug, serde::Deserialize, serde::Serialize)]
|
|
#[serde(rename_all = "camelCase")]
|
|
pub struct PublicKeyInner {
|
|
id: XsdAnyUri,
|
|
owner: XsdAnyUri,
|
|
public_key_pem: String,
|
|
}
|
|
|
|
impl<U> UnparsedExtension<U> for PublicKey
|
|
where
|
|
U: UnparsedMutExt,
|
|
{
|
|
type Error = serde_json::Error;
|
|
|
|
fn try_from_unparsed(unparsed_mut: &mut U) -> Result<Self, Self::Error> {
|
|
Ok(PublicKey {
|
|
public_key: unparsed_mut.remove("publicKey")?,
|
|
})
|
|
}
|
|
|
|
fn try_into_unparsed(self, unparsed_mut: &mut U) -> Result<(), Self::Error> {
|
|
unparsed_mut.insert("publicKey", self.public_key)?;
|
|
Ok(())
|
|
}
|
|
}
|
|
|
|
pub type ExtendedPerson = Ext1<ApActor<Person>, PublicKey>;
|
|
|
|
fn main() -> Result<(), anyhow::Error> {
|
|
let actor = ApActor::new(
|
|
"http://in.box".parse()?,
|
|
"http://out.box".parse()?,
|
|
Person::new(),
|
|
);
|
|
|
|
let mut person = Ext1::new(
|
|
actor,
|
|
PublicKey {
|
|
public_key: PublicKeyInner {
|
|
id: "http://key.id".parse()?,
|
|
owner: "http://owner.id".parse()?,
|
|
public_key_pem: "asdfasdfasdf".to_owned(),
|
|
},
|
|
},
|
|
);
|
|
|
|
person.set_context(context()).add_context(security());
|
|
|
|
let any_base = person.into_any_base()?;
|
|
println!("any_base: {:#?}", any_base);
|
|
let person = ExtendedPerson::from_any_base(any_base)?;
|
|
|
|
println!("person: {:#?}", person);
|
|
Ok(())
|
|
}
|
|
```
|
|
|
|
## Contributing
|
|
Feel free to open issues for anything you find an issue with. Please note that any contributed code will be licensed under the GPLv3.
|
|
|
|
## License
|
|
|
|
Copyright © 2020 Riley Trautman
|
|
|
|
ActivityStreams is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
|
|
|
|
ActivityStreams is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. This file is part of ActivityStreams.
|
|
|
|
You should have received a copy of the GNU General Public License along with ActivityStreams. If not, see [http://www.gnu.org/licenses/](http://www.gnu.org/licenses/).
|