streams

package
v0.15.2 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Feb 21, 2026 License: Apache-2.0 Imports: 18 Imported by: 16

README

Hannibal / streams

This package implements the ActivityStreams 2.0 specifications in Hannibal. Specifically, it provides an overly simplistic view of JSON-LD documents, contexts, and the various types of ActivityStream collections.

This is not a rigorous implementation of JSON-LD. Instead, it is an easy way to navigate well-formatted JSON-LD documents and to iterate over their contents, as well as loading additional documents from the web when necessary.

// Load a document directly from its URL
document, err := streams.Load("https://your.activitypub.server/@documentId")

document.ID() // returns a string value
document.Content() // returns the content property
document.Published() // returns a time value

// AttributedTo could be many things.. a single value, a link, or
// an array of values and links. Let's make all of that easier.
authors := document.AttributedTo() 

// You could just read the first author directly
authors.Name() // returns the 'Name' string
authors.ID() // returns the 'ID' string

// Or you can use it as an iterator
for authors := document.AttributedTo ; !authors.IsNil() ; authors = authors.Tail() {
	authors.Value() // returns the whole value from the array
}

Documentation

Index

Constants

View Source 
const OptionStripContext = "STRIP_CONTEXT"

OptionStripContext instructs the Document.Map() method to remove the "@context" property from its ouput.

View Source 
const OptionStripRecipients = "STRIP_RECCIPIENTS"

OptionStripRecipients instructs the Document.Map() method to remove all recipient properties from its output. (To, BTo, CC, BCC)

Variables

This section is empty.

Functions

func DocumentCategory added in v0.14.0 

func DocumentCategory(documentType string) string

DocumentCategory returns the higher level category for the provided document type: [Activity, Actor, Collection, Object]

func IsActivity added in v0.14.0 

func IsActivity(documentType string) bool

func IsActor added in v0.14.0 

func IsActor(documentType string) bool

func IsCollection added in v0.14.0 

func IsCollection(documentType string) bool

func IsObject added in v0.14.0 

func IsObject(documentType string) bool

func UnmarshalItems 

func UnmarshalItems(data any) ([]any, bool)

Types

type Client added in v0.1.19 

type Client interface {

	// SetRootClient is used to make a pointer to the top-level
	// client. This may be needed by some stacked clients that
	// make recursive calls to the Interwebs.
	SetRootClient(Client)

	// Load returns a Document representing the specified URI.
	Load(uri string, options ...any) (Document, error)

	// Save stores the Document in a local cache. (NOOP for most clients)
	Save(document Document) error

	// Delete removes a Document from a local cache (NOOP for most clients)
	Delete(documentID string) error
}

Client represents an HTTP client (or facades in front of one) that can load a JSON-LD document from a remote server. A Client is injected into each streams.Document record so that the Document can load additional linked data as needed.

func NewDefaultClient added in v0.1.19 

func NewDefaultClient(options ...remote.Option) Client

type Collection 

type Collection struct {
	Context    Context `json:"@context,omitempty"    bson:"context,omitempty"`
	ID         string  `json:"id,omitempty"          bson:"id,omitempty"`
	Type       string  `json:"type,omitempty"        bson:"type,omitempty"`
	Summary    string  `json:"summary,omitempty"     bson:"summary,omitempty"`    // A natural language summarization of the object encoded as HTML. Multiple language tagged summaries may be provided.
	TotalItems int     `json:"totalItems,omitempty"  bson:"totalItems,omitempty"` // A non-negative integer specifying the total number of objects contained by the logical view of the collection. This number might not reflect the actual number of items serialized within the Collection object instance.
	Current    string  `json:"current,omitempty"     bson:"current,omitempty"`    // In a paged Collection, indicates the page that contains the most recently updated member items.
	First      string  `json:"first,omitempty"       bson:"first,omitempty"`      // In a paged Collection, indicates the furthest preceding page of items in the collection.
	Last       string  `json:"last,omitempty"        bson:"last,omitempty"`       // In a paged Collection, indicates the furthest proceeding page of the collection.
	Items      []any   `json:"items,omitempty"       bson:"items,omitempty"`      // Identifies the items contained in a collection. The items might be ordered or unordered.
}

Collection is a subtype of Object that represents ordered or unordered sets of Object or Link instances. https://www.w3.org/ns/activitystreams#Collection

func NewCollection added in v0.1.19 

func NewCollection(collectionID string) Collection

func (*Collection) UnmarshalJSON 

func (c *Collection) UnmarshalJSON(data []byte) error

func (*Collection) UnmarshalMap 

func (c *Collection) UnmarshalMap(data mapof.Any) error

type CollectionHeader added in v0.15.1 

type CollectionHeader struct {
	Context    Context `json:"@context,omitempty"    bson:"context,omitempty"`    // JSON-LD context to use
	ID         string  `json:"id,omitempty"          bson:"id,omitempty"`         // ID/URL of the Collection
	Type       string  `json:"type,omitempty"        bson:"type,omitempty"`       // Type of the Collection ("Collection" or "OrderedCollection")
	TotalItems int     `json:"totalItems,omitempty"  bson:"totalItems,omitempty"` // A non-negative integer specifying the total number of objects contained by the logical view of the collection. This number might not reflect the actual number of items serialized within the Collection object instance.
	First      string  `json:"first,omitempty"       bson:"first,omitempty"`      // In a paged Collection, indicates the furthest preceding page of items in the collection.
}

CollectionHeader is an opinionated format for generating/parsing the header information of a Collection. It does not include any actual items, just the `totalItems` and `first` page URL.

type CollectionPage 

type CollectionPage struct {
	Context    Context `json:"@context,omitempty"    bson:"context,omitempty"`
	Type       string  `json:"type,omitempty"        bson:"type,omitempty"`       // Identifies the Object or Link type. (CollectionPage, OrderedCollectionPage)
	ID         string  `json:"id,omitempty"          bson:"id,omitempty"`         // Provides the globally unique identifier for an Object or Link.
	Summary    string  `json:"summary,omitempty"     bson:"summary,omitempty"`    // A natural language summarization of the object encoded as HTML. Multiple language tagged summaries may be provided.
	TotalItems int     `json:"totalItems,omitempty"  bson:"totalItems,omitempty"` // A non-negative integer specifying the total number of objects contained by the logical view of the collection. This number might not reflect the actual number of items serialized within the Collection object instance.
	Current    string  `json:"current,omitempty"     bson:"current,omitempty"`    // In a paged Collection, indicates the page that contains the most recently updated member items.
	First      string  `json:"first,omitempty"       bson:"first,omitempty"`      // In a paged Collection, indicates the furthest preceding page of items in the collection.
	Last       string  `json:"last,omitempty"        bson:"last,omitempty"`       // In a paged Collection, indicates the furthest proceeding page of the collection.
	PartOf     string  `json:"partOf,omitempty"      bson:"partOf,omitempty"`     // dentifies the Collection to which a CollectionPage objects items belong.
	Prev       string  `json:"prev,omitempty"        bson:"prev,omitempty"`       // In a paged Collection, identifies the previous page of items.
	Next       string  `json:"next,omitempty"        bson:"next,omitempty"`       // In a paged Collection, indicates the next page of items.
	Items      []any   `json:"items,omitempty"       bson:"items,omitempty"`      // Identifies the items contained in a collection. The items might be ordered or unordered.
}

CollectionPage is used to represent distinct subsets of items from a Collection. Refer to the Activity Streams 2.0 Core for a complete description of the CollectionPage object. https://www.w3.org/ns/activitystreams#CollectionPage

func NewCollectionPage added in v0.1.19 

func NewCollectionPage(pageID string) CollectionPage

func (*CollectionPage) UnmarshalJSON 

func (c *CollectionPage) UnmarshalJSON(data []byte) error

func (*CollectionPage) UnmarshalMap 

func (c *CollectionPage) UnmarshalMap(data mapof.Any) error

type Context 

type Context []ContextEntry

func DefaultContext 

func DefaultContext() Context

DefaultContext represents the standard context defined by the W3C

func NewContext 

func NewContext(args ...string) Context

func (*Context) Add 

func (c *Context) Add(vocabulary string) *ContextEntry

Add puts a new ContextEntry into the list and returns a pointer to it so that additional properties can be set.

func (Context) Head 

func (c Context) Head() *ContextEntry

func (Context) IsEmpty 

func (c Context) IsEmpty() bool

func (Context) IsEmptyTail 

func (c Context) IsEmptyTail() bool

func (Context) Length 

func (c Context) Length() int

func (Context) MarshalJSON 

func (c Context) MarshalJSON() ([]byte, error)

func (Context) Tail 

func (c Context) Tail() Context

func (*Context) UnmarshalJSON 

func (c *Context) UnmarshalJSON(data []byte) error

type ContextEntry 

type ContextEntry struct {
	Vocabulary string            // The primary vocabulary represented by the context/document.
	Language   string            // The language
	Extensions map[string]string // a map of additional namespaces that are included in this context/document.
}

ContextEntry https://www.w3.org/TR/json-ld/#the-context

func NewContextEntry 

func NewContextEntry(vocabulary string) ContextEntry

func (ContextEntry) HasExtensions 

func (entry ContextEntry) HasExtensions() bool

func (ContextEntry) IsLanguageDefined 

func (entry ContextEntry) IsLanguageDefined() bool

func (ContextEntry) IsVocabularyOnly 

func (entry ContextEntry) IsVocabularyOnly() bool

func (ContextEntry) MarshalJSON 

func (entry ContextEntry) MarshalJSON() ([]byte, error)

func (*ContextEntry) WithExtension 

func (entry *ContextEntry) WithExtension(key string, value string) *ContextEntry

func (*ContextEntry) WithLanguage 

func (entry *ContextEntry) WithLanguage(language string) *ContextEntry

type DefaultClient added in v0.1.19 

type DefaultClient struct {
	// contains filtered or unexported fields
}

DefaultClient is a default implementation of the hannibal.Client interface. It simply loads ActivityStream documents from remote servers with no caching

func (DefaultClient) Delete added in v0.14.0 

func (client DefaultClient) Delete(documentID string) error

Delete is required to implement the document.Cache interface. For this client, Delete is a NOOP

func (DefaultClient) Load added in v0.1.19 

func (client DefaultClient) Load(url string, options ...any) (Document, error)

Load implements the hannibal.Client interface, which loads an ActivityStream document from a remote server. For the hannibal default client, this method simply loads the document from a remote server with no other processing.

func (DefaultClient) Save added in v0.14.0 

func (client DefaultClient) Save(document Document) error

Save is required to implement the document.Cache interface. For this client, Save is a NOOP

func (DefaultClient) SetRootClient added in v0.14.0 

func (client DefaultClient) SetRootClient(rootClient Client)

SetRootClient is required to implement the hannibal.Client interface. For this client, SetRootClient is a NOOP

type Document 

type Document struct {
	Metadata Metadata
	// contains filtered or unexported fields
}

Document represents a single ActivityStream document or document fragment. Due to the flexibility of ActivityStreams (and JSON-LD), this may be a data structure such as a `map[string]any`, `[]any`, or a primitive type, like a `string`, `float`, `int` or `bool`.

func NewDocument 

func NewDocument(value any, options ...DocumentOption) Document

NewDocument creates a new Document object from a JSON-LD map[string]any

func NilDocument 

func NilDocument(options ...DocumentOption) Document

NilDocument returns a new, empty Document.

func (Document) Accuracy 

func (document Document) Accuracy() float64

https://www.w3.org/TR/activitystreams-vocabulary/#dfn-accuracy

func (Document) Actor 

func (document Document) Actor() Document

https://www.w3.org/TR/activitystreams-vocabulary/#dfn-actor

func (Document) Altitude 

func (document Document) Altitude() float64

https://www.w3.org/TR/activitystreams-vocabulary/#dfn-altitude

func (Document) AnyOf 

func (document Document) AnyOf() Document

https://www.w3.org/TR/activitystreams-vocabulary/#dfn-anyof

func (*Document) Append added in v0.1.19 

func (document *Document) Append(name string, value any) bool

Append appends a value to a property on the document

func (Document) AppendBCC added in v0.1.19 

func (document Document) AppendBCC(value string) bool

AppendBCC appends a value to the "bcc" property of the document

func (Document) AppendBTo added in v0.1.19 

func (document Document) AppendBTo(value string) bool

AppendBTo appends a value to the "bto" property of the document

func (Document) AppendCC added in v0.1.19 

func (document Document) AppendCC(value string) bool

AppendCC appends a value to the "cc" property of the document

func (*Document) AppendString added in v0.1.19 

func (document *Document) AppendString(name string, value string) bool

AppendString appends a string to a property on the document

func (Document) AppendTo added in v0.1.19 

func (document Document) AppendTo(value string) bool

AppendTo appends a value to the "to" property of the document

func (Document) AspectRatio added in v0.1.19 

func (document Document) AspectRatio() string

AspectRatio inspects a Document's "width" and "height" properties and (if they are non-zero) returns a computed aspect ratio

func (Document) AtContext added in v0.1.19 

func (document Document) AtContext() Document

https://www.w3.org/TR/activitystreams-core/#h-jsonld

func (Document) Attachment 

func (document Document) Attachment() Document

https://www.w3.org/TR/activitystreams-vocabulary/#dfn-attachment

func (Document) AttributedTo 

func (document Document) AttributedTo() Document

https://www.w3.org/TR/activitystreams-vocabulary/#dfn-attributedto

func (Document) Audience 

func (document Document) Audience() Document

https://www.w3.org/TR/activitystreams-vocabulary/#dfn-audience

func (Document) BCC added in v0.1.19 

func (document Document) BCC() Document

https://www.w3.org/TR/activitystreams-vocabulary/#dfn-bcc

func (Document) BTo added in v0.1.19 

func (document Document) BTo() Document

https://www.w3.org/TR/activitystreams-vocabulary/#dfn-bto

func (Document) Blocked added in v0.1.19 

func (document Document) Blocked() Document

http://w3id.org/fep/c648

func (Document) Bool added in v0.1.19 

func (document Document) Bool() bool

Bool returns the current object as a floating-point value

func (Document) CC added in v0.1.19 

func (document Document) CC() Document

https://www.w3.org/TR/activitystreams-vocabulary/#dfn-cc

func (Document) Channel added in v0.1.19 

func (document Document) Channel() <-chan Document

Channel returns a channel that iterates over all of the sub-documents in the current document. deprecated: Use Range method instead of channels

func (*Document) Client added in v0.1.19 

func (document *Document) Client() Client

Client returns the HTTP client used for this document

func (Document) Clone added in v0.1.19 

func (document Document) Clone() Document

func (Document) Closed 

func (document Document) Closed() Document

https://www.w3.org/TR/activitystreams-vocabulary/#dfn-closed

func (Document) Content 

func (document Document) Content() string

https://www.w3.org/TR/activitystreams-vocabulary/#dfn-content

func (Document) Context 

func (document Document) Context() string

https://www.w3.org/TR/activitystreams-vocabulary/#dfn-context IMPORTANT: THIS IS NOT THE @context PROPERTY REQUIRED FOR EVERY JSON-LD DOCUMENT

func (Document) Current 

func (document Document) Current() Document

https://www.w3.org/TR/activitystreams-vocabulary/#dfn-current

func (Document) Deleted 

func (document Document) Deleted() time.Time

https://www.w3.org/TR/activitystreams-vocabulary/#dfn-deleted

func (Document) Describes 

func (document Document) Describes() Document

https://www.w3.org/TR/activitystreams-vocabulary/#dfn-describes

func (Document) DocumentCategory added in v0.14.0 

func (document Document) DocumentCategory() string

func (Document) Duration 

func (document Document) Duration() string

TODO: Implement Durations per https://www.w3.org/TR/activitystreams-vocabulary/#dfn-duration

func (Document) Encoding added in v0.14.6 

func (document Document) Encoding() string

https://swicg.github.io/activitypub-e2ee/mls#encoding

func (Document) EndTime 

func (document Document) EndTime() time.Time

https://www.w3.org/TR/activitystreams-vocabulary/#dfn-endtime

func (Document) Endpoints added in v0.1.19 

func (document Document) Endpoints() Document

https://www.w3.org/TR/activitypub/#endpoints

func (Document) Featured added in v0.13.3 

func (document Document) Featured() Document

https://docs.joinmastodon.org/spec/activitypub/#featured

func (Document) First 

func (document Document) First() Document

https://www.w3.org/TR/activitystreams-vocabulary/#dfn-first

func (Document) FirstImageAttachment added in v0.12.1 

func (document Document) FirstImageAttachment() Image

FirstImageAttachment scans all attachments and returns the first one with a media type that begins with "image/"

func (Document) Float added in v0.1.19 

func (document Document) Float() float64

Float returns the current object as an integer value

func (Document) Followers added in v0.1.19 

func (document Document) Followers() Document

https://www.w3.org/TR/activitypub/#followers

func (Document) Following added in v0.1.19 

func (document Document) Following() Document

https://www.w3.org/TR/activitypub/#following

func (Document) FormerType 

func (document Document) FormerType() string

https://www.w3.org/TR/activitystreams-vocabulary/#dfn-formertype

func (Document) Generator 

func (document Document) Generator() Document

https://www.w3.org/TR/activitystreams-vocabulary/#dfn-generator

func (Document) Get 

func (document Document) Get(key string) Document

Get returns a sub-property of the current document

func (Document) HTMLString added in v0.1.19 

func (document Document) HTMLString() string

StringHTML returns the current object as an HTML string. This value is filtered by blueMonday, so it is safe to use in HTML.

func (Document) HTTPHeader added in v0.1.19 

func (document Document) HTTPHeader() http.Header

HTTPHeader returns the http.Header object associated with this document

func (Document) HasContent added in v0.1.19 

func (document Document) HasContent() bool

HasContent returns TRUE if this document has a valid Content property

func (Document) HasDimensions added in v0.1.19 

func (document Document) HasDimensions() bool

func (Document) HasIcon added in v0.13.3 

func (document Document) HasIcon() bool

HasIcon returns TRUE if this document has a valid Icon property

func (Document) HasImage added in v0.1.19 

func (document Document) HasImage() bool

HasImage returns TRUE if this document has a valid Image property

func (Document) HasSummary added in v0.1.19 

func (document Document) HasSummary() bool

HasSummary returns TRUE if this document has a valid Summary property

func (Document) Head 

func (document Document) Head() Document

Head returns the first object in a slice. For all other document types, it returns the current document.

func (Document) Height 

func (document Document) Height() int

https://www.w3.org/TR/activitystreams-vocabulary/#dfn-height

func (Document) Href 

func (document Document) Href() string

https://www.w3.org/TR/activitystreams-vocabulary/#dfn-href

func (Document) Hreflang 

func (document Document) Hreflang() string

https://www.w3.org/TR/activitystreams-vocabulary/#dfn-hreflang

func (Document) ID 

func (document Document) ID() string

https://www.w3.org/TR/activitystreams-vocabulary/#dfn-id

func (Document) Icon 

func (document Document) Icon() Image

https://www.w3.org/TR/activitystreams-vocabulary/#dfn-icon

func (Document) IconOrImage added in v0.1.19 

func (document Document) IconOrImage() Image

IconOrImage is a hybrid accessor that returns the "icon" property (if not nil), otherwise it returns the "image" property. This is useful for working with different ActivityPub objects, which may use either property.

func (Document) Image 

func (document Document) Image() Image

https://www.w3.org/TR/activitystreams-vocabulary/#dfn-image

func (Document) ImageOrIcon added in v0.1.19 

func (document Document) ImageOrIcon() Image

ImageOrIcon is a hybrid accessor that returns the "image" property (if not nil), otherwise it returns the "icon" property. This is useful for working with different ActivityPub objects, which may use either property.

func (Document) InReplyTo 

func (document Document) InReplyTo() Document

https://www.w3.org/TR/activitystreams-vocabulary/#dfn-inreplyto

func (Document) Inbox added in v0.1.19 

func (document Document) Inbox() Document

https://www.w3.org/TR/activitypub/#inbox

func (Document) Instrument 

func (document Document) Instrument() Document

https://www.w3.org/TR/activitystreams-vocabulary/#dfn-instrument

func (Document) Int added in v0.1.19 

func (document Document) Int() int

Int returns the current object as an integer value

func (Document) IsActivity added in v0.1.19 

func (document Document) IsActivity() bool

IsActivity returns TRUE if this document represents an Activity

func (Document) IsActor added in v0.1.19 

func (document Document) IsActor() bool

IsActor returns TRUE if this document represents an Actor

func (Document) IsBool 

func (document Document) IsBool() bool

func (Document) IsCollection added in v0.1.19 

func (document Document) IsCollection() bool

IsCollection returns TRUE if this document represents a Collection or CollectionPage

func (Document) IsEmpty added in v0.13.3 

func (document Document) IsEmpty() bool

IsEmpty returns TRUE if the documet is empty.

func (Document) IsEmptyTail 

func (document Document) IsEmptyTail() bool

IsEmptyTail return TRUE there are no array items after the current value

func (Document) IsFloat 

func (document Document) IsFloat() bool

func (Document) IsInt 

func (document Document) IsInt() bool

func (Document) IsInt64 

func (document Document) IsInt64() bool

func (Document) IsMap added in v0.1.19 

func (document Document) IsMap() bool

func (Document) IsNil 

func (document Document) IsNil() bool

func (Document) IsObject 

func (document Document) IsObject() bool

IsObject returns TRUE if this document represents an Object type (Article, Note, etc)

func (Document) IsSlice added in v0.1.19 

func (document Document) IsSlice() bool

func (Document) IsString 

func (document Document) IsString() bool

func (Document) Items 

func (document Document) Items() Document

Items returns the items collection for this Document. If the document contains an "orderedItems" collection, then it is returned instead.

func (Document) Last 

func (document Document) Last() Document

https://www.w3.org/TR/activitystreams-vocabulary/#dfn-last

func (Document) Latitude 

func (document Document) Latitude() float64

https://www.w3.org/TR/activitystreams-vocabulary/#dfn-latitude

func (Document) Len added in v0.1.19 

func (document Document) Len() int

Len returns the length of the document. If the document is nil, then this method returns 0 If the document is a slice, then this method returns the length of the slice Otherwise, this method returns 1

func (Document) Liked added in v0.1.19 

func (document Document) Liked() Document

https://www.w3.org/TR/activitypub/#liked

func (Document) Likes added in v0.1.19 

func (document Document) Likes() Document

https://www.w3.org/TR/activitypub/#likes

func (Document) Load added in v0.1.19 

func (document Document) Load(options ...any) (Document, error)

Load retrieves a JSON-LD document from its remote server 

func (document Document) LoadLink(options ...any) Document

LoadLink loads a new JSON-LD document from a link or ID string. If the current document has already been loaded (because it's a map) then it is returned as-is.

func (Document) Location 

func (document Document) Location() Document

https://www.w3.org/TR/activitystreams-vocabulary/#dfn-location

func (Document) Longitude 

func (document Document) Longitude() float64

https://www.w3.org/TR/activitystreams-vocabulary/#dfn-longitude

func (Document) MLSKeyPackages added in v0.15.1 

func (document Document) MLSKeyPackages() Document

https://swicg.github.io/activitypub-e2ee/mls#keyPackages

func (Document) Map added in v0.1.19 

func (document Document) Map(options ...string) mapof.Any

Map returns the current object as an enhanced map[string]any

func (Document) MapKeys added in v0.1.19 

func (document Document) MapKeys() sliceof.String

MapKeys returns a slice of all keys in the current map

func (Document) MarshalJSON 

func (document Document) MarshalJSON() ([]byte, error)

MarshalJSON implements the json.Marshaller interface, and provides a custom marshalling into JSON -- essentially just aiming the marshaller at the Document's value.

func (Document) MediaType 

func (document Document) MediaType() string

https://www.w3.org/TR/activitystreams-vocabulary/#dfn-mediatype

func (Document) MustLoad added in v0.1.19 

func (document Document) MustLoad(options ...any) Document

MustLoad retrieves a JSON-LD document from its remote server. It silently reports errors, but does not return them.

func (Document) Name 

func (document Document) Name() string

https://www.w3.org/TR/activitystreams-vocabulary/#dfn-name

func (Document) Next 

func (document Document) Next() Document

https://www.w3.org/TR/activitystreams-vocabulary/#dfn-next

func (Document) NotActivity added in v0.1.19 

func (document Document) NotActivity() bool

NotActivity returns TRUE if this document does NOT represent an Activity

func (Document) NotActor added in v0.1.19 

func (document Document) NotActor() bool

NotActor returns TRUE if this document does NOT represent an Actor

func (Document) NotCollection added in v0.1.19 

func (document Document) NotCollection() bool

NotCollection returns TRUE if the document does NOT represent a Collection or CollectionPage

func (Document) NotEmpty added in v0.13.3 

func (document Document) NotEmpty() bool

NotEmpty returns TRUE if the document has at least one item in it.

func (Document) NotNil added in v0.1.19 

func (document Document) NotNil() bool

func (Document) NotObject added in v0.1.19 

func (document Document) NotObject() bool

NotObject returns TRUE if this document does NOT represent an Object type (Article, Note, etc)

func (Document) Object 

func (document Document) Object() Document

https://www.w3.org/TR/activitystreams-vocabulary/#dfn-object

func (Document) OneOf 

func (document Document) OneOf() Document

https://www.w3.org/TR/activitystreams-vocabulary/#dfn-oneof

func (Document) Origin 

func (document Document) Origin() Document

https://www.w3.org/TR/activitystreams-vocabulary/#dfn-origin

func (Document) Outbox added in v0.1.19 

func (document Document) Outbox() Document

https://www.w3.org/TR/activitypub/#outbox

func (Document) PartOf 

func (document Document) PartOf() Document

https://www.w3.org/TR/activitystreams-vocabulary/#dfn-partof

func (Document) PreferredInbox added in v0.15.0 

func (document Document) PreferredInbox() string

PreferredInbox returns an actor's Shared Inbox (if available) otherwise the actor's regular Inbox

func (Document) PreferredUsername added in v0.1.19 

func (document Document) PreferredUsername() string

https://www.w3.org/TR/activitypub/#preferredUsername

func (Document) Prev 

func (document Document) Prev() Document

https://www.w3.org/TR/activitystreams-vocabulary/#dfn-prev

func (Document) Preview 

func (document Document) Preview() Document

https://www.w3.org/TR/activitystreams-vocabulary/#dfn-preview

func (Document) PublicKey added in v0.1.19 

func (document Document) PublicKey() Document

func (Document) PublicKeyPEM added in v0.1.19 

func (document Document) PublicKeyPEM() string

func (Document) Published 

func (document Document) Published() time.Time

https://www.w3.org/TR/activitystreams-vocabulary/#dfn-published

func (Document) Radius 

func (document Document) Radius() float64

https://www.w3.org/TR/activitystreams-vocabulary/#dfn-radius

func (Document) Range added in v0.13.0 

func (document Document) Range() iter.Seq[Document]

func (Document) RangeAddressees added in v0.13.0 

func (document Document) RangeAddressees() iter.Seq[string]

func (Document) RangeIDs added in v0.13.0 

func (document Document) RangeIDs() iter.Seq[string]

RangeIDs returns an iterator that yields the IDs of each element of a Document. If the Document is empty, it yields no values. If the Document is a single object, then it yields the ID of that object. If the Document is a list, then it yields the IDs of each object in the list

func (Document) RangeInReplyTo added in v0.13.0 

func (document Document) RangeInReplyTo() iter.Seq[string]

func (Document) RangeMentions added in v0.13.0 

func (document Document) RangeMentions() iter.Seq[string]

func (Document) RangeWithIndex added in v0.13.3 

func (document Document) RangeWithIndex() iter.Seq2[int, Document]

func (Document) Recipients added in v0.15.0 

func (document Document) Recipients() sliceof.String

Recipients retrieves all recipients of an activity, i.e. actors identified in the to, cc, bcc, and bto fields

func (Document) Rel 

func (document Document) Rel() Document

https://www.w3.org/TR/activitystreams-vocabulary/#dfn-rel Rel is expected to be a string, but this function returns a document because it may contain multiple values (rel:["canonical", "preview"])

func (Document) Relationship 

func (document Document) Relationship() string

https://www.w3.org/TR/activitystreams-vocabulary/#dfn-relationship

func (Document) Replies 

func (document Document) Replies() Document

https://www.w3.org/TR/activitystreams-vocabulary/#dfn-replies

func (Document) Result 

func (document Document) Result() Document

https://www.w3.org/TR/activitystreams-vocabulary/#dfn-result

func (Document) SetBCC added in v0.1.19 

func (document Document) SetBCC(value ...string) bool

SetBCC sets the "bcc" property of the document

func (Document) SetBTo added in v0.1.19 

func (document Document) SetBTo(value ...string) bool

SetBto sets the "bto" property of the document

func (Document) SetCC added in v0.1.19 

func (document Document) SetCC(value ...string) bool

SetCC sets the "cc" property of the document

func (*Document) SetHTTPHeader added in v0.1.19 

func (document *Document) SetHTTPHeader(httpHeader http.Header)

SetHTTPHeader sets the http.Header object associated with this document

func (Document) SetID added in v0.15.1 

func (document Document) SetID(value string) bool

SetID sets the "id" property of the document

func (Document) SetProperty added in v0.1.19 

func (document Document) SetProperty(property string, value any)

SetProperty sets an individual property within this document.

func (*Document) SetString added in v0.1.19 

func (document *Document) SetString(name string, value ...string) bool

SetString sets a string property on the document

func (Document) SetTo added in v0.1.19 

func (document Document) SetTo(value ...string) bool

SetTo sets the "to" property of the document

func (*Document) SetValue added in v0.1.19 

func (document *Document) SetValue(value property.Value)

SetValue sets the value of this document to a new value.

func (Document) SharedInbox added in v0.15.0 

func (document Document) SharedInbox() string

https://www.w3.org/TR/activitypub/#sharedInbox

func (Document) Shares added in v0.14.2 

func (document Document) Shares() Document

https://www.w3.org/TR/activitypub/#shares

func (Document) Slice added in v0.1.19 

func (document Document) Slice() sliceof.Any

Array returns the array value of the current object

func (Document) SliceOfDocuments added in v0.1.19 

func (document Document) SliceOfDocuments() sliceof.Object[Document]

SliceOfDocuments transforms the current object into a slice of separate Document objects, one for each value in the current document array.

func (Document) SliceOfString added in v0.15.0 

func (document Document) SliceOfString() sliceof.String

SliceOfString transforms the current object into a slice of strings by extracting the ID from each sub-document in the current document array.

func (Document) StartIndex 

func (document Document) StartIndex() int

https://www.w3.org/TR/activitystreams-vocabulary/#dfn-startindex

func (Document) StartTime 

func (document Document) StartTime() time.Time

https://www.w3.org/TR/activitystreams-vocabulary/#dfn-starttime

func (Document) Streams added in v0.1.19 

func (document Document) Streams() Document

https://www.w3.org/TR/activitypub/#streams-property

func (Document) String added in v0.1.19 

func (document Document) String() string

String returns the current object as a pure string (no HTML). This value is filtered by blueMonday, so it is safe to use in HTML.

func (Document) Subject 

func (document Document) Subject() Document

https://www.w3.org/TR/activitystreams-vocabulary/#dfn-subject

func (Document) Summary 

func (document Document) Summary() string

https://www.w3.org/TR/activitystreams-vocabulary/#dfn-summary TODO: Implement Language Maps 

func (document Document) SummaryWithTagLinks() string

SummaryWithTagLinks

func (Document) Tag 

func (document Document) Tag() Document

https://www.w3.org/TR/activitystreams-vocabulary/#dfn-tag

func (Document) Tail 

func (document Document) Tail() Document

Tail returns all records after the first in a slice. For all other document types, it returns a nil document.

func (Document) Target 

func (document Document) Target() Document

https://www.w3.org/TR/activitystreams-vocabulary/#dfn-target

func (Document) Time added in v0.1.19 

func (document Document) Time() time.Time

Time returns the current object as a time value

func (Document) To 

func (document Document) To() Document

https://www.w3.org/TR/activitystreams-vocabulary/#dfn-to

func (Document) TotalItems 

func (document Document) TotalItems() int

https://www.w3.org/TR/activitystreams-vocabulary/#dfn-totalitems

func (Document) Type 

func (document Document) Type() string

https://www.w3.org/TR/activitystreams-vocabulary/#dfn-type

func (Document) Types added in v0.1.19 

func (document Document) Types() []string

A special case of the Type() function, which returns a slice of types https://www.w3.org/TR/activitystreams-vocabulary/#dfn-type

func (Document) URL 

func (document Document) URL() string

https://www.w3.org/TR/activitystreams-vocabulary/#dfn-url

func (Document) URLOrID added in v0.1.19 

func (document Document) URLOrID() string

URLOrID returns the URL of the document, if it exists, otherwise it returns the ID.

func (Document) Units 

func (document Document) Units() string

https://www.w3.org/TR/activitystreams-vocabulary/#dfn-units

func (*Document) UnmarshalJSON 

func (document *Document) UnmarshalJSON(bytes []byte) error

UnmarshalJSON implements the json.Unmarshaller interface, and provides a custom un-marshalling from JSON -- essentially just aiming the unmashaller at the Document's value

func (Document) UnwrapActivity added in v0.1.19 

func (document Document) UnwrapActivity() Document

If this document is an activity (create, update, delete, etc), then this method returns the activity's Object. Otherwise, it returns the document itself.

func (Document) Updated 

func (document Document) Updated() time.Time

https://www.w3.org/TR/activitystreams-vocabulary/#dfn-updated

func (Document) Username added in v0.1.19 

func (document Document) Username() string

Alias for https://www.w3.org/TR/activitypub/#preferredUsername

func (Document) UsernameOrID added in v0.1.19 

func (document Document) UsernameOrID() string

UsernameOrID returns the username of the document, if it exists, or the ID of the document if it does not.

func (Document) Value 

func (document Document) Value() any

Value returns the generic data stored in this Document

func (Document) Width 

func (document Document) Width() int

https://www.w3.org/TR/activitystreams-vocabulary/#dfn-width

func (*Document) WithOptions added in v0.1.19 

func (document *Document) WithOptions(options ...DocumentOption)

type DocumentOption added in v0.1.19 

type DocumentOption func(*Document)

func WithClient added in v0.1.19 

func WithClient(client Client) DocumentOption

WithClient option sets the HTTP client that can load remote documents if necessary

func WithHTTPHeader added in v0.1.19 

func WithHTTPHeader(httpHeader http.Header) DocumentOption

WithHTTPHeader attaches an HTTP header to the document

func WithMetadata added in v0.14.0 

func WithMetadata(metadata Metadata) DocumentOption

WithMetadata attaches metadata to the document

type Image added in v0.1.19 

type Image struct {
	// contains filtered or unexported fields
}

https://www.w3.org/ns/activitystreams#Image

func NewImage added in v0.1.19 

func NewImage(value any) Image

NewImage creates a new Image object from a JSON-LD value (string, map[string]any, or []any)

func (Image) AspectRatio added in v0.1.19 

func (image Image) AspectRatio() float64

AspectRatio calculates the aspect ratio of the image (width / height) If height and width are not available, then 0 is returned

func (Image) HasDimensions added in v0.1.19 

func (image Image) HasDimensions() bool

HasDimensions returns TRUE if this image has both a height and width defined

func (Image) HasHeight added in v0.1.19 

func (image Image) HasHeight() bool

HasHeight returns TRUE if this image has a height defined

func (Image) HasWidth added in v0.1.19 

func (image Image) HasWidth() bool

HasWidth returns TRUE if this image has a width defined

func (Image) Height added in v0.1.19 

func (image Image) Height() int

https://www.w3.org/TR/activitystreams-vocabulary/#dfn-height

func (Image) Href added in v0.1.19 

func (image Image) Href() string

https://www.w3.org/TR/activitystreams-vocabulary/#dfn-href Note: This method searches both the "href" and "url" properties in maps.

func (Image) IsNil added in v0.1.19 

func (image Image) IsNil() bool

IsNil returns TRUE if this image is nil (having no URL)

func (Image) MediaType added in v0.1.19 

func (image Image) MediaType() string

https://www.w3.org/TR/activitystreams-vocabulary/#dfn-mediatype

func (Image) NotNil added in v0.1.19 

func (image Image) NotNil() bool

NotNil returns TRUE if this image has a URL

func (Image) Summary added in v0.1.19 

func (image Image) Summary() string

https://www.w3.org/TR/activitystreams-vocabulary/#dfn-summary

func (Image) URL added in v0.1.19 

func (image Image) URL() string

https://www.w3.org/TR/activitystreams-vocabulary/#dfn-href Note: URL is an alias for Href, which is the proper name to use

func (Image) Width added in v0.1.19 

func (image Image) Width() int

https://www.w3.org/TR/activitystreams-vocabulary/#dfn-width

type Metadata added in v0.14.0 

type Metadata struct {
	HashedID         string `bson:"hashedId,omitempty"`         // HashedID is a unique identifier for this document, used to prevent duplicate records
	DocumentCategory string `bson:"documentCategory,omitempty"` // High-level category of the document [Activity, Actor, Object, Collection]
	RelationType     string `bson:"relationType,omitempty"`     // If this document is related to another document, this contains the type of relation [Reply, Announce, Like, Dislike]
	RelationHref     string `bson:"relationHref,omitempty"`     // If this document is related to another document, this contains the URL of the related document
	Replies          int64  `bson:"replies,omitempty"`          // Replies is the number of replies to this document
	Announces        int64  `bson:"announces,omitempty"`        // Announces is the number of times this document has been announced / reposted
	Likes            int64  `bson:"likes,omitempty"`            // Likes is the number of times this document has been liked
	Dislikes         int64  `bson:"dislikes,omitempty"`         // Dislikes is the number of times this document has been disliked
}

Metadata contains structured metadata for each document, which is useful for collecting/querying records in a database

func NewMetadata added in v0.14.0 

func NewMetadata() Metadata

NewMetadata returns a fully initialized Metadata object

func (Metadata) HasAnnounces added in v0.14.0 

func (metadata Metadata) HasAnnounces() bool

HasAnnounces returns TRUE if this document has one or more Announces

func (Metadata) HasDislikes added in v0.14.0 

func (metadata Metadata) HasDislikes() bool

HasDislikes returns TRUE if this document has one or more Dislikes

func (Metadata) HasLikes added in v0.14.0 

func (metadata Metadata) HasLikes() bool

HasLikes returns TRUE if this document has one or more Likes

func (Metadata) HasRelationship added in v0.14.0 

func (metadata Metadata) HasRelationship() bool

HasRelationship returns TRUE if this document has a relationship

func (Metadata) HasReplies added in v0.14.0 

func (metadata Metadata) HasReplies() bool

HasReplies returns TRUE if this document has one or more Replies

func (Metadata) IsActor added in v0.14.0 

func (metadata Metadata) IsActor() bool

IsActor returns TRUE if this document is one of several "Actor" types [Application, Group, Organization, Person, Service]

func (Metadata) IsCollection added in v0.14.0 

func (metadata Metadata) IsCollection() bool

IsCollection returns TRUE if this document is one of several "Collection" types [Collection, CollectionPage, OrderedCollection, OrderedCollectionPage]

func (Metadata) IsObject added in v0.14.0 

func (metadata Metadata) IsObject() bool

IsObject returns TRUE if this document is one of several "Object" types [Image, Video, Audio, Document, and others]

func (*Metadata) SetRelationCount added in v0.14.0 

func (metadata *Metadata) SetRelationCount(relationType string, count int64) bool

SetRelationCount updates the designated relation with a new count, returning TRUE if the value has been changed.

type OrderedCollection 

type OrderedCollection struct {
	Context      Context `json:"@context,omitempty"     bson:"@context,omitempty"`
	ID           string  `json:"id,omitempty"           bson:"id,omitempty"`
	Type         string  `json:"type,omitempty"         bson:"type,omitempty"`
	Summary      string  `json:"summary,omitempty"      bson:"summary,omitempty"`      // A natural language summarization of the object encoded as HTML. Multiple language tagged summaries may be provided.
	TotalItems   int     `json:"totalItems,omitempty"   bson:"totalItems,omitempty"`   // A non-negative integer specifying the total number of objects contained by the logical view of the collection. This number might not reflect the actual number of items serialized within the Collection object instance.
	OrderedItems []any   `json:"orderedItems,omitempty" bson:"orderedItems,omitempty"` // Identifies the items contained in a collection. The items might be ordered or unordered.
	Current      string  `json:"current,omitempty"      bson:"current,omitempty"`      // In a paged Collection, indicates the page that contains the most recently updated member items.
	First        string  `json:"first,omitempty"        bson:"first,omitempty"`        // In a paged Collection, indicates the furthest preceding page of items in the collection.
	Last         string  `json:"last,omitempty"         bson:"last,omitempty"`         // In a paged Collection, indicates the furthest proceeding page of the collection.
}

OrderedCollection is a subtype of Collection in which members of the logical collection are assumed to always be strictly ordered. https://www.w3.org/ns/activitystreams#OrderedCollection

func NewOrderedCollection added in v0.1.19 

func NewOrderedCollection(collectionID string) OrderedCollection

func (*OrderedCollection) UnmarshalJSON 

func (c *OrderedCollection) UnmarshalJSON(data []byte) error

func (*OrderedCollection) UnmarshalMap 

func (c *OrderedCollection) UnmarshalMap(data mapof.Any) error

type OrderedCollectionPage 

type OrderedCollectionPage struct {
	Context      Context `json:"@context,omitempty"     bson:"context,omitempty"`
	Type         string  `json:"type,omitempty"         bson:"type,omitempty"`
	ID           string  `json:"id,omitempty"           bson:"id,omitempty"`           // Provides the globally unique identifier for an Object or Link.
	Summary      string  `json:"summary,omitempty"      bson:"summary,omitempty"`      // A natural language summarization of the object encoded as HTML. Multiple language tagged summaries may be provided.
	TotalItems   int     `json:"totalItems,omitempty"   bson:"totalItems,omitempty"`   // A non-negative integer specifying the total number of objects contained by the logical view of the collection. This number might not reflect the actual number of items serialized within the Collection object instance.
	Current      string  `json:"current,omitempty"      bson:"current,omitempty"`      // In a paged Collection, indicates the page that contains the most recently updated member items.
	First        string  `json:"first,omitempty"        bson:"first,omitempty"`        // In a paged Collection, indicates the furthest preceding page of items in the collection.
	Last         string  `json:"last,omitempty"         bson:"last,omitempty"`         // In a paged Collection, indicates the furthest proceeding page of the collection.
	StartIndex   int     `json:"startIndex,omitempty"   bson:"startIndex,omitempty"`   // A non-negative integer value identifying the relative position within the logical view of a strictly ordered collection.
	PartOf       string  `json:"partOf,omitempty"       bson:"partOf,omitempty"`       // dentifies the Collection to which a CollectionPage objects items belong.
	Prev         string  `json:"prev,omitempty"         bson:"prev,omitempty"`         // In a paged Collection, identifies the previous page of items.
	Next         string  `json:"next,omitempty"         bson:"next,omitempty"`         // In a paged Collection, indicates the next page of items.
	OrderedItems []any   `json:"orderedItems,omitempty" bson:"orderedItems,omitempty"` // Identifies the items contained in a collection. The items might be ordered or unordered.
}

OrderedCollectionPage is used to represent ordered subsets of items from an OrderedCollection. Refer to the Activity Streams 2.0 Core for a complete description of the OrderedCollectionPage object. https://www.w3.org/ns/activitystreams#OrderedCollectionPage

func NewOrderedCollectionPage added in v0.1.19 

func NewOrderedCollectionPage(pageID string, partOf string) OrderedCollectionPage

func (*OrderedCollectionPage) UnmarshalJSON 

func (c *OrderedCollectionPage) UnmarshalJSON(data []byte) error

func (*OrderedCollectionPage) UnmarshalMap 

func (c *OrderedCollectionPage) UnmarshalMap(data mapof.Any) error

type Uniquer added in v0.13.0 

type Uniquer[T comparable] struct {
	// contains filtered or unexported fields
}

Uniquer is a utility class that helps to identify unique values

func NewUniquer added in v0.13.0 

func NewUniquer[T comparable]() *Uniquer[T]

NewUniquer returns a fully initialized Uniquer object

func (*Uniquer[T]) IsDuplicate added in v0.13.0 

func (u *Uniquer[T]) IsDuplicate(id T) bool

IsDuplicate returns TRUE if the value has been seen before.

func (*Uniquer[T]) IsUnique added in v0.13.0 

func (u *Uniquer[T]) IsUnique(id T) bool

IsUnique returns TRUE if the value has not been seen before. Subsequent calls to IsUnique() with the same value will return FALSE.

func (*Uniquer[T]) Range added in v0.13.0 

func (u *Uniquer[T]) Range(iterator iter.Seq[T]) iter.Seq[T]

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.