gitea-mirror
/
go-fed-activity
mirror of https://gitea.com/gitea/go-fed-activity.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
135 Commits 1 Branch 7 Tags 12 MiB
Go 100%
Go to file
Cory Slep 387ed4a775 Fix body delivery bytes being incorrectly copied 2018-08-19 23:25:14 +02:00
.github Add pull request template 2018-06-12 00:37:36 +02:00
deliverer Initial deliverer tests 2018-06-13 22:52:19 +02:00
pub Fix body delivery bytes being incorrectly copied 2018-08-19 23:25:14 +02:00
streams Include more links to go-fed.org and official reports 2018-08-19 18:39:54 +02:00
tools Add IsPublic to streams types 2018-08-04 15:30:31 +02:00
vocab Include more links to go-fed.org and official reports 2018-08-19 18:39:54 +02:00
CHANGELOG Fix body delivery bytes being incorrectly copied 2018-08-19 23:25:14 +02:00
CONTRIBUTING.md Update changelog and contributing 2018-07-28 13:26:55 +02:00
LICENSE Initial commit 2018-01-23 22:53:17 +01:00
README.md Update README and CHANGELOG for v0.2.1 release 2018-08-19 19:00:48 +02:00
go.mod Add go.mod and go.modverify for vgo 2018-05-30 21:44:17 +02:00
go.modverify Add go.mod and go.modverify for vgo 2018-05-30 21:44:17 +02:00

README.md

activity

go get github.com/go-fed/activity

This repository supports vgo and is remotely verifiable.

This repository contains three libraries for use in your golang applications:

  • vocab: An ActivityStreams Vocabulary library
  • streams: A convenience library for the ActivityStreams Vocabulary
  • pub: ActivityPub SocialAPI (Client-to-Server) and FederateAPI (Server-to-Server)

This library is biased. It forgoes understanding JSON-LD in exchange for static typing. It provides a large amount of default behavior to let Social, Federated, or both kinds of ActivityPub applications just work.

The go-fed.org website has a tutorial. It also hosts godoc documentation for every version of this library.

Status

0.2.1 (Semantic Versioning)

An official implementation report was last submitted for version 0.2.0 here.

Previous unofficial implementation reports are available in issue #46.

Please see CHANGELOG for changes between versions.

Getting Started

See each subdirectory for its own README for further elaboration. The recommended reading order is vocab, streams, and then pub. Others are optional.

How can I get help, file issues, or contribute?

Please see the CONTRIBUTING.md file!

How well tested are these libraries?

I took great care to add numerous tests using examples directly from specifications, official test repositories, and my own end-to-end tests.

Who is using this library currently?

Application Description Repository Point Of Contact Homepage
Anancus Self-hosted and federated social link aggregation https://gitlab.com/tuxether/anancus @tuxether@floss.social or tuxether@protonmail.ch N/A
Write.as Simple, privacy-focused blogging platform https://github.com/writeas/Write.as @write_as@writing.exchange or hello@write.as https://write.as

How do I use these libraries?

There is a tutorial available at https://go-fed.org.

Please see each subdirectory for its own README for further elaboration. The recommended reading order is vocab, streams, and then pub. Others are optional.

Passing familiarity with ActivityStreams and ActivityPub is recommended.

Other Libraries

  • tools - Code generation wizardry and ActivityPub-spec-as-data.
  • deliverer - Provides an asynchronous Deliverer for use with the pub lib

FAQ

Please see the CONTRIBUTING.md file!

Useful References

Thanks

I would like to thank those that have worked hard to create the technologies and standards that created the opportunity to implement this suite of libraries.