A set of Traits and Types that make up the Activity Streams specification
For basic use, add the following to your Cargo.toml ```toml
activitystreams = "0.1" ```
And then use it in your project ```rust extern crate activitystreams; extern crate failure; extern crate serde;
extern crate serdederive; extern crate serdejson;
use activitystreams::{context, Object, Actor, object::Profile}; use failure::Error;
pub struct Persona { #[serde(rename = "@context")] context: serde_json::Value,
#[serde(rename = "type")]
kind: String,
}
impl Object for Persona {} impl Actor for Persona {}
fn run() -> Result<(), Error> { let mut profile = Profile::default();
profile.profile.set_describes_object(Persona {
context: serde_json::to_value(context())?,
kind: "Persona".to_owned(),
})?;
profile.object_props.set_context_object(context())?;
let profile_string = serde_json::to_string(&profile)?;
let profile: Profile = serde_json::from_str(&profile_string)?;
Ok(())
} ```
Add the required crates to your Cargo.toml
```toml
activitystreams-derive = "0.1" activitystreams-traits = "0.1" serde = "1.0" serdederive = "1.0" serdejson = "1.0" ```
And then in your project ```rust
extern crate activitystreamsderive; extern crate activitystreamstraits; extern crate activitystreams_types; extern crate failure; extern crate serde;
extern crate serdederive; extern crate serdejson;
use activitystreamstraits::{Link, Object}; use activitystreamstypes::{CustomLink, link::Mention}; use failure::Error;
/// Using the UnitString derive macro /// /// This macro implements Serialize and Deserialize for the given type, making this type /// represent the string "SomeKind" in JSON.
pub struct MyKind;
/// Using the Properties derive macro /// /// This macro generates getters and setters for the associated fields.
pub struct MyProperties {
/// Derive getters and setters for @context with Link and Object traits.
#[serde(rename = "@context")]
#[activitystreams(ab(Object, Link))]
pub context: Option
/// Use the UnitString MyKind to enforce the type of the object by "SomeKind"
pub kind: MyKind,
/// Derive getters and setters for required_key with String type.
///
/// In the Activity Streams spec, 'functional' means there can only be one item for this
/// key. This means all fields not labeled 'functional' can also be serialized/deserialized
/// as Vec<T>.
#[activitystreams(concrete(String), functional)]
pub required_key: serde_json::Value,
}
fn run() -> Result<(), Error> { let mut props = MyProperties::default();
props.set_required_key_string("Hey".to_owned())?;
let my_link = CustomLink::new(Mention::default(), props);
let my_link_string = serde_json::to_string(&my_link)?;
let my_link: CustomLink<Mention, MyProperties> = serde_json::from_str(&my_link_string)?;
Ok(())
} ```
Feel free to open issues for anything you find an issue with. Please note that any contributed code will be licensed under the GPLv3.
Copyright © 2018 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/.