Go to file
Cory Slep 574f22607b Add forgefed vocabulary to go generate command 2020-07-05 21:58:08 +02:00
.github Add pull request template 2018-06-12 00:37:36 +02:00
astool Merge pull request #136 from BenLubar-PR/forgefed 2020-07-05 21:56:36 +02:00
pub Update database.go 2020-07-05 20:07:47 +01:00
streams Regenerate vocabular with source property 2020-07-05 21:47:30 +02:00
CHANGELOG Update CHANGELOG 2019-02-24 16:51:35 +01:00
CODE_OF_CONDUCT.md Add CODE_OF_CONDUCT.md. 2018-12-24 07:51:51 +01: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 Add apcore as a client: toot own horn 2019-10-23 22:29:48 +02:00
gen.go Add forgefed vocabulary to go generate command 2020-07-05 21:58:08 +02:00
go.mod Add https://w3id.org/security/v1 extension 2019-09-16 22:47:07 +02:00
go.sum Run go mod tidy 2020-07-05 20:59:37 +02:00

README.md

activity

go get github.com/go-fed/activity

This repository contains two libraries and a tool:

  • astool: A linked-data aware tool to generate golang native types for any ActivityStreams vocabulary.
  • streams: The ActivityStreams native types generated with the astool.
  • pub: ActivityPub Social Protocol (Client-to-Server or C2S) and Federating Protocol (Server-to-Server or S2S)

Status

Preview (unstable) 1.0.0 (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 astool, streams, or pub for their own README.

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.

v1.0.0 still has a lot of unit tests to be written. Bug fixes and small backwards-incompatible behavior is expected before it is blessed as being released.

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
WriteFreely Simple, open-source, privacy-focused blogging platform https://github.com/writeas/writefreely @write_as@writing.exchange or hello@write.as https://writefreely.org
Read.as Long-form reader built on open protocols https://github.com/writeas/Read.as @write_as@writing.exchange or hello@write.as https://read.as
go-fed/apcore Generic ActivityPub server framework in Go https://github.com/go-fed/apcore @cj@mastodon.technology or cjslep@gmail.com https://go-fed.org

How do I use these libraries?

Please see each subdirectory for its own README for further elaboration.

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.

Thanks to those who have been early adopters with v0 and/or provided early feedback.