apb

traits and types for implementing ActivityPub

apb implements all ActivityStreams 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<T> enum, which can represent ActivityPub nodes (empty, link, object, array)

read more in this crate's docs

why

upub uses these types to implement its federation, but I wanted to modularize apb types

state

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!

lib.rs:

apb

traits and types for implementing ActivityPub

The main type this crate exposes is the [Node], which can be:

• Node::Empty: not present in object
• Node::Link: contains just link to object
• Node::Object: contains embedded object
• Node::Array: contains array of embedded objects

Nodes contain AP objects, which implement one or more traits (such as [Object] or [Actor])

features

• unstructured: all traits are implemented for serde_json::Value, so that it's possible to manipulate free-form json maps as valid AP objects
• orm: enum types are also database-friendly with sea-orm
• fetch: [Node] exposes Node::fetch to dereference remote nodes

structure

• [Base] | [BaseMut] | [BaseType]
  • BaseType::Link | [Link] | [LinkMut] | [LinkType]
    • LinkType::Mention
    • LinkType::Link
  • BaseType::Object | [Object] | [ObjectMut] | [ObjectType]
    • ObjectType::Activity | [Activity] | [ActivityMut] | [ActivityType]
      • ActivityType::Accept | [Accept] | [AcceptMut] | [AcceptType]
        • AcceptType::TentativeAccept
      • ActivityType::Add
      • ActivityType::Announce
      • ActivityType::Create
      • ActivityType::Delete
      • ActivityType::Dislike
      • ActivityType::Flag
      • ActivityType::Follow
      • ActivityType::IntransitiveActivity | [IntransitiveActivity] | [IntransitiveActivityMut] | [IntransitiveActivityType]
        • IntransitiveActivityType::IntransitiveActivity
        • IntransitiveActivityType::Arrive
        • IntransitiveActivityType::Question
        • IntransitiveActivityType::Travel
      • ActivityType::Ignore | [Ignore] | [IgnoreMut] | [IgnoreType]
        • IgnoreType::Ignore
        • IgnoreType::Block
      • ActivityType::Join
      • ActivityType::Leave
      • ActivityType::Like
      • ActivityType::Listen
      • ActivityType::Move
      • ActivityType::Offer | [Offer] | [OfferMut] | [OfferType]
        • OfferType::Offer
        • OfferType::Invite
      • ActivityType::Read
      • ActivityType::Reject | [Reject] | [RejectMut] | [RejectType]
        • RejectType::Reject
        • RejectType::TentativeReject
      • ActivityType::Remove
      • ActivityType::Undo
      • ActivityType::Update
      • ActivityType::View
    • ObjectType::Actor | [Actor] | [ActorMut] | [ActorType] *
      • ActorType::Application
      • ActorType::Group
      • ActorType::Organization
      • ActorType::Person
    • ObjectType::Article
    • ObjectType::Collection | [Collection] | [CollectionMut] | [CollectionType]
      • CollectionType::Collection
      • CollectionType::CollectionPage
      • CollectionType::OrderedCollection
      • CollectionType::OrderedCollectionPage
    • ObjectType::Document | [Document] | [DocumentMut] | [DocumentType]
      • DocumentType::Document
      • DocumentType::Audio
      • DocumentType::Image
      • DocumentType::Page
      • DocumentType::Video
    • ObjectType::Event
    • ObjectType::Note
    • ObjectType::Object
    • ObjectType::Place
    • ObjectType::Profile
    • ObjectType::Relationship
    • ObjectType::Tombstone
  • [PublicKey] | [PublicKeyMut] **

*: Actor is technically just an object, not really a "subtype"

**: PublicKey is introduced in ActivityPub, it's not part of ActivityStream