2018-01-24 08:00:59 +09:00
|
|
|
# activity
|
|
|
|
|
|
|
|
`go get github.com/go-fed/activity`
|
|
|
|
|
2018-05-31 06:48:34 +09:00
|
|
|
This repository supports `vgo` and is remotely verifiable.
|
|
|
|
|
2018-01-24 08:00:59 +09:00
|
|
|
This repository contains three libraries for use in your golang applications:
|
|
|
|
|
2018-05-31 06:48:34 +09:00
|
|
|
* `vocab`: An ActivityStreams Vocabulary library
|
|
|
|
* `streams`: A convenience library for the ActivityStreams Vocabulary
|
|
|
|
* `pub`: ActivityPub SocialAPI (Client-to-Server) and FederateAPI
|
|
|
|
(Server-to-Server)
|
2018-01-24 08:00:59 +09:00
|
|
|
|
2018-04-05 03:32:55 +09:00
|
|
|
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.
|
|
|
|
|
2018-01-24 08:00:59 +09:00
|
|
|
## Status
|
|
|
|
|
2018-06-14 06:23:46 +09:00
|
|
|
**0.1.1** ([Semantic Versioning](https://semver.org/))
|
2018-04-05 03:32:55 +09:00
|
|
|
|
2018-06-14 06:23:46 +09:00
|
|
|
There is no official implementation report available... yet!
|
|
|
|
|
|
|
|
[Unofficial implementation reports are available in issue #46](https://github.com/go-fed/activity/issues/46).
|
|
|
|
|
|
|
|
Please see CHANGELOG for changes between versions.
|
|
|
|
|
|
|
|
## Getting Started
|
2018-04-05 03:32:55 +09:00
|
|
|
|
2018-05-31 06:48:34 +09:00
|
|
|
See each subdirectory for its own README for further elaboration. The
|
|
|
|
recommended reading order is `vocab`, `streams`, and then `pub`. Others are
|
|
|
|
optional.
|
2018-04-05 03:32:55 +09:00
|
|
|
|
2018-06-14 06:23:46 +09:00
|
|
|
## How can I get help, file issues, or contribute?
|
|
|
|
|
|
|
|
Please see the CONTRIBUTING.md file!
|
|
|
|
|
2018-05-31 06:48:34 +09:00
|
|
|
## How well tested are these libraries?
|
2018-04-05 03:32:55 +09:00
|
|
|
|
2018-05-31 06:48:34 +09:00
|
|
|
I took great care to add numerous tests using examples directly from
|
|
|
|
specifications, official test repositories, and my own end-to-end tests.
|
2018-04-05 03:32:55 +09:00
|
|
|
|
2018-05-31 06:48:34 +09:00
|
|
|
## Who is using this library currently?
|
|
|
|
|
|
|
|
No one. Please let me know if you are using it!
|
|
|
|
|
|
|
|
## How do I use these libraries?
|
2018-04-05 03:32:55 +09:00
|
|
|
|
2018-05-31 06:48:34 +09:00
|
|
|
Please see each subdirectory for its own README for further elaboration. The
|
|
|
|
recommended reading order is `vocab`, `streams`, and then `pub`. Others are
|
|
|
|
optional.
|
2018-04-05 03:32:55 +09:00
|
|
|
|
2018-05-31 06:48:34 +09:00
|
|
|
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
|
2018-04-05 03:32:55 +09:00
|
|
|
|
|
|
|
## FAQ
|
|
|
|
|
2018-06-14 06:23:46 +09:00
|
|
|
Please see the CONTRIBUTING.md file!
|
2018-01-24 08:00:59 +09:00
|
|
|
|
|
|
|
## Useful References
|
|
|
|
|
|
|
|
* [ActivityPub Specification](https://www.w3.org/TR/activitypub)
|
|
|
|
* [ActivityPub GitHub Repo](https://github.com/w3c/activitypub)
|
|
|
|
* [ActivityStreams Core Specification](https://www.w3.org/TR/activitystreams-core)
|
|
|
|
* [ActivityStreams Vocabulary Specification](https://www.w3.org/TR/activitystreams-vocabulary)
|
|
|
|
* [ActivityStreams GitHub Repo](https://github.com/w3c/activitystreams)
|
|
|
|
|
|
|
|
## 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.
|